py-auth-micro


Namepy-auth-micro JSON
Version 0.2.2 PyPI version JSON
download
home_pagehttps://github.com/bad-microservices/py_auth_micro
SummaryA wrapper around pyjwt
upload_time2024-08-28 13:36:46
maintainerNone
docs_urlNone
authorOle Hannemann
requires_pythonNone
licenseMIT
keywords jwt
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ================
py_auth_micro
================

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://pypi.org/project/black

.. image:: https://app.codacy.com/project/badge/Grade/199fd463ff1a487eb206a2afbfb25168
    :target: https://app.codacy.com/gh/bad-microservices/py_auth_micro/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade

.. image:: https://badge.fury.io/py/py-auth-micro.svg
    :target: https://badge.fury.io/py/py-auth-micro

.. image:: https://github.com/bad-microservices/py_auth_micro/actions/workflows/documentation.yaml/badge.svg
   :target: https://github.com/bad-microservices/py_auth_micro/actions?query=workflow:Docs

.. image:: https://github.com/bad-microservices/py_auth_micro/actions/workflows/pypi_upload.yaml/badge.svg
    :target: https://github.com/bad-microservices/py_auth_micro/actions?query=workflow:pypi

Introduction
=============

`py_auth_micro` is a small identity provider library which can use an LDAP/AD as upstream Identity Provider and can also store Users Localy.

The Authentication and Authorization is done via `ID-Tokens` and `Access-Tokens`. The `ID-Tokens` are given out after a User successfully logged in.
With this `ID-Token` a User can request an `Access-Token` which he can send to other (Micro-)Services to gain access According to his Permissions.

The Tokens are `JWT` Tokens which can either be signed with an symetric `HMAC`-Secret or with an `RSA`-Key.

Documentation
==============

You can find the documentation `here <https://bad-microservices.github.io/py_auth_micro/>`_

Alternatively you can build it yourself by running :code:`make doc`

TODO
=====

There is still alot todo for the :code:`1.0.0` Release. The following list contains the most important stuff

- ☐ Reset-Password functionality
- ☐ Unit Tests
   - ☐ WorkFlows
      - ☑ :code:`GroupWorkflow`
      - ☐ :code:`SessionWorkflow`
      - ☐ :code:`UserWorkflow` 
   - ☐ Models
      - ☐ :code:`Group`
      - ☐ :code:`Token` 
      - ☐ :code:`User`
   - ☐ LoginHandler
      - ☐ :code:`LoginLDAP`
      - ☐ :code:`LoginLocal`
   - ☐ Core
      - ☐ :code:`LDAPHelper`
      - ☐ :code:`_ConnectionHandler`
- ☐ Documentation 
   - ☑ Api Reference
   - ☑ Installation
   - ☐ Example Code 


Contributing
=============

Missing a Feature or found a bug? Create an Issue or make a Pull-Request ;)

If you have any Question regarding this library feel free to create an issue.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/bad-microservices/py_auth_micro",
    "name": "py-auth-micro",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "JWT",
    "author": "Ole Hannemann",
    "author_email": "cerberus885@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/f8/e0/b577cb72824c49ab323a3f6ff1b51b004bbeab0c4732b24fe311e960e877/py_auth_micro-0.2.2.tar.gz",
    "platform": null,
    "description": "================\npy_auth_micro\n================\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://pypi.org/project/black\n\n.. image:: https://app.codacy.com/project/badge/Grade/199fd463ff1a487eb206a2afbfb25168\n    :target: https://app.codacy.com/gh/bad-microservices/py_auth_micro/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade\n\n.. image:: https://badge.fury.io/py/py-auth-micro.svg\n    :target: https://badge.fury.io/py/py-auth-micro\n\n.. image:: https://github.com/bad-microservices/py_auth_micro/actions/workflows/documentation.yaml/badge.svg\n   :target: https://github.com/bad-microservices/py_auth_micro/actions?query=workflow:Docs\n\n.. image:: https://github.com/bad-microservices/py_auth_micro/actions/workflows/pypi_upload.yaml/badge.svg\n    :target: https://github.com/bad-microservices/py_auth_micro/actions?query=workflow:pypi\n\nIntroduction\n=============\n\n`py_auth_micro` is a small identity provider library which can use an LDAP/AD as upstream Identity Provider and can also store Users Localy.\n\nThe Authentication and Authorization is done via `ID-Tokens` and `Access-Tokens`. The `ID-Tokens` are given out after a User successfully logged in.\nWith this `ID-Token` a User can request an `Access-Token` which he can send to other (Micro-)Services to gain access According to his Permissions.\n\nThe Tokens are `JWT` Tokens which can either be signed with an symetric `HMAC`-Secret or with an `RSA`-Key.\n\nDocumentation\n==============\n\nYou can find the documentation `here <https://bad-microservices.github.io/py_auth_micro/>`_\n\nAlternatively you can build it yourself by running :code:`make doc`\n\nTODO\n=====\n\nThere is still alot todo for the :code:`1.0.0` Release. The following list contains the most important stuff\n\n- \u2610 Reset-Password functionality\n- \u2610 Unit Tests\n   - \u2610 WorkFlows\n      - \u2611 :code:`GroupWorkflow`\n      - \u2610 :code:`SessionWorkflow`\n      - \u2610 :code:`UserWorkflow` \n   - \u2610 Models\n      - \u2610 :code:`Group`\n      - \u2610 :code:`Token` \n      - \u2610 :code:`User`\n   - \u2610 LoginHandler\n      - \u2610 :code:`LoginLDAP`\n      - \u2610 :code:`LoginLocal`\n   - \u2610 Core\n      - \u2610 :code:`LDAPHelper`\n      - \u2610 :code:`_ConnectionHandler`\n- \u2610 Documentation \n   - \u2611 Api Reference\n   - \u2611 Installation\n   - \u2610 Example Code \n\n\nContributing\n=============\n\nMissing a Feature or found a bug? Create an Issue or make a Pull-Request ;)\n\nIf you have any Question regarding this library feel free to create an issue.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A wrapper around pyjwt",
    "version": "0.2.2",
    "project_urls": {
        "Homepage": "https://github.com/bad-microservices/py_auth_micro"
    },
    "split_keywords": [
        "jwt"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d88744393a2718c481197b7d83cd33baf778821a27e93688f231daba46ff7380",
                "md5": "7e457a106178347a10d578981a053c13",
                "sha256": "3cb6bf5c0b6d89ce3ef3e1ba798a73663fea60926d120bbda8f1a4156853c0f8"
            },
            "downloads": -1,
            "filename": "py_auth_micro-0.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7e457a106178347a10d578981a053c13",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 25186,
            "upload_time": "2024-08-28T13:36:44",
            "upload_time_iso_8601": "2024-08-28T13:36:44.785292Z",
            "url": "https://files.pythonhosted.org/packages/d8/87/44393a2718c481197b7d83cd33baf778821a27e93688f231daba46ff7380/py_auth_micro-0.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f8e0b577cb72824c49ab323a3f6ff1b51b004bbeab0c4732b24fe311e960e877",
                "md5": "e31863973a9d5202f9e526c60a42d77e",
                "sha256": "a7e029f2be40a218af77b4afdd56ac9b302de15f6defce3412b51986ad80aa2a"
            },
            "downloads": -1,
            "filename": "py_auth_micro-0.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "e31863973a9d5202f9e526c60a42d77e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 18284,
            "upload_time": "2024-08-28T13:36:46",
            "upload_time_iso_8601": "2024-08-28T13:36:46.402898Z",
            "url": "https://files.pythonhosted.org/packages/f8/e0/b577cb72824c49ab323a3f6ff1b51b004bbeab0c4732b24fe311e960e877/py_auth_micro-0.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-28 13:36:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bad-microservices",
    "github_project": "py_auth_micro",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "py-auth-micro"
}
        
Elapsed time: 2.47172s