Metadata-Version: 2.1
Name: django-scim2
Version: 0.17.3
Summary: A partial implementation of the SCIM 2.0 provider specification for use with Django.
Home-page: https://github.com/15five/django-scim2
Author: Paul Logston
Author-email: paul@15five.com
Maintainer: Paul Logston
Maintainer-email: paul@15five.com
License: MIT
Download-URL: https://github.com/15five/django-scim2/archive/master.zip
Keywords: django scim 2.0
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE.txt

django-scim2
============

|tests| |coverage| |docs|

This is a provider-side implementation of the SCIM 2.0 [1]_
specification for use in Django.

Note that currently the only supported database is Postgres.


Installation
------------

Install with pip::

$ pip install django-scim2

Then add the ``django_scim`` app to ``INSTALLED_APPS`` in your Django's settings::

    INSTALLED_APPS = (
        ...
        'django_scim',
    )

Add the appropriate middleware to authorize or deny the SCIM calls::

    MIDDLEWARE_CLASSES = (
        ...
        'django_scim.middleware.SCIMAuthCheckMiddleware',
        ...
    )

Make sure to place this middleware after authentication middleware as this
middleware simply checks `request.user.is_anonymous()` to determine if the SCIM
request should be allowed or denied.

Add the necessary url patterns to your root urls.py file. Please note that the
namespace is mandatory and must be named `scim`::

    urlpatterns = [
        ...
        path('scim/v2/', include('django_scim.urls')),
    ]

Finally, add settings appropriate for you app to your settings.py file::

    SCIM_SERVICE_PROVIDER = {
        'NETLOC': 'localhost',
        'AUTHENTICATION_SCHEMES': [
            {
                'type': 'oauth2',
                'name': 'OAuth 2',
                'description': 'Oauth 2 implemented with bearer token',
            },
        ],
    }

Other SCIM settings can be provided but those listed above are required.

PyPI
----

https://pypi.python.org/pypi/django-scim2

Source
------

https://github.com/15five/django-scim2

Documentation
-------------

.. |docs| image:: https://readthedocs.org/projects/django-scim2/badge/
  :target: https://django-scim2.readthedocs.io/
  :alt: Documentation Status

https://django-scim2.readthedocs.io/

Tests
-----

.. |tests| image:: https://github.com/15five/django-scim2/workflows/CI%2FCD/badge.svg
    :target: https://github.com/15five/django-scim2/actions

https://github.com/15five/django-scim2/actions

Tests are typically run locally with `tox` (https://tox.wiki/). `tox` is
configured via the `pyproject.toml` file.

Coverage
--------

.. |coverage| image:: https://codecov.io/gh/15five/django-scim2/graph/badge.svg
    :target: https://codecov.io/gh/15five/django-scim2

https://codecov.io/gh/15five/django-scim2/

License
-------

This library is released under the terms of the **MIT license**. Full details in ``LICENSE.txt`` file.


Extensibility
-------------

This library was forked and developed to be highly extensible. A number of
adapters can be defined to control what different endpoints do to your resources.
Please see the documentation for more details.

PLEASE NOTE: This app does not implement authorization and authentication.
Such tasks are left for other apps such as `Django OAuth Toolkit`_ to implement.

.. _`Django OAuth Toolkit`: https://github.com/evonove/django-oauth-toolkit

Development Speed
-----------------

Since this project is relatively stable, time is only dedicated to it on
Fridays. Thus if you issue a PR, bug, etc, please note that it may take a week
before we get back to you. Thanks you for your patience.

Credits
-------

This project was forked from https://bitbucket.org/atlassian/django_scim


.. [1] http://www.simplecloud.info/, https://tools.ietf.org/html/rfc7644


