.. This file is part of Invenio. Copyright (C) 2015-2018 CERN.

Invenio is free software; you can redistribute it and/or modify it
under the terms of the MIT License; see LICENSE file for more details.

================== Invenio-Accounts

.. image:: https://img.shields.io/github/license/inveniosoftware/invenio-accounts.svg :target: https://github.com/inveniosoftware/invenio-accounts/blob/master/LICENSE

.. image:: https://github.com/inveniosoftware/invenio-accounts/workflows/CI/badge.svg :target: https://github.com/inveniosoftware/invenio-accounts/actions?query=workflow%3ACI

.. image:: https://img.shields.io/coveralls/inveniosoftware/invenio-accounts.svg :target: https://coveralls.io/r/inveniosoftware/invenio-accounts

.. image:: https://img.shields.io/pypi/v/invenio-accounts.svg :target: https://pypi.org/pypi/invenio-accounts

Invenio user management and authentication.

Features:

• User and role management.
• User registration, password reset/recovery and email verification.
• Administration interface and CLI for managing users.
• Session based authentication with session theft protection support.
• Strong cryptographic password hashing with support for migrating password hashes (including Invenio v1.x) to new stronger algorithms.
• Session activity tracking allowing users to e.g. logout of all devices.
• Server-side session management.
• JSON Web Token encoding and decoding support useful for e.g. CSRF-protection in REST APIs.

Invenio-Accounts relies on the following community packages to do all the heavy-lifting:

• Flask-Security <https://flask-security.readthedocs.io>_
• Flask-Login <https://flask-login.readthedocs.io/>_
• Flask-Principal <https://pythonhosted.org/Flask-Principal/>_
• Flask-KVSession <http://pythonhosted.org/Flask-KVSession/>_
• Passlib <https://passlib.readthedocs.io/>_

Further documentation is available on https://invenio-accounts.readthedocs.io/