django-oidc-provider/README.md

30 lines
1.9 KiB
Markdown
Raw Normal View History

2016-02-02 16:18:40 +00:00
# Django OIDC Provider
2016-02-09 14:24:41 +00:00
[![Python Versions](https://img.shields.io/pypi/pyversions/django-oidc-provider.svg)](https://pypi.python.org/pypi/django-oidc-provider)
[![PyPI Versions](https://img.shields.io/pypi/v/django-oidc-provider.svg)](https://pypi.python.org/pypi/django-oidc-provider)
2018-03-22 16:50:54 +00:00
[![Documentation Status](https://readthedocs.org/projects/django-oidc-provider/badge/?version=master)](http://django-oidc-provider.readthedocs.io/)
2018-03-22 15:53:23 +00:00
[![Travis](https://travis-ci.org/juanifioren/django-oidc-provider.svg?branch=master)](https://travis-ci.org/juanifioren/django-oidc-provider)
2016-02-02 16:18:40 +00:00
## About OpenID
OpenID Connect is a simple identity layer on top of the OAuth 2.0 protocol, which allows computing clients to verify the identity of an end-user based on the authentication performed by an authorization server, as well as to obtain basic profile information about the end-user in an interoperable and REST-like manner. Like [Google](https://developers.google.com/identity/protocols/OpenIDConnect) for example.
## About the package
`django-oidc-provider` can help you providing out of the box all the endpoints, data and logic needed to add OpenID Connect capabilities to your Django projects.
Support for Python 3 and 2. Also latest versions of django.
2016-09-12 18:29:11 +00:00
[Read docs for more info](http://django-oidc-provider.readthedocs.org/).
2016-02-02 16:18:40 +00:00
## Contributing
2016-12-02 15:27:08 +00:00
[Join us!](https://github.com/juanifioren/django-oidc-provider/graphs/contributors) we love contributions, so please feel free to fix bugs, improve things, provide documentation. You SHOULD follow this steps:
2016-02-02 16:18:40 +00:00
2018-03-28 17:28:54 +00:00
* Fork the project and create new branch from `develop`.
2016-02-02 16:18:40 +00:00
* Make your feature addition or bug fix.
2016-06-15 17:44:59 +00:00
* Add tests for it inside `oidc_provider/tests`. Then run all and ensure everything is OK (read docs for how to test in all envs).
2018-03-28 17:28:54 +00:00
* Create an issue and explain your changes.
* Create pull request for the issue to the `develop` branch.
* Wait for the collaborators to review it.