معرفی شرکت ها
fastapi-auth2-1.0.6
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
FastAPI Auth is a package that provides authentication based API security with FastAPI and Postgres Database or Sqlite3 Database
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | fastapi-auth2-1.0.6 |
| نام | fastapi-auth2 |
| نسخه کتابخانه | 1.0.6 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Ifeanyi Nneji |
| ایمیل نویسنده | ifeanyinneji@gmail.com |
| آدرس صفحه اصلی | https://nneji123.github.io/fastapi_auth/ |
| آدرس اینترنتی | https://pypi.org/project/fastapi-auth2/ |
| مجوز | MIT |
# fastapi_auth2
[](https://pypi.org/project/fastapi_auth2/)
[](https://pypi.org/project/fastapi_auth2/)
[](https://codecov.io/github/mrtolkien/fastapi_simple_security)
[](https://github.com/mrtolkien/fastapi_simple_security/actions/workflows/pr_python_tests.yml)
[](https://github.com/mrtolkien/fastapi_simple_security/actions/workflows/push_sanity_check.yml)
[](https://github.com/psf/black)
[](https://github.com/Nneji123/fastapi_auth/actions/workflows/publish-docs.yml)
[](https://github.com/Nneji123/fastapi_auth/actions/workflows/publish-pypi.yml)
[](https://pepy.tech/project/fastapi-auth2)
[](https://pepy.tech/project/fastapi-auth2)
API key based Authentication package for FastAPI, focused on simplicity and ease of use:
- Full functionality out of the box, no configuration required
- API key security with local `sqlite` or `postgres` database backend, working with both header and query parameters
- Default 15 days deprecation for generated API keys
- Key creation, revocation, renewing, and usage logs handled through administrator endpoints
- Username, Email address and password(hashing + salting) verification features.
- Lightweight, minimal dependencies required.
## Updates
1. Added **partial** support for mongodb database backend.
2. Added support for environment variables through .env files.
3. Added `example.env` file to show how to use environment variables.
4. Updated `README.md` to reflect changes.
5. Updated documentation to reflect changes.
6. Working on adding support for `mysql` database backend.
## Installation
`pip install fastapi_auth2`
## Usage
### Creating an application
```python
from fastapi import Depends, FastAPI
from fastapi_auth import api_key_router, api_key_security
app = FastAPI(
description="FastAPI Auth is a package that provides authentication based API security with FastAPI and Postgres Database, SQLite Database or MongoDB Database",
title="FastAPI Auth Example",
version=1.0,
)
app.include_router(api_key_router, prefix="/auth", tags=["_auth"])
@app.get("/unsecure")
async def unsecure_endpoint():
return {"message": "This is a unsecure endpoint"}
@app.get("/secure", dependencies=[Depends(api_key_security)])
async def secure_endpoint():
return {"message": "This is a secure endpoint"}
```
Resulting app is:
### API key creation through docs
Start your API and check the logs for the automatically generated secret key if you did not provide one through
environment variables.
Go to `/docs` on your API and inform this secret key in the `Authorize/Secret header` box.
All the administrator endpoints only support header security to make sure the secret key is not inadvertently
shared when sharing an URL.
Then, you can use `/auth/new` to generate a new API key.
And finally, you can use this API key to access the secure endpoint.
### API key creation in python
You can of course automate API key acquisition through python with `requests` and directly querying the endpoints.
If you do so, you can hide the endpoints from your API documentation with the environment variable
`FASTAPI_AUTH_HIDE_DOCS`.
## Configuration
Environment variables:
- `FASTAPI_AUTH_SECRET`: Secret administrator key
- Generated automatically on server startup if not provided
- Allows generation of new API keys, revoking of existing ones, and API key usage view
- It being compromised compromises the security of the API
- `FASTAPI_AUTH_HIDE_DOCS`: Whether or not to hide the API key related endpoints from the documentation
- `FASTAPI_AUTH_DB_LOCATION`: Location of the local sqlite database file
- `sqlite.db` in the running directory by default
- When running the app inside Docker, use a bind mount for persistence
- `FASTAPI_AUTH_AUTOMATIC_EXPIRATION`: Duration, in days, until an API key is deemed expired
- 15 days by default
- `DATABASE_MODE`: If set to `postgres`, the package will use a postgres database instead of sqlite
- `URI`: Location of the postgres database
- `postgresql://postgres:postgres@localhost:5432/postgres` by default
- Only used if `DEV_MODE` is set to `False`
## Contributing
See `CONTIBUTING.md` for more information.
### Setting up python environment
```bash
poetry install
poetry shell
```
### Setting up pre-commit hooks
```bash
pre-commit install
```
### Running tests
```bash
pytest
```
### Running the dev environment
The attached docker image runs a test app on `localhost:8080` with secret key `TEST_SECRET`. Run it with:
```bash
docker-compose build && docker-compose up
```
## TODO
- Add more tests
- Add more database backends
- Add more authentication methods
نیازمندی
| مقدار | نام |
|---|---|
| >=1.5.1 | passwordgenerator |
| >=0.70 | fastapi |
| >=1.26.12 | urllib3 |
| >=2.9.5 | psycopg2 |
| >=4.0.1 | bcrypt |
| >=1.3.0 | email-validator |
| >=1.0.2 | pymysql |
| >=0.18.3 | uvicorn |
| >=4.0.0 | pymongo |
| >=0.20.0 | python-dotenv |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7 | Python |
نحوه نصب
نصب پکیج whl fastapi-auth2-1.0.6:
pip install fastapi-auth2-1.0.6.whl
نصب پکیج tar.gz fastapi-auth2-1.0.6:
pip install fastapi-auth2-1.0.6.tar.gz