Skip to content

Commit e3a99fc

Browse files
authored
Merge pull request #16 from SenhasD/patch-1
Update README.md
2 parents 8d0445c + f307bd4 commit e3a99fc

File tree

1 file changed

+43
-1
lines changed

1 file changed

+43
-1
lines changed

README.md

+43-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,46 @@
11
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/1to5pc/python-auth/backend-test.yml?style=for-the-badge&label=Back%20End)
22
![GitHub top language](https://img.shields.io/github/languages/top/1to5pc/python-auth?style=for-the-badge&logo=python)
33

4-
# A "simple" and easy to use python based authentication system
4+
# User Authentication System
5+
This Python script provides a simple user authentication system with functionalities to initialize user accounts, test authentication, and manage user data securely.
6+
7+
# Features
8+
- User Initialization: Initialize user accounts with usernames, passwords, and salt for enhanced security.
9+
- Authentication Testing: Test user authentication by providing a username and password.
10+
- Quiet Mode: Enable quiet mode to suppress unnecessary output during authentication testing.
11+
- Configuration Options: Configure parameters such as quiet mode, hashing algorithm, and salt size through a configuration file.
12+
# Setup
13+
1) __Clone the Repository:__ Clone this repository to your local machine.
14+
15+
```
16+
git clone https://github.com/1to5pc/python-auth.git
17+
```
18+
19+
2) __Install Dependencies:__ Ensure you have Python installed on your machine.
20+
21+
3) __Configuration:__ Customize the configuration parameters by editing the config.ini file.
22+
23+
# Usage
24+
1) __Initialize User Accounts:__
25+
26+
Run the script and select the option to initialize user accounts. Follow the prompts to create user accounts with usernames and passwords.
27+
28+
2) __Test Authentication:__
29+
30+
Test user authentication by providing a username and password. Choose whether to enable quiet mode to suppress output during testing.
31+
32+
3) __Exit:__
33+
34+
Exit the program when finished.
35+
36+
# Configuration Options
37+
- __Quiet Mode:__ Set to suppress unnecessary output during authentication testing.
38+
- __Hashing Algorithm:__ Configure the hashing algorithm for password hashing (default is SHA256).
39+
- __Salt Size:__ Set the size of the salt used for password hashing (default is 8).
40+
# Contributing
41+
Contributions are welcome! If you have any suggestions, improvements, or feature requests, feel free to open an issue or submit a pull request.
42+
43+
# License
44+
This project is licensed under the MIT License.
45+
46+
Feel free to customize and expand this documentation further based on your preferences and additional functionalities!

0 commit comments

Comments
 (0)