Metadata-Version: 1.1
Name: ags_client
Version: 0.0.13
Summary: Client library for accessing GaaP services
Home-page: https://github.com/crossgovernmentservices/ags_client_python
Author: Andy Driver
Author-email: andy.driver@digital.cabinet-office.gov.uk
License: LICENSE
Description: Accessing GaaP Services Client
        ==============================
        
        .. image:: https://travis-ci.org/crossgovernmentservices/ags_client_python.svg?branch=master
          :alt: Test result
        
        Python package providing a WSGI middleware for accessing GaaP services.
        
        
        Installation
        ------------
        
        .. code-block:: bash
        
            pip3 install ags_client
        
        
        Usage
        -----
        
        Registration
        ~~~~~~~~~~~~
        
        You will need a *client ID* and *client secret* from the GaaP Identity Broker.
        You can't get these yet, but soon will by emailing us with a brief summary of:
        
        * who you are
        * what project you're going to be using it on
        
        
        Quick Start
        ~~~~~~~~~~~
        
        **Flask**
        
        For example: given your Flask app is defined in ``webservice.py`` in a variable
        named ``app``, create a file called ``wsgi.py``:
        
        .. code-block:: python
        
            import ags
        
            from webservice import app
        
        
            app.wsgi_app = ags.Client(app.wsgi_app)
        
        Then start your app with a WSGI server such as Gunicorn or uWSGI. Eg:
        
        .. code-block:: shell
        
            gunicorn wsgi:app
        
        
        Configuration
        -------------
        
        The middleware looks for certain environment variables for settings. The
        following variables are **REQUIRED**:
        
        ``AGS_CLIENT_ID``
            The client ID that you have been issued
        
        ``AGS_CLIENT_SECRET``
            The client secret that you have been issued
        
        ``AGS_CLIENT_AUTHENTICATED_URLS``
            Comma separated list of paths in your web application that require
            authentication. May include regular expressions.
        
        The following variables are **OPTIONAL**:
        
        ``AGS_CLIENT_SIGN_OUT_PATH``
            Path to sign out view in your application - default: ``sign-out``
        
        The following variables can be used to override defaults, but usually should
        not be used:
        
        ``AGS_BROKER_AUTH_ENDPOINT``
            The path to the OIDC authentication endpoint on the broker
        
        ``AGS_BROKER_JWKS_URI``
            The path to the OIDC jwks_uri endpoint on the broker
        
        ``AGS_BROKER_TOKEN_ENDPOINT``
            The path to the OIDC token endpoint on the broker
        
        ``AGS_BROKER_URL``
            The URL of the OIDC identity broker
        
        ``AGS_CLIENT_CALLBACK_PATH``
            Overrides default OIDC callback path
        
        
        Support
        -------
        
        This source code is provided as-is, with no incident response or support levels.
        Please log all questions, issues, and feature requests in the Github issue
        tracker for this repo, and we'll take a look as soon as we can. If you're
        reporting a bug, then it really helps if you can provide the smallest possible
        bit of code that reproduces the issue. A failing test is even better!
        
        
        Contributing
        ------------
        
        * Check out the latest master to make sure the feature hasn't been implemented
          or the bug hasn't been fixed
        * Check the issue tracker to make sure someone hasn't already requested
          and/or contributed the feature
        * Fork the project
        * Start a feature/bugfix branch
        * Commit and push until you are happy with your contribution
        * Make sure your changes are covered by unit tests, so that we don't break it
          unintentionally in the future.
        * Please don't mess with setup.py, version or history.
        
        
        Copyright
        ---------
        
        Copyright |copy| 2016 HM Government (Government Digital Service). See
        LICENSE for further details.
        
        .. |copy| unicode:: 0xA9 .. copyright symbol
        
Keywords: python,gds,govuk
Platform: any
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
