From 5cac963ee8d4375d0ae55aac64983d3e5b2ce5f3 Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 15:43:50 +0100
Subject: [PATCH 1/8] Working on config docs

---
 .gitignore                                    |   3 +-
 README.rst                                    |  69 +--------
 docs/source/conf.py                           |   2 +-
 docs/source/development.rst                   | 134 ++++++++++++++++++
 .../figures/App-Registration-App-ID.PNG       | Bin 0 -> 34902 bytes
 .../App-Registration-Redirect-URIs.PNG        | Bin 0 -> 48898 bytes
 docs/source/index.rst                         |   3 +-
 docs/source/usage.rst                         | 114 +++++++++++++++
 src/fastapi_aad_auth/auth.py                  |   2 +-
 src/fastapi_aad_auth/config.py                |   3 +
 tests/testapp/server.py                       |   2 +-
 11 files changed, 261 insertions(+), 71 deletions(-)
 create mode 100644 docs/source/development.rst
 create mode 100644 docs/source/figures/App-Registration-App-ID.PNG
 create mode 100644 docs/source/figures/App-Registration-Redirect-URIs.PNG
 create mode 100644 docs/source/usage.rst

diff --git a/.gitignore b/.gitignore
index ebf907d..e88cc16 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,4 +24,5 @@ reports/*-py*
 .coverage
 reports/*
 *.c
-.env
\ No newline at end of file
+.env
+.vscode
\ No newline at end of file
diff --git a/README.rst b/README.rst
index 687d0b4..7c09f2a 100644
--- a/README.rst
+++ b/README.rst
@@ -39,7 +39,7 @@ fastapi_aad_auth
     :target: https://github.com/djpugh/fastapi_aad_auth/pulls
 
 
-Adding Azure Active Directory Authentication for FastAPI
+Add Azure Active Directory Authentication for FastAPI, including for REST API Documentation
 
 
 Links
@@ -47,7 +47,9 @@ Links
 
 * `Full Documentation <https://djpugh.github.io/fastapi_aad_auth>`_
 * `Installation <https://djpugh.github.io/fastapi_aad_auth/installation.html>`_
+* `Configuring FastAPI to use AAD Auth <https://djpugh.github.io/fastapi_aad_auth/usage.html>`_
 * `Changelog <https://djpugh.github.io/fastapi_aad_auth/changelog.html>`_
+* `Contributing <https://djpugh.github.io/fastapi_aad_auth/development.html>`_
 * `Issues <https://github.com/djpugh/fastapi_aad_auth/issues>`_
 * `PyPI <https://pypi.org/project/fastapi_aad_auth>`_
 * |github| `Github <https://github.com/djpugh/fastapi_aad_auth>`_
@@ -56,71 +58,6 @@ Links
     :target: https://github.com/djpugh/fastapi_aad_auth
 
 
-Using it
---------
-
-The configuration is defined in ``src/fastapi_aad_auth/config.py``, and includes options for configuring
-the AAD config, the login UI and the routes.
-
-You can initialise it with::
-
-    from fastapi_aad_auth import AADAuth, AuthenticationState, Config
-    auth_provider = AADAuth()
-
-    # If you had a config that wasn't set in the environment, you could use 
-    # auth_provider = AADAuth(Config(<my config kwargs>)
-
-
-You can use it for fastapi routes::
-
-    from fastapi import APIRouter, Depends
-
-
-    # Use the auth_provider.api_auth_scheme for fastapi authentication
-
-    router = APIRouter()
-
-    @router.get('/hello')
-    async def hello_world(auth_state: AuthenticationState =D epends(auth_provider.api_auth_scheme)):
-        print(auth_state)
-        return {'hello': 'world'}
-
-For starlette routes (i.e. interactive/HTML pages), use the auth_provider.auth_required for authentication::
-
-    from starlette.responses import PlainTextResponse
-
-    @auth_provider.auth_required()
-    async def test(request):
-        if request.user.is_authenticated:
-            return PlainTextResponse('Hello, ' + request.user.display_name)
-
-This middleware will set the request.user object and request.credentials object::
-
-    async def homepage(request):
-        if request.user.is_authenticated:
-            return PlainTextResponse('Hello, ' + request.user.display_name)
-        return PlainTextResponse(f'Hello, you')
-
-
-You can set the swagger_ui_init_oauth using auth_provider.api_auth_scheme.init_oauth::
-
-    from fastapi import FastAPI
-    app = FastAPI(title='fastapi_aad_auth test app',
-                  description='Adding Azure Active Directory Authentication for FastAPI',
-                  version='0.1.0',
-                  openapi_url=f"/api/v0/openapi.json",
-                  docs_url='/api/docs',
-                  swagger_ui_init_oauth=auth_provider.api_auth_scheme.init_oauth,
-                  redoc_url='/api/redoc',
-                  routes=routes)
-
-
-To add the required middleware to the fastapi app use::
-
-    auth_provider.configure_app(app)
-
-
-
 Coverage
 ~~~~~~~~
 
diff --git a/docs/source/conf.py b/docs/source/conf.py
index d26b71e..62860e3 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -64,7 +64,7 @@
 
 # General information about the project.
 project = u'fastapi-aad-auth'
-copyright = str(dt.datetime.now().year)+__author__
+copyright = str(dt.datetime.now().year)+' '+__author__
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
diff --git a/docs/source/development.rst b/docs/source/development.rst
new file mode 100644
index 0000000..823213e
--- /dev/null
+++ b/docs/source/development.rst
@@ -0,0 +1,134 @@
+Development
+===========
+
+Getting started
+---------------
+
+
+``fastapi_aad_auth`` is a volunteer maintained open source project and we welcome contributions of all forms. The sections
+below will help you get started with development, testing, and documentation. We’re pleased that you are interested in
+working on ``fastapi_aad_auth``. This document is meant to get you setup to work on ``fastapi_aad_auth`` and to act as a guide and reference
+to the development setup. If you face any issues during this process, please
+`open an issue <https://github.com/djpugh/fastapi_aad_auth/issues/new?title=Trouble+with+development+environment>`_ about it on
+the issue tracker.
+
+Setup
+~~~~~
+
+``fastapi_aad_auth`` is an extension component to :pypi:`fastapi` to provide Azure Active Directory authentication,
+written in Python. To work on it, you'll need:
+
+- **Source code**: available on `GitHub <https://github.com/djpugh/fastapi_aad_auth>`_. You can use ``git`` to clone the
+    repository:
+
+  .. code-block:: console
+
+      git clone https://github.com/djpugh/fastapi_aad_auth
+      cd fastapi_aad_auth
+
+- **Python interpreter**: We recommend using ``CPython``. You can use
+  `this guide <https://realpython.com/installing-python/>`_ to set it up.
+
+- :pypi:`tox`: to automatically get the projects development dependencies and run the test suite.
+
+- **Azure Active Directory App Registration**: We recommend following the configuration section in usage
+
+
+Running tests
+~~~~~~~~~~~~~
+
+``fastapi_aad_auth`` tests are written using the :pypi:`pytest` test framework. :pypi:`tox` is used to automate the setup
+and execution of ``fastapi_aad_auth`` tests. This requires populating the wheels (see above).
+
+To run tests locally execute:
+
+.. code-block:: console
+
+    tox -e test
+
+This will run the test suite for the same Python version as under which ``tox`` is installed.
+
+Integration tests
+~~~~~~~~~~~~~~~~~
+
+``fastapi_aad_auth`` is very tightly coupled to Azure Active Directory, so most of the full tests follow manual testing
+of the testapp once configured with Azure Active Directory App Registrations
+
+To run tests locally execute:
+
+.. code-block:: console
+
+    tox -e test
+
+This will run the test suite for the same Python version as under which ``tox`` is installed.
+
+
+Configuring the testApp
+#######################
+
+
+
+
+Running linters
+~~~~~~~~~~~~~~~
+
+``fastapi_aad_auth`` uses :pypi:`flake8` and extensions for managing linting of the codebase. ``flake8`` performs various checks on all
+files in ``fastapi_aad_auth`` and uses tools that help follow a consistent code style within the codebase. To use linters locally,
+run:
+
+.. code-block:: console
+
+    tox -e lint
+
+.. note::
+
+    Avoid using ``# noqa`` comments to suppress linter warnings - wherever possible, warnings should be fixed instead.
+    ``# noqa`` comments are reserved for rare cases where the recommended style causes severe readability problems.
+
+Building documentation
+~~~~~~~~~~~~~~~~~~~~~~
+
+``fastapi_aad_auth`` documentation is built using :pypi:`Sphinx`. The documentation is written in reStructuredText. To build it
+locally, run:
+
+.. code-block:: console
+
+    tox -e docs
+
+The built documentation can be found in the ``docs/html`` folder and may be viewed by opening ``index.html`` within
+that folder.
+
+Release
+~~~~~~~
+
+We release through GitHub using an automated process to collate and test the releases. 
+
+Contributing
+-------------
+
+Submitting pull requests
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Submit pull requests against the ``master`` branch, providing a good description of what you're doing and why. You must
+have legal permission to distribute any code you contribute to ``fastapi_aad_auth`` and it must be available under the MIT
+License. Provide tests that cover your changes and run the tests locally first. ``fastapi_aad_auth``
+:ref:`supports <compatibility-requirements>` multiple Python versions. Any pull request must
+consider and work on all these platforms.
+
+Pull Requests should be small to facilitate review. Keep them self-contained, and limited in scope. `Studies have shown
+<https://www.kessler.de/prd/smartbear/BestPracticesForPeerCodeReview.pdf>`_ that review quality falls off as patch size
+grows. Sometimes this will result in many small PRs to land a single large feature. In particular, pull requests must
+not be treated as "feature branches", with ongoing development work happening within the PR. Instead, the feature should
+be broken up into smaller, independent parts which can be reviewed and merged individually.
+
+Additionally, avoid including "cosmetic" changes to code that is unrelated to your change, as these make reviewing the
+PR more difficult. Examples include re-flowing text in comments or documentation, or addition or removal of blank lines
+or whitespace within lines. Such changes can be made separately, as a "formatting cleanup" PR, if needed.
+
+Automated testing
+~~~~~~~~~~~~~~~~~
+
+All pull requests and merges to ``master`` branch are tested using
+Github actions (configured by ``.github/workflows/pipeline.yml`` file. You can find the status and results to the CI runs for your
+PR on GitHub's Web UI for the pull request. You can also find links to the CI services' pages for the specific builds in
+the form of "Details" links, in case the CI run fails and you wish to view the output.
diff --git a/docs/source/figures/App-Registration-App-ID.PNG b/docs/source/figures/App-Registration-App-ID.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..2ca24bceb4eccf0d4a88ad79c9978940e469530e
GIT binary patch
literal 34902
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
PsQ<y!*Msr>(F^|#!mw_T

literal 0
HcmV?d00001

diff --git a/docs/source/figures/App-Registration-Redirect-URIs.PNG b/docs/source/figures/App-Registration-Redirect-URIs.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..063c5a3c9c1bdfbbb38d02a1a6007929874c89ee
GIT binary patch
literal 48898
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
F{{ZL4it7LX

literal 0
HcmV?d00001

diff --git a/docs/source/index.rst b/docs/source/index.rst
index 6f351a0..d282322 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -42,7 +42,8 @@ fastapi-aad-auth
     :maxdepth: 1
     
     Release Information <changelog>
-
+    Usage <usage>
+    Contributing <development>
 
 
 ---------------------------------------
diff --git a/docs/source/usage.rst b/docs/source/usage.rst
new file mode 100644
index 0000000..d072e51
--- /dev/null
+++ b/docs/source/usage.rst
@@ -0,0 +1,114 @@
+Using fastapi_aad_auth
+**********************
+
+``fastapi_aad_auth`` requires an Azure Active Directory App Registration (from the Azure Active Directory you want
+the application to authenticate against), and these parameters should then be set in environment variables
+(or a ``.env`` environment file) within the environment that fastapi is being served from.
+
+Configuring the Azure Active Directory App Registration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There are several parts of the App Registration to Configure
+
+In the Authentication Tab you need to configure the callback urls:
+
+For the openapi/redoc authentication, configure a Single-page application eligible
+for the Authorization Code Flow with PKCE for::
+
+    https://<hostname>/docs/oauth2-redirect
+
+e.g. for local development::
+
+    http://localhost:8000/docs/oauth2-redirect
+
+Configure a web platform for the UI based redirection (or whatever else is set in the config for the redirect path)::
+
+    https://<hostname>/login/oauth/redirect
+
+e.g. for local development::
+    
+    http://localhost:8000/login/oauth/redirect
+
+Youu also need to decide whether the application is multi-tenant or single-tenant
+
+.. figure:: figures/App-Registration-Redirect-URIs.PNG
+   :alt: Overview of redirect URI configuration for local testing
+   
+   An example configuration for rediredt URIs for testing an application
+
+On the expose an API tab, you need to set the Application ID URI
+
+.. figure:: figures/App-Registration-App-ID.PNG
+   :alt: Overview of redirect URI configuration for local testing
+   
+   An example configuration for api Scopes for testing an application
+
+Configuring the fastapi environment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The configuration is defined in ``src/fastapi_aad_auth/config.py``, and includes options for configuring
+the AAD config, the login UI and the routes.
+
+There are several key parameters::
+
+    AAD_CLIENT_ID="***"
+    AAD_TENANT_ID="***"
+
+
+You can initialise it with::
+
+    from fastapi_aad_auth import AADAuth, AuthenticationState, Config
+    auth_provider = AADAuth()
+
+    # If you had a config that wasn't set in the environment, you could use 
+    # auth_provider = AADAuth(Config(<my config kwargs>)
+
+
+
+Including fastapi_aad_auth in your code
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+You can use it for fastapi routes::
+
+    from fastapi import APIRouter, Depends
+
+
+    # Use the auth_provider.api_auth_scheme for fastapi authentication
+
+    router = APIRouter()
+
+    @router.get('/hello')
+    async def hello_world(auth_state: AuthenticationState =D epends(auth_provider.api_auth_scheme)):
+        print(auth_state)
+        return {'hello': 'world'}
+
+For starlette routes (i.e. interactive/HTML pages), use the auth_provider.auth_required for authentication::
+
+    from starlette.responses import PlainTextResponse
+
+    @auth_provider.auth_required()
+    async def test(request):
+        if request.user.is_authenticated:
+            return PlainTextResponse('Hello, ' + request.user.display_name)
+
+This middleware will set the request.user object and request.credentials object::
+
+    async def homepage(request):
+        if request.user.is_authenticated:
+            return PlainTextResponse('Hello, ' + request.user.display_name)
+        return PlainTextResponse(f'Hello, you')
+
+
+You can set the swagger_ui_init_oauth using auth_provider.api_auth_scheme.init_oauth::
+
+    from fastapi import FastAPI
+    app = FastAPI(...
+                  swagger_ui_init_oauth=auth_provider.api_auth_scheme.init_oauth)
+
+
+To add the required middleware to the fastapi app use::
+
+    auth_provider.configure_app(app)
+
+ 
diff --git a/src/fastapi_aad_auth/auth.py b/src/fastapi_aad_auth/auth.py
index 5044d7a..d30ed23 100644
--- a/src/fastapi_aad_auth/auth.py
+++ b/src/fastapi_aad_auth/auth.py
@@ -93,7 +93,7 @@ def on_auth_error(request: Request, exc: Exception):
         async def configuration_error_handler(request: Request, exc: ConfigurationError):
             if any([u in request.headers['user-agent'] for u in ['Mozilla', 'Gecko', 'Trident', 'WebKit', 'Presto', 'Edge', 'Blink']]):
                 return templates.TemplateResponse(template_path.name,
-                                                  {exc: exc},
+                                                  {'exc': exc, 'request': request},
                                                   status_code=500)
             else:
                 return JSONResponse(
diff --git a/src/fastapi_aad_auth/config.py b/src/fastapi_aad_auth/config.py
index a0cddb5..1970c16 100644
--- a/src/fastapi_aad_auth/config.py
+++ b/src/fastapi_aad_auth/config.py
@@ -58,6 +58,9 @@ class LoginUIConfig(BaseSettings):
     template_file: FilePath = Field(resource_filename('fastapi_aad_auth.ui', 'login.html'),
                                     description="The jinja2 template to use",
                                     env='FASTAPI_AUTH_LOGIN_TEMPLATE_FILE')
+    error_template_file: FilePath = Field(resource_filename('fastapi_aad_auth.ui', 'error.html'),
+                                          description="The jinja2 template to use",
+                                          env='FASTAPI_AUTH_LOGIN_ERROR_TEMPLATE_FILE')
     static_directory: DirectoryPath = Field(resource_filename('fastapi_aad_auth.ui', 'static'),
                                             description="Static path for the Login UI",
                                             env='FASTAPI_AUTH_LOGIN_STATIC_DIR')
diff --git a/tests/testapp/server.py b/tests/testapp/server.py
index 26da6dc..78c0d4d 100644
--- a/tests/testapp/server.py
+++ b/tests/testapp/server.py
@@ -46,7 +46,7 @@ async def test(request):
               
 
 app = FastAPI(title='fastapi_aad_auth test app',
-              description='Adding Azure Active Directory Authentication for FastAPI',
+              description='Testapp for Adding Azure Active Directory Authentication for FastAPI',
               version=__version__,
               openapi_url=f"/api/v{API_VERSION}/openapi.json",
               docs_url='/api/docs',

From 5388e66dbe3177f037fe21093be378f921394340 Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 17:45:55 +0100
Subject: [PATCH 2/8] Working on basic config docs

---
 docs/source/conf.py                           |   1 +
 docs/source/config.rst                        |   6 +++
 docs/source/development.rst                   |   9 ++--
 .../figures/App-Registration-Client-Type.PNG  | Bin 0 -> 10231 bytes
 .../figures/App-Registration-Scopes.PNG       | Bin 0 -> 58641 bytes
 docs/source/index.rst                         |   9 ++++
 docs/source/usage.rst                         |  34 ++++++++++--
 requirements.txt                              |   1 -
 src/fastapi_aad_auth/auth.py                  |  43 ++++++++++-----
 src/fastapi_aad_auth/config.py                |  42 +++++++++++++--
 src/fastapi_aad_auth/ui/error.html            |  50 ++++++++++--------
 src/fastapi_aad_auth/ui/login.html            |   4 +-
 src/fastapi_aad_auth/ui/static/css/cover.css  |   8 +++
 tests/testapp/server.py                       |   2 +-
 tox.ini                                       |   8 +++
 15 files changed, 165 insertions(+), 52 deletions(-)
 create mode 100644 docs/source/config.rst
 create mode 100644 docs/source/figures/App-Registration-Client-Type.PNG
 create mode 100644 docs/source/figures/App-Registration-Scopes.PNG

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 62860e3..a72e3df 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -37,6 +37,7 @@
     'sphinx.ext.napoleon',
     'sphinx.ext.intersphinx',
     'sphinx.ext.mathjax',
+    'sphinx.ext.extlinks',
     'sphinx.ext.todo',
     'sphinx.ext.ifconfig',
     'sphinx.ext.viewcode',
diff --git a/docs/source/config.rst b/docs/source/config.rst
new file mode 100644
index 0000000..14a9d75
--- /dev/null
+++ b/docs/source/config.rst
@@ -0,0 +1,6 @@
+Configuration Options
+*********************
+
+.. automodule:: fastapi_aad_auth.config
+    :members:
+    :exclude-members: bool_from_env,list_from_env
\ No newline at end of file
diff --git a/docs/source/development.rst b/docs/source/development.rst
index 823213e..df74371 100644
--- a/docs/source/development.rst
+++ b/docs/source/development.rst
@@ -38,7 +38,7 @@ Running tests
 ~~~~~~~~~~~~~
 
 ``fastapi_aad_auth`` tests are written using the :pypi:`pytest` test framework. :pypi:`tox` is used to automate the setup
-and execution of ``fastapi_aad_auth`` tests. This requires populating the wheels (see above).
+and execution of ``fastapi_aad_auth`` tests.
 
 To run tests locally execute:
 
@@ -52,13 +52,14 @@ Integration tests
 ~~~~~~~~~~~~~~~~~
 
 ``fastapi_aad_auth`` is very tightly coupled to Azure Active Directory, so most of the full tests follow manual testing
-of the testapp once configured with Azure Active Directory App Registrations
+of the testapp. This needs configuring with Azure Active Directory App Registrations (see :ref:`config-aad-appreg`) and
+the testapp environment using a ``.env`` file (see :ref:`config-fastapi_aad_auth-env`).
 
-To run tests locally execute:
+To run the testapp use tox (or directly with ``python tests/testapp/server.py``:
 
 .. code-block:: console
 
-    tox -e test
+    tox -e testapp
 
 This will run the test suite for the same Python version as under which ``tox`` is installed.
 
diff --git a/docs/source/figures/App-Registration-Client-Type.PNG b/docs/source/figures/App-Registration-Client-Type.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..cf773a030bbc5052604a269fb6caac11afc9582a
GIT binary patch
literal 10231
zcmd6NYd}-iwr;fDZQ0$e6>1gaaasiw6*ej$kA!xsARtgc1cZ=k5QOj$LI@B-+*_(e
z9;t+fypmQ#gg{~puOuW`6(S;}Jd!{lpah8IDPj^JB-};!Ip^;C<DPT>o%;jUnrmgv
zIp$-0;~U?ch2IDHe)eaJKZ8J^&-~7u3I&0-D}ejaPd)<v@8nf{0$jEsLw)}Sq6}Lu
z0fi3}z6<;g1ft<T-MIKCplovWOcW9X`uyqE-!^XAgE$b#zS!^7cjvNWmEvA%N(5tO
z`Il2)fAZ5m3PM4C1)2MQ`RmTU-*$2;&HhBGw>$cX^7Ex8+84K{SHFMt<-bLJmly-x
z|83>jn;-gr_vceBt4?PwUO71TjV<om3+LY@uhi-5bUpBw3;_|LW@wF{FEzO217&Av
zjAAACkyeCLA0w^3d~N!mXLYWqNa>5Wwt{TDeabbcIeL|ZHrW#eoxyDy4yEGXOo*<_
zP$fy7@m67A;a<K~t?(C0xWpH$9pxGGR;R0am(Oj|(>ApJO5EEG`OV!kMu|jwjM}sE
z%tD;ok(T)~HCZ4qW;mgE;&dNrc$+&frinscPfoKKt7)M!ZZwzjM4Ik>BK&ZarUQ9z
zN`8<V<IyCFz|-Qb`gp2=8u0VvSrEulK5VOKITVGObhwBn1=u}{%JkCdC#nxeL}dgH
zto)Aq@Ij_tUfRG6fJQWWc8L=FPm~d!dsG&d%FL+|_D7<+M8dw}{z{R5_qaWS>*%WY
zMUIZ<FoT(>cud$6DUI1VRekop2NCI;GKh`q6=ZHE2Q@CkDd}3NbJcLOe2f`8X!3s4
zgN_M>)0OUJdI~U|Cj@=_x7NX9?5QW816Rc!6Hnms5dP1nrMDk`02Doa{^wtI5g%?Y
z1>-z6UhlwN;i~>YGQMy6xWa8FyTR&Xz{Gf0zln<CmIG_5{)96VX?TkMpzbfgbGHOS
zfdSpC7l+TG{V(}H;aJVy>@fV%JAIem6Ux2d!sgft%Pi-8H7B2NO5kQ$z(<PN4zn!#
zdo850J!KEmZWdU9K(ADctS6MXDU+_U&|S98E<xod;?uubTBFZ*+G#t+?|Bo(54#M@
zX3oV+lBC`IN3IvqF_ji!MS83lv9{oZTdNWg`Y<CM&rcaA5ciFTAvbeVlFZrOKx=Q?
z5%vm~ZRElZcg7&3uO+U>KX6rs`{arjerdU`i8**UsK?Fzk%}xyMawg>K|h3NC|{&E
zNYDr&xUm1&HkeFkF-bkKTZiI)HAF@*<C0V4F)K6MK%gH~7fe`YLki?*6*g#{c`v-t
zj_a~>yaxKD`nZ#D86tC*uR|Zz_2_Ei1S_rFt`W%S=o%kfdux#izK}2u6Iv-znL|f?
z^4faryAq_p0=dRO*ed+zlFDTJkC;t|JUM_WN#$Is`_N94FaR$uUAi}}3^|(IfJ(Yc
z4JE8QQY3eBj|4VGN9$j>(~+umIU_B7=-ij2l!{`&yvMor_KKiZUt2R~)IXYxH4oxp
zRd18d+L}GhE$$ddKyS>$OKxcw5a~%z95uP6>xcn1Z<rzX=DLK1<Y^DiG_rhv;oIZs
zev#@I<F>dTRsM;8)y9IzVsJTRdtTDJC?Pc-6YL=Ln;?`{A<qf+Gq-FAX2;($haTJ2
zhla-{9N+3wQ+?e-UYYB_v*hyjmbTHhhPj;T)>1*JyX{)5GAXksDHA;26`$WYw-U<~
zxOz${Fhu+&ids#r=$GGFx`P<r!bcnTgBQ`477HGQ5x(PxAMM9Nw>Lp5YQFUt;N5#z
z1g*{U@9LTkbE9DAt(kFrtOLCOip-c^nHIJk(J=Wr0fri!%q6Uu<~Y+-8lkI`098h2
zg+5Vz$k=<#zAzU>GK1~5&6JS~n~KZEEs-I5kAbGux)>Qz*6m*!Ag)^MrrHe-U|xhu
z_>@MLYfcHWgtEyLwtl6{fg!eB;TnzLZTdmxx%V~)#e0C-OMRb|4z;e~%z*o=mZn*j
zfhIYI=RbQJpZLZCk2+63DJ5k7h<^gyC*!wV05sujy5$`|aL-Htvv<vE-^DG@%PRh#
zc^Niq)OPJqvvo7CclWOLy%zQwHQ@$+1Pq+_`cv2y31H&GBc@sH9Bl{HD*qjUWXaL7
z)!^H8WD3MqeQUsdt4G!*o)`QD2_}sG_v7rn0M<Ru3JRL=213cnBQp7=gsmXb`x4SF
z;r_lHJo)qtG)=D2`P*C{341THpKQ7#0!H9k3iQxL>Ht~ffVT$c-o>3t=RR|4#^mb6
zXsQ6W+_#(bQ#6?pF(stMrwPTI&F|-X@_h^eu=UXjMOZQMS%M8<NoPmm6Np@$T>rBG
zo>u=bEm3WPQI3thUmu6AMgp_<I46bp5bYQLRSDV2`_Bz`vxMsGwyKn6+Vn7(kBTou
zm!NQ9uBh@b!);d^IeYh}w+TWk=*w=ikghps?lA1R-Q&)lb{B<CBmo3yFF9eQfSv#H
z^l861x5WZag8u9`_3cR;69r%{(%^vqwNqz@VvEk3*Vh&a`ChwtP<od|82)Pqj-6vE
zReJxZC`|@29kW&3dc74e9_Q4%TttHjp}Xu$0{jq^#yz|2o95P1h2SG?vu)L~+{svv
zuGRqY;ONY~qL5}kw3}T{et<rZyD_?ipt7~6{ulz30ROBzwutb|@oUtj>V+5+7QRuK
z+C!;QHX;Xe`!P-d7=mLzwgqAEx^b&tJPhHHZKd{Lci8#`U##VQNFgv8k2{Co1vCY1
zXB8adr+3wVoA9@`J-hnG|1iZ0S5$y)?|k8In#C74m0=<V;2u8mR`=L<x>otYT)Tx9
za@xUPw<>XU4V-``!R&4aal&E#mt2DT{F?o($NH4aCKtb!x$x=X54(XGb!b46;Q>;S
zd0)1T!=!pH8`f)SqwH#!kFm)K$uN>(2HD#gj2en9**D7ukmf3qQt?oD_d|OB!LM8U
z;LyL-G}<Y0hvwFZ(Pl~M&4y-TfL7WgBG%WwID8RZ>`#ee#1&IdvS%DP@s2q?llfa~
zIv4=WZg9}VG4tIO8~6`_xr~9BYCpZ#q=a4y+KSUxbw59ZeSw?4{C=m!t}Tzf#`^Jp
z#znV0>|ZhCao_sf?%wQGK^F(LszUc-vgK`EpL?&5;6G36HMlzdq^efctA15AsuIyu
z^|3A6ucnuev)5(hn>HJ-KE7E6%U^rTr{-(kuJLfjx0Ag5&Ju3^5^-r}$yyc*VBt(z
z_ome!--Qq{Dh9dfQLaV6Kk{{NfLAhWc`Vvl_u1Bh?cU=*Ka;mI^z{12JFIosWjPL+
zy-G6bU(ap`H<7FIUPJHAs(h`q=q?zc_V~CyfT+ga$FySFFf%2y_WKnd^sWu1QH)e`
zAuM;PvFTD!hbFh`05we-BixLUZwCzr2S-;tUXqw4;f#lHs8#ajMz3i9YS~g<W~ydG
zy-$n~ujq~U4EG8QQt!>R@JC_Iy+z&?f;wB2w0(h=w&JBtTB@m&*QBr=bzgx}Z$Nmh
z_%o{mOyVin+}Qh$%v7(G&7V{Zl>uu!tM4E^BptiR7>c_x2q%n#Q~r-H^G!x<N`4=c
zvg%rEhi}^}ZAREa%rARcJ6wY&_yX=<-q!?AuQccNdkV${*;>Qfo8EbrBqqZe>B&W^
zYSPum<aZ6(!*XhGK3}N3oN3*H7mzodeq7H;;Um3Jm^~#6J;$RP-eva-m%Vt&WKLG9
zppj*)cXSlKU>46bBuQh#h22wgm`_0yL}II~_T<K=_tDGnzwYx8=7LrG#2EI+DtVZe
zzF*<8bnd96z=!5eEG#8_(<K-2N2k3?O*@mR<~kZZR+1URwnkdhHSaFC3nVCUQsNE@
z@1@{DM%q!<jSlR~=~g@i=W=UrTdfd^MLDISg?t1EG<-5RLW9D!$l>2WFJYjtbwR_^
z-i;mJxVvf?d(C^trh<$!oSIGPZpQb&iFE2Qa9>YIIU6Neiu-TCS7Eqqn!_fTz#o!G
zWu%ZY0*z~TG5{HD1*;KO4@F%F#zxr;K_6w-xx}w9X_L+gaQbp%PJPI<2(<#fz>Qx4
zfu_c6#+P{)umpcQdi0uba{&iyBVqjo73~SLDZjf*H79o4sH-Dp61l0K7loK_)jy^x
zC@fk5JENFbP}=`!#yv}Q*rc{Z$drsZW18VAn-cuuc{=zfy-#rC<;0Tl5~%$MdssvD
zNvEU8j;Wm=fnIsNkNB%$=&$SRC+#bv2b&cBuU3|rvKf5;G__#HFlRinRJXE6dKZ51
zpiq8YO4@kd%$?5HmdrwCX5Tb#2;N)&j`?*jOP;!5!aA6KuB;M^Ap9D(*y1EdaD7pp
zSxy1+W+!<ABQbFYVjUj^KYpJxlHG}~W*w&<yXARV?9rKJ4f<j4`i(De`G&gQ<eK2g
ziXJ^+!Q7p*^H#VZj|5l|a+FqHekdw}y*CUR{OXur#5>1SQqjx@xlWmIw76uyVr}i!
zIkQvVVkqG+ZPm5hR!rov8D&F%q79em3w4qXYeza#5_kBe-=Z40tzTOVvIT6!k+xsg
z59;jUP-?n3=lOwDCG(&p3FG<^Xre#RRxvl<W4Ew&4hl~d(vaOt1yD^*xinIM^qP`>
z`y~G}gxOb`XuBU<SiN?rRJ>{P<g|j|wJ2JSImA1Nm!EojXXUwbNbesFk0tL==_2b9
zbeERm+e|ccFCL|@9%`d8Zca-MT&((I=}%Sam*%Fm?!~GjpjYduvVG2TO^UTi&2-V_
zG8G4joiW_^HkEXmX5oln?m2WZpCNthdr9?6<FmqNvi0s8plh{P&3ZFyGV5x7rsmw@
zxT+%E)&iQu1f*tR;(+6n^cNkdH#3*}^Fxx2@C(pYv(!0+6`_<+h|a%(^|7gN=Z0x(
zH!g5%e$uZf-0$<qv;7GZYZthlKNT1@{#pGP?t~xrLGTNtw`N6ozL$&r)NSo1A+x9E
zVNuz#$0CGLm{vH#mhP|z!j9sO@i3c2k?}MneO0jTTj>L2n{W;?`tMk>#Rwm(mIhil
zU(f$`{bQSsUZWe@BT>i@kNaNK2I*pSMh*nJ`wwK^xrNM6YtuMut9#+^->*&E;2EEJ
z*b`fEr*s#9Uvl>LI{i^!-|xQr${(-!vEKN#bNo)jaM^{y;*JC*RQfnf)7t>RF&2g!
zIS!3^LV;!0VRc$seD8@R^-k*SPEI51T~RGJmfSY1_uz`xMF{qh+1m5GbU8LHk%yTI
zB}y48eG0Qk+CI<eL971^PT~9RFMqzaJ0u<b&tNgDvzKROJfYa6@@<U|Yn9O^qk_#V
zd<j&BB3DxQjA8u*rku+zN5FXLJUyozkqebVc#Rrg$s{$m0y&;#=;X7-H^7Q*+!1ND
zCg7*_#V@d8l8OX@e77B!lgZ0eXYN2bp@LCq>Xifm8Az<wo(7uq5slj-5!#dMmfnx$
zHPRFPDUlv{WWA0ikJ~tpInjlLvXI^X+87Kj<GpE}?HpN~z6Uhc6cXChL|eb^v3}@I
zu7h4Xl_vSen|}|GWe>bl=ml)~7~wk&inb<QWqC)FmK&V;2K>*Z3#(!HTFZS#`byc#
z${pgE(l_%jJi<npmbgz8He6dD&?1=}*7P|)%EFr0v-JC^6?H2;V8@*45eS$ozYO(R
z8K<(D^(*gdq~!?d+Cts{+)58=r3uAoRhT77Kxs6_q$#mOIXRy<thNwOsyg0v#|o_v
zQPbJ5j{N!#8*uLXZbuHKqMs?hZGfJ&;?c^}H6lUeSY*Ed^Rsjb(E#rb77)`q6ZBJa
z#O;r*lPe#}KaMp%3>T;LEqKS?YEw?`7#z7HW0b~7yTh%>D=U$s%BB{?qUGjOKoeq|
z6Ejn#HA{Ci!a9s~uS|<BU4g`tqDVtyMp^!s>Kux&!&e%CZ_FBQlSOvQFEpv5smHjj
zE*|RXTH)KsVR}^F!ii>XTPe75xUI9}#@skXBX4bE%Uy(u;(lMfsnsDWp&v?>d7ye4
zPLKlFA8Wi;YR*_w!?^T%t{*o>HwpgJHSmPum}33!5!{uJiTNjn^Y_HVtZYh-wC&?s
zcD2A8*67Pgi9^Xknpc(V4vM+QJsztY>JPIbb;u{0rS(|x>H{JzH@sK-3v)&~cj{Xz
zLJ*B?6}eeN(<@{7I0eTy2#V+w_E5#v@yh{BO*~vUIrU(s@5QKyo*#WISaT0^9!{@6
z-r3G==?4Il)5<GNSBRjSG_@OOf)Gf2D7V>e_-m^q-1zWiq^>0YPHBHqoxY`*7pddB
z_`m~J5)e^cix1jzT`u&NqEeR4dK3Y44U01^zd{*bj*8YKwP#s{d2+>72)wMc%Tnj9
z%_n(6q<l?`x_^4M#HqxJE~vq>j;t9Ul(IkSXv?jDyQdxGjPiczpot^vYn@vXTJ;${
z<b-6G=qUrL{<sAd!Gf%t*DKEnBckKg_|za(pP^y7E_z6i6)iC4g^AP6y{A3^P2V4a
zm^L&e=g$dBno<wzWvf?`6YFKn<^LE|Y80<hpj@ZYIr@0XmTnh-Xlz7@g(Y~IxtuvO
z<^R#U=8R4&?+a-|w4~W9$wL<?)Jb%W5<YZ+tKu_hQF)_4@}5bCAL+x(pvf*4wL?4W
zsl%T7FR3}HLYGXEjGe*uxC}!bo)UX$E@Rs%F9ku9-qG~EwS6BvPVt;_su$oaLjfUD
zDzn+QIop+=u}BLMQ;^dwr3WEq*O@cPN660fEGRBMYbdF1^H=Y9Y#&rQ%|p$g>fzcb
zynC(m-tWT5lp)@|#P+NdVMjQ1IWe(KuJSyXb-Xjat&zPr6IyRiU!BJ?z?jWJ8n*@B
zBDHA9?WaPggc+T<W%qa(lpNila^a4?S*7cI>j^2!L+X(l_WiusAyt}+YQ2x|%tsD2
z8bFT&r;cBwZvONjb?xbeaqXS_$1=X0aYS=-<pI$vqSQT=U$XWwYrG=?QO)CSMvl8f
zr)0~cqb`HAx+*wbv*01kr>sy`;*=2i^rY87He0YZNh~Q8M35{2Tu>g-rf3WyZBdBk
z6o$~E$^gx)5YjoD<dHkl0PuMVOfB4Mrc!VoW|$4IS7UaQIn3Qu`LbnzdjzVM?VS-M
zB(j66hIN+Svx1p0(8P6unYL~D15;haj4pQ*4F|H1{ffs&#t58A!Z{$5=mo?~x8$XU
zEm<(p?GK&vTGRhO0_XotalN{|VmB<0X64z0w2W97Y4BA>hB8W!{gAwO)tlL?&**93
zUyD8fC98++6wt3HAD>T^8`}HQgQ4)m8J3!Z$=)>Rs50o%q97EWv?N%4`*g?V(e;oJ
zlJ+&bxaU3H+XkXrNNa~@i@c4ydDalatJ(;ov3JwvCLSx*rC5S~z@R-Y@^I6d4?}F>
z*TR}#mI;xQbKOl8=h~)x+u>B<#CorHN%K6xKnd=Xzw!R$-5%?R-l<!fyuL+i2UG3X
z#?#$Ktt?URy^7v!1Jv4N^*5&4n>%c*A*-*hlW}$7=OSRc5e^y~xu`05@zLzSk45^^
z!O9rs{MW*P&RfEv97e32bpspag9+U{ur@*_ecLkcF10jQo^JGPx>trE&u3c=!tskJ
z1A@n=IihAAVtZo)c8l#RdcF!Ti6HrRY2U2B7)|#@hQIS@rYs-k*f|huk>|#TUF62I
zhy{ID(GbTX%_BCpwk~X{!R0Js&C-)zVED0XGutH=Ztb<XF3As>f~U&ER}iogDsy6T
zI$?HIDRH*pS;DwJQrpdWl5yo}lg-9dCA_Ycyp@N$Nr7IT6+p*@eKr2ZlT_TqicK0{
zd_E@7G$#1MK1s%BA?CKb9o!>ixk07z7;-%3MM0nZ#BU>HIm2xzBm^3d38_{FCY|kq
z3FS08k!kFZimbeKzl8FdheM+Kbe%2B9I69K>6Ops1aRwz!qZtS3PYDH?TD<Y%4{8}
zxyzP{P+rY(01n;Kd)^vEgrfY&2X=nNcOjZk^?fF^DHnGN)`cUxgzfRr0Xaxc5{%Im
zLoRBT+WJ4<91-H)mIq@O7RbwI1y*Vg(5oKDZ!X$YI0}+No_x<ew)1&GLn)xK9<|_Q
z30TWfxWF5sB`8uXUtMroO7bJbf`e^^&$9%Vhfw~|vqE9XW$c&mBvJ-NHJIzhxu2HU
zDyL!tgl_srj&#Q4aIP@Oy;9@f*h!z?G`8RH@3*f|-MR2om!0@oZQp@rrKwg#eb!k-
zC{_x{*amnOoSxNHy8dXUBmoAdMs1HJphglz^v^&iNSNgU@aC_)<qMW1Nxp{+BBWCT
z94q^$tCR|A<M7Y~g|{3umuGZXyC6ZZ4!KvZctFqERWjW=;(7vRZiZ}%kSMS|?`5kr
zyHgw?$w(fbZG#4=Y~kW6NymJo^`WUKs&dlsJU5g?Wn5Og!QsRgtOs)|L#EGgge{KE
zDBQvc@T7IgWw7uC$1(o6D}t;tj%0&N*ISCsZ57q6!h2SrtH)GB2@{%fesBzH`F8PO
zZfOD-U<sPkyg*!2QFuC3+Ir8G<eD(G%<$=?#}4(k7KMzEwKUh;(POw53}#wlUf}F#
zq;OU<)c?py9&R<5C7`o2y&uIkk7xDEtmm=6r<XrxrJ#18>hGNZwC?+(nt;H_s&x&m
zeBHUMSh>jOjEKY&t>U%@PAgi{;e;~Lb4hw<o9o-IS#<+R!k2(Ut}DnU&(7HW=@u{U
zQf0xaUn9N>1<<M!lim&8lf*hu4lIcrcekMoGpJ2=GIzUMwt@t!hv1qT+r9-NE1&A-
z8DZs#uh#FZXw=`!-CZRyS4+^yBt`OBO$^-CO_Jm(pVVrQn>D(JiLqVr{c)t&@OLw-
z`A6E|r977}Yg2X!$syaLy?3O#T-1$e8~1zY<Na1blRG<lrvt=Dblpf!R8_HjcL+TY
z@VG8XtgRyG+oS!qW)+8nj4%BN{=+-%zi>bhtlD0OntfK4TbI;nAF@o-)F?e5Nvv^s
zdAiju*ryfDUaw764PzerJXDRpC6&8Oxw2v%#O@0aEQxi3yetb_T8yiPl2qMM85I8#
z<dkr7fOCucE?aDP?m`f>sAnzYnrT7y5pySp2Dm?TANB8A2~u&OIne(xi*~j+oR`h^
za2{szx0XZa`1yBjkZSN6)zILMC`$)&qHZg+>qRc)!An!e>Cc#4jkjxRt@bG<4Gg@S
za5BxR+hw9R{A&M(ZZC54(@zY>I{s+PP1IQ_v;zsTto1*Qr#b@8d1fO0JP`0M|1Lb9
zHT#q(OAu`Xxn2LSl|RE7hc)aN=5EFdr|fk-+t88cuyOZI{u`&j{JF_4;_rRi0QGQb
zE3z=;es7wk4^Cm1@H5GY?|q@ak9DE*)_-%Oz9H)%+WOh9bYPb(l{sdDv8&I&)gx?@
zM1SvYJ3?7W!XWl5nnut+$P+zrJs*Lt=@<SL|4)UUMgiH#{ZK-Xtz1KOZc)x<8-A<U
zAn4qkB$o0rBopQ9gNVb4(N;PVmIrT}Jo#0dlr!SK2pRXzJxYzBMhuy1H^$WFE3ejs
zHo78_H8PrNM9L>4BxJ`dSM*Zw6HIDp$#B4Xu|RCovXgrvDxw}3mVesu9|&D_FTU5*
z-@ZbIJleAVI3bW<e@2?8xx8IIk7`d%X!lX_Tv+KH$TY6vYbjrwY?D);_m@5lQ665^
ze#`V?2vk!2mI<r-f(0c=L|Y9DxMU<LXQ94HTY(wuVBX1%z58L0exD0z{l#E}q`K8}
z2DK&CLQg$`I6zyQ<4i@G1Zery#XEWg_IPj6?U=3>8a=<FF<o~VS~_{MlTMTXte=o$
z|0d{_#>0bHCUU$;HTWm9P7F+>vPEtl@ougNwETgST%4`tuhiJSa*5iFy$_z+niW=6
z@B}@!NP6J)xY_)AI~aa$n#4Tn9~&;vl3$j#l}S2YYJY}Lo=?ZQsW!j3I!7s^*8e{O
z8ED!@Cp)HC`!M@Uc+j{D*Cy<C9YJ$krY^q3`ltC=zmlOW0dg9(d9#FyNI@q(VUAPr
zjpO*+amj8}ZHYkDAFoWc(p+ZmrDB@{CcKT)__aL%OY6?qX`(-P?&!$5IjFw;+^}iD
zE^qf?2sK3NNrPQ*8xlN+3%e=csj0KW<din&she7IIuzCwo@ZVE{|*|D4X7qF?O~T?
z)m+lqs`o8%8Dw|I>U;6#R#QHRHxrIx3lz~mum_07-vi+NsC~ySE`SeKwjF*Z*>07E
zv_E#|`~UauJcn;jx8Ll*9Zv{6x<vzk`V-8uUWNV)?4(~aH_dugxkRnXn*A-6l(*PH
zhJCAC+zz-Hu))@SdA+7zg_#I5oZS+rz5km{Hm8YEUA@i8%UW(}{JBmMH-%A%{N7z-
zf$ogmQ5A?Y*O~D+ngYkqL05BB$xkSwnh1xkisV?`M8n$pNnhh&!~HBngRj3<W^==%
z?~0AvY3Wr(&Nx`8{i-t-Dc8im&tG;4ACWh!f#8*i<-fsy|7%m)-u3s_(_%*=e#}>R
z_ND=QlvOti44YL`{;pJvVkFP@tV>}iOMCEQi^;@6AAPrpM=ClsKt@DhK8>a_G`agY
z_fyGlH08PqVT<!!&g2>(Uir*UQk#?;v?HKyPk>(FR^PsUeSHU{+u!osKWSl9#G}`D
znWjG;UTY67EC>iZ@TK(by;FV84v<o_axcmYMk%y8E?S<%DJ3~GbSkfN8KsAn`?y%E
zX>SistP3UAI=XM!%F27;j=w5kK|i}`<dci=&1Kv+M2V`%pMBnfSH^wL0Q|WpSJgzR
z5{hXkk~^_Ih}i2NQPrrcP#3xT9Op_$t8Eoq@-TVX;$MNL2BuHS<M$0OLiGJ<Hu$yd
z#Z?bi52q3IG8z{dU@3`%qP7rzt8ctG@oDUquZvBJ36+*)KRn?RO~PD5K|?2!;~!Xl
z^lNu1?NFab;V5~|(86KnQyS-JOlc!_eA&ysEu6>G1KiLd7kUzLr7ah7cMi+X5{R`M
zxx;k*-J>;4M?Lb{K{ezE8!px%mD~z-(kUiJAcy++lKDHjmIx~$RW{Z$eN)(CfF|>8
z+wPu<JSWVy>rw5tf0ino@7D5HTZ%Nxvgw4_9BDIlVJ4%^@jkKYz&5q<fuM==?j1kd
zPF{)zsLSNP)4+_FM!SDYO<*HDU%%;3f(d+&+R35%JMakqU+PXBOb-ifjI=*vK{gS;
ziJTl>cLwkaXASUI;iN@<Oz^v0KdAjwl(%bE7VJ^IrjZ7ap!Lx^`bUtO=;mS(w}<)&
zCNtcQVTFcH*(y3<g(<u3&8ONT^gdk0f8qs?lN(F_u*Xh*m)D-K7j%`O8Zy&{JSszV
zAqFD3mp85)3E3Vt=nkxq*@4ii<L;9gI7)>k^`)VySid?$@aNP7sAw<dX$bPmVfb-D
zpWsn^eJdKS3g&WP@$%-@>e}%t_3n_R{$s;Bm)VE_ov)XZzBM38408_(?(~I6@j4z+
zi_A-gL@g}b@mPEV#{upG1VFh<;>V!r&vc8&6xCnGdCH-lDEMR*Dr9cd*1KU<6eNxm
zR%IqDe+%~NGpX?JZ)u&35a7+xVy=#u#0qVeFGNOUcuC_u<=p=J9+k>gr;-8Gj8hbE
zxfRg<9q3w-j{hKg+Icd_<swuj<c7+)XO4E(0%L<f|0gXLa>i{HHaHbG?=K&LRDUlz
zGZB2d@Y)N}Dc?fwft*%A7uaYG2z<Qp{=Fqvb-;(qYpR(UYc6~}3dwtE$;-Bx#blH<
zMR51`Wx->cv<Z3E2}>g2q?2W6Kd|f&ES96Du5^+vc)>s!ij^Wi`S^sTjux*byXbsn
zqQvsY0^arLzzIV;_F&;KCu+0@U~@_*U8ru_Dj_pgU@KWaJ)TT>_`zdwrW!bGbJ~TG
z-t2c%<mm5puIIdfwOVs6B}XxQz{i$wL{~E0&{?JZbtS!7`fm=ULPRH66{<`0@Nv5j
zfd#7r`-CEH`V`FpwW9&N;ND!kc*Lq9mMcOlh<tS@mG$BZsY0-vf6A5%sABCm<bK$h
zUO_s$;hyWkZR-A`&ga1rjqKS8`FTC_&d5Y)^g!2ooOZrfi(hQ@>-U@329O%Mi9YcA
zCwE6nwpID7<tp#?&in9UW5c#!;0VMueNlnIqWtPh;uqVi97qME>w-m`CwBzqq~u%|
zL)Km*B6_chhW-SKaW&QMJMi1{zdhOZ>i!#q1xtM~SaVDXp#R_hYm)ZgpS@_~SsHDA
Zvw385IP$kGc?0BkI_MPTZ$JFwe*se^XBhwh

literal 0
HcmV?d00001

diff --git a/docs/source/figures/App-Registration-Scopes.PNG b/docs/source/figures/App-Registration-Scopes.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..af2636c9c69b7ddd56602bdbf330e2ad2b59323f
GIT binary patch
literal 58641
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%0DXRe1!BBPq$xJik2z
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
H{^S1v+V91y

literal 0
HcmV?d00001

diff --git a/docs/source/index.rst b/docs/source/index.rst
index d282322..b9cedc8 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -38,11 +38,20 @@ fastapi-aad-auth
 .. image:: https://img.shields.io/github/issues-pr-raw/djpugh/fastapi_aad_auth
     :target: https://github.com/djpugh/fastapi_aad_auth/pulls
 
+Provide Azure Active Directory Authentication for both the API and associated interactive pages (documents, openapi etc).
+
+The repository is open source (MIT Licensed) on |github| `Github <https://github.com/djpugh/fastapi_aad_auth>`_
+
+.. |github| image:: https://api.iconify.design/logos-github-icon.svg
+    :target: https://github.com/djpugh/fastapi_aad_auth
+
+
 .. toctree::
     :maxdepth: 1
     
     Release Information <changelog>
     Usage <usage>
+    Configuration Options <config>
     Contributing <development>
 
 
diff --git a/docs/source/usage.rst b/docs/source/usage.rst
index d072e51..38189b4 100644
--- a/docs/source/usage.rst
+++ b/docs/source/usage.rst
@@ -5,12 +5,14 @@ Using fastapi_aad_auth
 the application to authenticate against), and these parameters should then be set in environment variables
 (or a ``.env`` environment file) within the environment that fastapi is being served from.
 
+.. _config-aad-appreg:
+
 Configuring the Azure Active Directory App Registration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 There are several parts of the App Registration to Configure
 
-In the Authentication Tab you need to configure the callback urls:
+In the "Authentication Tab" you need to configure the callback urls:
 
 For the openapi/redoc authentication, configure a Single-page application eligible
 for the Authorization Code Flow with PKCE for::
@@ -36,23 +38,44 @@ Youu also need to decide whether the application is multi-tenant or single-tenan
    
    An example configuration for rediredt URIs for testing an application
 
-On the expose an API tab, you need to set the Application ID URI
+On the "Expose an API tab", you need to set the Application ID URI
 
 .. figure:: figures/App-Registration-App-ID.PNG
    :alt: Overview of redirect URI configuration for local testing
    
    An example configuration for api Scopes for testing an application
 
+and add scopes as configured for the application (e.g. the default ``openid`` scope is needed)
+
+.. figure:: figures/App-Registration-Scopes.PNG
+   :alt: Overview of redirect URI configuration for local testing
+   
+   An example configuration for api Scopes for testing an application
+
+.. _config-fastapi_aad_auth-env:
+
 Configuring the fastapi environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The configuration is defined in ``src/fastapi_aad_auth/config.py``, and includes options for configuring
 the AAD config, the login UI and the routes.
 
-There are several key parameters::
+There are several key parameters:
+
+ - ``AAD_CLIENT_ID``: The Azure Active Directory App Registration Client ID
+ - ``AAD_TENANT_ID``: The Azure Active Directory App Registration Client ID
+
+The ``AAD_CLIENT_SECRET`` parameter is needed if your application is not a public client (Generated
+from the certificates and secrets section of the app registration)
+
+.. figure:: figures/App-Registration-Client-Type.PNG
+   :alt: Overview of client type on Azure AD App Registration Authentication Tab
+
+These can be set in a ``.env`` file (e.g. for a private client)::
 
-    AAD_CLIENT_ID="***"
-    AAD_TENANT_ID="***"
+    AAD_CLIENT_ID="<enter-your-client-id-here>"
+    AAD_TENANT_ID="<enter-your-tenant-id-here>"
+    AAD_CLIENT_SECRET="<enter-your-client-secret-here>"
 
 
 You can initialise it with::
@@ -63,6 +86,7 @@ You can initialise it with::
     # If you had a config that wasn't set in the environment, you could use 
     # auth_provider = AADAuth(Config(<my config kwargs>)
 
+The full set of configuration options is documented in :doc:`config`
 
 
 Including fastapi_aad_auth in your code
diff --git a/requirements.txt b/requirements.txt
index 373a3d9..34b0d0b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,6 @@ msal
 aiofiles
 jinja2
 fastapi
-uvicorn
 authlib
 cryptography
 python-multipart
diff --git a/src/fastapi_aad_auth/auth.py b/src/fastapi_aad_auth/auth.py
index d30ed23..9e7633c 100644
--- a/src/fastapi_aad_auth/auth.py
+++ b/src/fastapi_aad_auth/auth.py
@@ -89,17 +89,40 @@ def on_auth_error(request: Request, exc: Exception):
         template_path = Path(self.config.login_ui.error_template_file)
         templates = Jinja2Templates(directory=template_path.parent)
 
+        if self.config.login_ui.context:
+            context = self.config.login_ui.context
+        else:
+            context = {}
+        if self.config.login_ui.app_name:
+            context['appname'] = self.config.login_ui.app_name
+        else:
+            context['appname'] = app.title
+        context['static_path'] = self.config.login_ui.static_path
         @app.exception_handler(ConfigurationError)
         async def configuration_error_handler(request: Request, exc: ConfigurationError):
+            logger.warning(f'Handling configuration error {exc}')
+            status_code = 500
             if any([u in request.headers['user-agent'] for u in ['Mozilla', 'Gecko', 'Trident', 'WebKit', 'Presto', 'Edge', 'Blink']]):
-                return templates.TemplateResponse(template_path.name,
-                                                  {'exc': exc, 'request': request},
-                                                  status_code=500)
+                logger.info('Interactive environment so returning error template')
+                logger.debug(f'Path: {template_path}')
+                error_context = context.copy()
+                error_context.update({'error': exc,
+                                      'status_code': status_code,
+                                      'error_type': 'Authentication Configuration Error',
+                                      'error_description': 'The server has been misconfigured for authentication, please pass this on to the application owner',
+                                      'request': request})
+                response = templates.TemplateResponse(template_path.name,
+                                                      error_context,
+                                                      status_code=status_code)
             else:
-                return JSONResponse(
-                    status_code=500,
+                logger.info('Non-Interactive environment so returning JSON message')
+
+                response = JSONResponse(
+                    status_code=status_code,
                     content={"message": "Oops! It seems like the application has not been configured correctly, please contact an admin"}
                 )
+            logger.debug(f'Response {response}')
+            return response
 
         # Check if session middleware is there
         if not any([SessionMiddleware in u.cls.__mro__ for u in app.user_middleware]):
@@ -107,14 +130,6 @@ async def configuration_error_handler(request: Request, exc: ConfigurationError)
         if self._add_to_base_routes:
             self.app_routes_add_auth(app, _BASE_ROUTES)
         app.routes.extend(self.auth_routes)
-        if self.config.login_ui.context:
-            context = self.config.login_ui.context
-        else:
-            context = {}
-        if self.config.login_ui.app_name:
-            context['appname'] = self.config.login_ui.app_name
-        else:
-            context['appname'] = app.title
         app.routes.extend(self.build_auth_ui(context))
 
     def auth_required(self, scopes: str = 'authenticated', redirect: str = 'login'):
@@ -171,7 +186,7 @@ async def login(request: Request):
                 return RedirectResponse(self.config.home_path)
 
         async def login_callback(request: Request):
-            logger.info('Processing login callback')
+            logger.info('Processing login callback from Azure AD')
             logger.debug(f'request url {request.url}')
             if self.oauth_backend.enabled:
                 return self.oauth_backend.authenticator.process_login_callback(request)
diff --git a/src/fastapi_aad_auth/config.py b/src/fastapi_aad_auth/config.py
index 1970c16..108ad2d 100644
--- a/src/fastapi_aad_auth/config.py
+++ b/src/fastapi_aad_auth/config.py
@@ -19,11 +19,41 @@ def list_from_env(env_value):
         env_value = [u for u in env_value.split(',') if u]
     return env_value
 
-
+from typing import Any, List, Dict
+
+
+def expand_doc(klass):
+    """Expand pydantic model documentation to enable autodoc"""
+    docs = ['', '', 'Keyword Args:']
+    for name, field in klass.__fields__.items():
+        default_str = ''
+        if field.default:
+            default_str = f' [default: ``{field.default}``]'
+        module = field.outer_type_.__module__
+        if module != 'builtins':
+            if hasattr(field.outer_type_, '__origin__'):
+                    type_ = f' ({field.outer_type_.__origin__.__name__}) '
+            elif not hasattr(field.outer_type_, '__name__'):
+                type_ = ''
+            else:
+                type_ = f' ({module}.{field.outer_type_.__name__}) '
+        else:
+            type_ = f' ({field.outer_type_.__name__}) '
+        env_var = ''
+        if 'env' in field.field_info.extra:
+            env_var = f' (Can be set by ``{field.field_info.extra["env"]}`` environment variable)'
+        docs.append(f'    {name}{type_}: {field.field_info.description}{default_str}{env_var}')
+    if klass.__doc__ is None:
+        klass.__doc__ = ''
+    klass.__doc__ += '\n'.join(docs)
+    return klass
+
+
+@expand_doc
 class RoutingConfig(BaseSettings):
     """Configuration for authentication related routing.
 
-    Includes ``logout_path``, ``login_path``, and ``login_redirect_path``(defaults should
+    Includes ``logout_path``, ``login_path``, and ``login_redirect_path`` (defaults should
     be fine for most use-cases).
 
     There are also the ``landing_path`` for the login page, as well as the ``home_path`` for the home
@@ -49,10 +79,12 @@ def _validate_post_logout_path(cls, value, values):
         return value
 
 
+@expand_doc
 class LoginUIConfig(BaseSettings):
     """Configuration for the application Login UI.
 
-    Includes the application name, template file (needs to )
+    Includes the application name, template file, error template file,
+    static directory, path to mount the login static information to, and the context.
     """
     app_name: str = Field(None, description="Application name to show on the Login UI page", env='APP_NAME')
     template_file: FilePath = Field(resource_filename('fastapi_aad_auth.ui', 'login.html'),
@@ -73,6 +105,7 @@ class Config:  # noqa D106
         env_file = '.env'
 
 
+@expand_doc
 class AADConfig(BaseSettings):
     """Configuration for the AAD application.
 
@@ -106,6 +139,7 @@ class Config:  # noqa D106
     _validate_roles = validator('roles', allow_reuse=True)(list_from_env)
 
 
+@expand_doc
 class AuthSessionConfig(BaseSettings):
     """Authentication Session configuration.
 
@@ -122,6 +156,7 @@ class Config:  # noqa D106
         env_file = '.env'
 
 
+@expand_doc
 class SessionConfig(BaseSettings):
     """Configuration for session middleware.
 
@@ -145,6 +180,7 @@ class Config:  # noqa D106
     _validate_https_only = validator('https_only', allow_reuse=True)(bool_from_env)
 
 
+@expand_doc
 class Config(BaseSettings):
     """The overall configuraton for the AAD authentication."""
     enabled: bool = Field(True, description="Enable authentication", env='FASTAPI_AUTH_ENABLED')
diff --git a/src/fastapi_aad_auth/ui/error.html b/src/fastapi_aad_auth/ui/error.html
index c51b299..1e70bbb 100644
--- a/src/fastapi_aad_auth/ui/error.html
+++ b/src/fastapi_aad_auth/ui/error.html
@@ -5,35 +5,41 @@
         <meta charset="UTF-8">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <meta name="viewport" content="width=device-width, initial-scale=1">
-        <link href="/static-login/css/bootstrap.min.css" rel="stylesheet">
-        <link rel="stylesheet" href="/static-login/css/cover.css">
+        <link href="/{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
+        <link rel="stylesheet" href="/{{static_path}}/css/cover.css">
         <link rel="icon" type="img/ipng" href="/static/img/favicon.png" />
         <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" >
         <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
     </head>
     <body>
-        <div class='container'>
-            <div class="cover-container d-flex h-100 p-3 mx-auto flex-column text-center justify-content-center">
-                <main class="inner-cover">
-                    <p class="lead">
-                    {% if logo %}
-                        {{logo | safe }}
-                    {% endif %}
-                    {% if appname %}
-                        <h1 class="h1">{{appname}}</h1>
-                    {% endif %}
-                        <br><br>
+        <main class='container' role="main">
+            {% if logo %}
+                {{logo | safe }}
+            {% endif %}
+            {% if appname %}
+                <h1 class="h1">{{appname}}</h1>
+            {% endif %}
+            <h2>Server Error {{status_code}}:</h2>
+            <h3> {{error_type}}</h3>
+            <p class="lead">{{error_description}}</p>
+            <div class="card card-grey ">
+                <div class="card-header">
+                    <h7 class="card-title">
+                        Detailed Error Message:
+                    </h7>
+                </div>
+                <code class="language-json card-body">
                         {{ error | safe }}
-                    </p>
-                {% if copyright %}
-                    <p class="mt-5 mb-3 lead text-muted">© {{ copyright }}</p>
-                {% endif %}
-                {% if explanation %}
-                    <p class="mt-5 mb-3 lead text-muted">{{ explanation }}</p>
-                {% endif %}
-            
-                </main>
+                </code>
             </div>
+            {% if copyright %}
+                <p class="mt-5 mb-3 lead text-muted">© {{ copyright }}</p>
+            {% endif %}
+            {% if explanation %}
+                <p class="mt-5 mb-3 lead text-muted">{{ explanation }}</p>
+            {% endif %}
+        
+            </main>
         </div><!-- /.container-fluid -->
     </body>
 </html>
\ No newline at end of file
diff --git a/src/fastapi_aad_auth/ui/login.html b/src/fastapi_aad_auth/ui/login.html
index c046648..1345430 100644
--- a/src/fastapi_aad_auth/ui/login.html
+++ b/src/fastapi_aad_auth/ui/login.html
@@ -5,8 +5,8 @@
         <meta charset="UTF-8">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <meta name="viewport" content="width=device-width, initial-scale=1">
-        <link href="/static-login/css/bootstrap.min.css" rel="stylesheet">
-        <link rel="stylesheet" href="/static-login/css/cover.css">
+        <link href="/{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
+        <link rel="stylesheet" href="/{{static_path}}/css/cover.css">
         <link rel="icon" type="img/ipng" href="/static/img/favicon.png" />
         <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" >
         <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
diff --git a/src/fastapi_aad_auth/ui/static/css/cover.css b/src/fastapi_aad_auth/ui/static/css/cover.css
index af4c7ee..3e4ceb5 100644
--- a/src/fastapi_aad_auth/ui/static/css/cover.css
+++ b/src/fastapi_aad_auth/ui/static/css/cover.css
@@ -46,7 +46,15 @@ body {
   max-width: 42em;
 }
 
+.card-header{
+  background-color: #666;
+}
 
+code{
+  color: #b10909;
+  background-color: #eee;
+  text-shadow: 0 0 0 rgba(0, 0, 0, 0);
+}
 /*
  * Header
  */
diff --git a/tests/testapp/server.py b/tests/testapp/server.py
index 78c0d4d..2257eba 100644
--- a/tests/testapp/server.py
+++ b/tests/testapp/server.py
@@ -61,4 +61,4 @@ async def test(request):
 
 
 if __name__ == "__main__":
-    uvicorn.run(app, host='0.0.0.0', debug=True, port=8000)
+    uvicorn.run(app, host='0.0.0.0', debug=True, port=8000, log_level='debug')
diff --git a/tox.ini b/tox.ini
index 0888d79..9d89ac8 100644
--- a/tox.ini
+++ b/tox.ini
@@ -5,6 +5,7 @@ envlist = {test}
 [testenv]
 deps = 
     -rrequirements.txt
+    develop,testapp: uvicorn
     lint,develop: flake8
     lint,develop: pipenv
     lint,develop: flake8-import-order
@@ -39,3 +40,10 @@ skip_install=True
 skip_install = True
 envdir = {toxinidir}/.venv
 commands = python setup.py develop
+
+[testenv:testapp]
+skip_install = True
+envdir = {toxinidir}/.venv
+commands =
+    python setup.py develop
+    python tests/testapp/server.py

From 31dc0fe8c712dd6d527b96f7b0cb54ac0b276ddc Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 17:50:38 +0100
Subject: [PATCH 3/8] Adding todo

---
 src/fastapi_aad_auth/config.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/fastapi_aad_auth/config.py b/src/fastapi_aad_auth/config.py
index 108ad2d..77a55b1 100644
--- a/src/fastapi_aad_auth/config.py
+++ b/src/fastapi_aad_auth/config.py
@@ -68,6 +68,7 @@ class RoutingConfig(BaseSettings):
                            env='APP_HOME_ROUTE')
     post_logout_path: str = Field(None, description="Path for the redirect post logout - defaults to the landing path if not provided",
                                   env='FASTAPI_AUTH_POST_LOGOUT_ROUTE')
+    # TODO: Add an API Token Route to get a bearer token interactively.
 
     class Config:  # noqa D106
         env_file = '.env'

From eaa099ff6d93f4c76d2cb9b5efd73dee437f19bf Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 18:01:32 +0100
Subject: [PATCH 4/8] Adding first test case

---
 tests/functional/.cookiecutterkeep  |  0
 tests/integration/.cookiecutterkeep |  0
 tests/unit/.cookiecutterkeep        |  0
 tests/unit/test_errors.py           | 20 ++++++++++++++++++++
 tests/unit/test_placeholder.py      |  2 --
 tox.ini                             |  2 +-
 6 files changed, 21 insertions(+), 3 deletions(-)
 delete mode 100644 tests/functional/.cookiecutterkeep
 delete mode 100644 tests/integration/.cookiecutterkeep
 delete mode 100644 tests/unit/.cookiecutterkeep
 create mode 100644 tests/unit/test_errors.py
 delete mode 100644 tests/unit/test_placeholder.py

diff --git a/tests/functional/.cookiecutterkeep b/tests/functional/.cookiecutterkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/tests/integration/.cookiecutterkeep b/tests/integration/.cookiecutterkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/tests/unit/.cookiecutterkeep b/tests/unit/.cookiecutterkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/tests/unit/test_errors.py b/tests/unit/test_errors.py
new file mode 100644
index 0000000..5532d4e
--- /dev/null
+++ b/tests/unit/test_errors.py
@@ -0,0 +1,20 @@
+import unittest
+
+from fastapi_aad_auth.errors import ConfigurationError
+
+# TODO: Add additional test cases
+
+class ConfigurationErrorTestCase(unittest.TestCase):
+
+    def test_configuration_error(self):
+        with self.assertRaises(ConfigurationError):
+            raise ConfigurationError()
+
+        with self.assertRaises(Exception):
+            raise ConfigurationError()
+
+        with self.assertRaises(Exception):
+            try:
+                raise ConfigurationError()
+            except (ValueError, TypeError, RuntimeError):
+                pass
diff --git a/tests/unit/test_placeholder.py b/tests/unit/test_placeholder.py
deleted file mode 100644
index 245ca09..0000000
--- a/tests/unit/test_placeholder.py
+++ /dev/null
@@ -1,2 +0,0 @@
-def test():
-    assert 1 == 1
\ No newline at end of file
diff --git a/tox.ini b/tox.ini
index 9d89ac8..04e3455 100644
--- a/tox.ini
+++ b/tox.ini
@@ -22,7 +22,7 @@ deps =
 commands = 
     lint: flake8 src/
     lint: pipenv check
-    test: pytest  {posargs: -rs tests/ --log-level=WARNING --cov=fastapi_aad_auth --cov-report xml:{toxinidir}/reports/{envname}-coverage.xml}
+    test: pytest  {posargs: -rs tests/unit --log-level=WARNING --cov=fastapi_aad_auth --cov-report xml:{toxinidir}/reports/{envname}-coverage.xml}
     docs: python -m sphinx -b html -a {toxinidir}/docs/source {toxinidir}/docs/html    
     build: python setup.py sdist --format=zip
     build: python setup.py sdist --format=gztar

From 9c81c7817a25a5f20632380ef724d83fc41b0814 Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 18:02:34 +0100
Subject: [PATCH 5/8] Adding to sdist

---
 MANIFEST.in | 5 ++++-
 setup.cfg   | 4 ++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/MANIFEST.in b/MANIFEST.in
index e6ef544..13dda2b 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -1,4 +1,7 @@
 include requirements.txt
 include versioneer.py
 include src/fastapi_aad_auth/_version.py
-include src/*.html
\ No newline at end of file
+include *.html
+include *.css
+include *.css.map
+include *.png
\ No newline at end of file
diff --git a/setup.cfg b/setup.cfg
index 55b0219..421a89f 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -37,6 +37,10 @@ python_requires = >=3
      *.ini
      *.cfg
      *.whl
+     *.html
+     *.css
+     *.png
+     *.css.map
 
 [options.packages.find]
 where=src

From f7e83e668e5d6544de0eb0c8a29fa1c5d36facc5 Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 19:21:04 +0100
Subject: [PATCH 6/8] Working on config

---
 .github/workflows/pipeline.yml                |  2 +-
 .gitignore                                    |  5 +-
 setup.cfg                                     |  8 +++
 src/fastapi_aad_auth/auth.py                  | 66 ++++++++-----------
 src/fastapi_aad_auth/config.py                |  6 +-
 src/fastapi_aad_auth/errors.py                | 33 ++++++++++
 src/fastapi_aad_auth/oauth/aad.py             |  6 +-
 .../oauth/validators/session.py               |  2 +-
 .../oauth/validators/token.py                 |  9 ++-
 src/fastapi_aad_auth/ui/error.html            |  4 +-
 src/fastapi_aad_auth/ui/login.html            |  4 +-
 tox.ini                                       | 19 ++++--
 12 files changed, 106 insertions(+), 58 deletions(-)

diff --git a/.github/workflows/pipeline.yml b/.github/workflows/pipeline.yml
index 4c513a5..71d7d61 100644
--- a/.github/workflows/pipeline.yml
+++ b/.github/workflows/pipeline.yml
@@ -200,7 +200,7 @@ jobs:
           pip install -r ./repo/requirements.txt
           pip install -U tox pytest setuptools
       - shell: bash
-        run: pytest ./repo/tests/functional
+        run: pytest ./repo/tests/unit
 
   automerge:
     if: github.event_name == 'pull_request'
diff --git a/.gitignore b/.gitignore
index e88cc16..ae7d572 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,4 +25,7 @@ reports/*-py*
 reports/*
 *.c
 .env
-.vscode
\ No newline at end of file
+.vscode
+reports/*
+test-reports/*
+Pipfile
\ No newline at end of file
diff --git a/setup.cfg b/setup.cfg
index 421a89f..4fdd170 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -98,3 +98,11 @@ versionfile_source = src/fastapi_aad_auth/_version.py
 versionfile_build = fastapi_aad_auth/_version.py
 tag_prefix = 
 parentdir_prefix = fastapi_aad_auth-
+
+[mypy]
+mypy_path = src/
+plugins = pydantic.mypy
+ignore_missing_imports = True
+
+[mypy-fastapi_aad_auth._version]
+ignore_errors = True
\ No newline at end of file
diff --git a/src/fastapi_aad_auth/auth.py b/src/fastapi_aad_auth/auth.py
index 9e7633c..7c16734 100644
--- a/src/fastapi_aad_auth/auth.py
+++ b/src/fastapi_aad_auth/auth.py
@@ -6,16 +6,16 @@
 
 from fastapi import FastAPI
 from starlette.authentication import requires
-from starlette.middleware.authentication import AuthenticationMiddleware
+from starlette.middleware.authentication import AuthenticationError, AuthenticationMiddleware
 from starlette.middleware.sessions import SessionMiddleware
 from starlette.requests import Request
-from starlette.responses import JSONResponse, RedirectResponse
+from starlette.responses import JSONResponse, RedirectResponse, Response
 from starlette.routing import Mount, request_response, Route
 from starlette.staticfiles import StaticFiles
 from starlette.templating import Jinja2Templates
 
 from fastapi_aad_auth.config import Config
-from fastapi_aad_auth.errors import ConfigurationError
+from fastapi_aad_auth.errors import base_error_handler, ConfigurationError
 from fastapi_aad_auth.oauth import AADOAuthBackend
 
 
@@ -63,9 +63,9 @@ def app_routes_add_auth(self, app: FastAPI, route_list: List[str], invert: bool
             routes = app.router.routes
             for i, route in enumerate(routes):
                 # Can use allow list or block list (i.e. invert = True sets all except the route list to have auth
-                if (route.name in route_list and not invert) or (route.name not in route_list and invert):
-                    route.endpoint = self.auth_required()(route.endpoint)
-                    route.app = request_response(route.endpoint)
+                if (route.name in route_list and not invert) or (route.name not in route_list and invert):  # type: ignore
+                    route.endpoint = self.auth_required()(route.endpoint)  # type: ignore
+                    route.app = request_response(route.endpoint)  # type: ignore
                 app.router.routes[i] = route
         return app
 
@@ -86,8 +86,8 @@ def on_auth_error(request: Request, exc: Exception):
 
         app.add_middleware(AuthenticationMiddleware, backend=self.oauth_backend, on_error=on_auth_error)
 
-        template_path = Path(self.config.login_ui.error_template_file)
-        templates = Jinja2Templates(directory=template_path.parent)
+        error_template_path = Path(self.config.login_ui.error_template_file)
+        error_templates = Jinja2Templates(directory=str(error_template_path.parent))
 
         if self.config.login_ui.context:
             context = self.config.login_ui.context
@@ -98,31 +98,21 @@ def on_auth_error(request: Request, exc: Exception):
         else:
             context['appname'] = app.title
         context['static_path'] = self.config.login_ui.static_path
+
         @app.exception_handler(ConfigurationError)
-        async def configuration_error_handler(request: Request, exc: ConfigurationError):
-            logger.warning(f'Handling configuration error {exc}')
+        async def configuration_error_handler(request: Request, exc: ConfigurationError) -> Response:
+            error_message = "Oops! It seems like the application has not been configured correctly, please contact an admin"
+            error_type = 'Authentication Configuration Error'
             status_code = 500
-            if any([u in request.headers['user-agent'] for u in ['Mozilla', 'Gecko', 'Trident', 'WebKit', 'Presto', 'Edge', 'Blink']]):
-                logger.info('Interactive environment so returning error template')
-                logger.debug(f'Path: {template_path}')
-                error_context = context.copy()
-                error_context.update({'error': exc,
-                                      'status_code': status_code,
-                                      'error_type': 'Authentication Configuration Error',
-                                      'error_description': 'The server has been misconfigured for authentication, please pass this on to the application owner',
-                                      'request': request})
-                response = templates.TemplateResponse(template_path.name,
-                                                      error_context,
-                                                      status_code=status_code)
-            else:
-                logger.info('Non-Interactive environment so returning JSON message')
+            return base_error_handler(request, exc, error_type, error_message, error_templates, error_template_path, context=context.copy(), status_code=status_code)
 
-                response = JSONResponse(
-                    status_code=status_code,
-                    content={"message": "Oops! It seems like the application has not been configured correctly, please contact an admin"}
-                )
-            logger.debug(f'Response {response}')
-            return response
+
+        @app.exception_handler(AuthenticationError)
+        async def configuration_error_handler(request: Request, exc: AuthenticationError) -> Response:
+            error_message = "Oops! It seems like you cannot access this information. If this is an error, please contact an admin"
+            error_type = 'Authentication Error'
+            status_code = 403
+            return base_error_handler(request, exc, error_type, error_message, error_templates, error_template_path, context=context.copy(), status_code=status_code)
 
         # Check if session middleware is there
         if not any([SessionMiddleware in u.cls.__mro__ for u in app.user_middleware]):
@@ -183,7 +173,7 @@ async def login(request: Request):
                 return self.oauth_backend.authenticator.process_login_request(request)
             else:
                 logger.debug('Auth not enabled')
-                return RedirectResponse(self.config.home_path)
+                return RedirectResponse(self.config.routing.home_path)
 
         async def login_callback(request: Request):
             logger.info('Processing login callback from Azure AD')
@@ -192,7 +182,7 @@ async def login_callback(request: Request):
                 return self.oauth_backend.authenticator.process_login_callback(request)
             else:
                 logger.debug('Auth not enabled')
-                return RedirectResponse(self.config.landing_path)
+                return RedirectResponse(self.config.routing.landing_path)
 
         routes = [Route(self.config.routing.logout_path, endpoint=logout, methods=['GET'], name='logout'),
                   Route(self.config.routing.login_path, endpoint=login, methods=['GET'], name='login_oauth'),
@@ -212,20 +202,20 @@ def build_auth_ui(self, context: Dict[str, Any] = None):
         if context is None:
             context = {}
         template_path = Path(self.config.login_ui.template_file)
-        templates = Jinja2Templates(directory=template_path.parent)
+        templates = Jinja2Templates(directory=str(template_path.parent))
 
         async def login(request: Request, *args, **kwargs):
             if not self.oauth_backend.enabled or request.user.is_authenticated:
                 # This is authenticated so go straight to the homepage
                 return RedirectResponse(self.config.routing.home_path)
-            context['request'] = request
-            if 'login' not in context or context['login'] is None:
+            context['request'] = request  # type: ignore
+            if 'login' not in context or context['login'] is None:  # type: ignore
                 post_redirect = self.oauth_backend.authenticator.pop_post_auth_redirect(request)
-                context['login'] = self.oauth_backend.authenticator.get_login_button(self.config.routing.login_path, post_redirect)
-            return templates.TemplateResponse(template_path.name, context)
+                context['login'] = self.oauth_backend.authenticator.get_login_button(self.config.routing.login_path, post_redirect)  # type: ignore
+            return templates.TemplateResponse(template_path.name, context)  # type: ignore
 
         routes = [Route(self.config.routing.landing_path, endpoint=login, methods=['GET'], name='login'),
-                  Mount(self.config.login_ui.static_path, StaticFiles(directory=self.config.login_ui.static_directory), name='static-login')]
+                  Mount(self.config.login_ui.static_path, StaticFiles(directory=str(self.config.login_ui.static_directory)), name='static-login')]
 
         return routes
 
diff --git a/src/fastapi_aad_auth/config.py b/src/fastapi_aad_auth/config.py
index 77a55b1..b6a1a32 100644
--- a/src/fastapi_aad_auth/config.py
+++ b/src/fastapi_aad_auth/config.py
@@ -19,11 +19,9 @@ def list_from_env(env_value):
         env_value = [u for u in env_value.split(',') if u]
     return env_value
 
-from typing import Any, List, Dict
-
 
 def expand_doc(klass):
-    """Expand pydantic model documentation to enable autodoc"""
+    """Expand pydantic model documentation to enable autodoc."""
     docs = ['', '', 'Keyword Args:']
     for name, field in klass.__fields__.items():
         default_str = ''
@@ -32,7 +30,7 @@ def expand_doc(klass):
         module = field.outer_type_.__module__
         if module != 'builtins':
             if hasattr(field.outer_type_, '__origin__'):
-                    type_ = f' ({field.outer_type_.__origin__.__name__}) '
+                type_ = f' ({field.outer_type_.__origin__.__name__}) '
             elif not hasattr(field.outer_type_, '__name__'):
                 type_ = ''
             else:
diff --git a/src/fastapi_aad_auth/errors.py b/src/fastapi_aad_auth/errors.py
index 767f83a..1caffd7 100644
--- a/src/fastapi_aad_auth/errors.py
+++ b/src/fastapi_aad_auth/errors.py
@@ -1,4 +1,37 @@
 """fastapi_aad_auth errors."""
+import logging
+
+from starlette.responses import JSONResponse, Response
+
+
+logger = logging.getLogger(__name__)
+
+def base_error_handler(request, exception, error_type, error_message, templates, template_path, context=None, status_code=500):
+    if context is None:
+        context = {}
+    logger.warning(f'Handling error {exception}')
+    status_code = 500
+    if any([u in request.headers['user-agent'] for u in ['Mozilla', 'Gecko', 'Trident', 'WebKit', 'Presto', 'Edge', 'Blink']]):
+        logger.info('Interactive environment so returning error template')
+        logger.debug(f'Path: {template_path}')
+        error_context = context.copy()
+        error_context.update({'error': str(exception),
+                                'status_code': str(status_code),
+                                'error_type': error_type,
+                                'error_description': error_message,
+                                'request': request})  # type: ignore
+        response = templates.TemplateResponse(template_path.name,
+                                                error_context,
+                                                status_code=status_code)
+    else:
+        logger.info('Non-Interactive environment so returning JSON message')
+
+        response = JSONResponse(   # type: ignore
+            status_code=status_code,
+            content={"message": error_message}
+        )
+    logger.debug(f'Response {response}')
+    return response
 
 
 class ConfigurationError(Exception):
diff --git a/src/fastapi_aad_auth/oauth/aad.py b/src/fastapi_aad_auth/oauth/aad.py
index 1d1ff12..f7cacf3 100644
--- a/src/fastapi_aad_auth/oauth/aad.py
+++ b/src/fastapi_aad_auth/oauth/aad.py
@@ -24,7 +24,7 @@ def __init__(
             redirect_path: str = '/login/oauth/redirect',
             prompt: Optional[str] = None,
             client_secret: Optional[str] = None,
-            scopes: Optional[str] = None,
+            scopes: Optional[List[str]] = None,
             enabled: bool = True,
             client_app_ids: Optional[List[str]] = None,
             strict_token: bool = True,
@@ -78,12 +78,12 @@ def from_config(cls, config: Config, user_klass: type = User):
                                                  config.auth_session.salt.get_secret_value())
         client_secret = config.aad.client_secret
         if client_secret is not None:
-            client_secret = client_secret.get_secret_value()
+            client_secret = client_secret.get_secret_value()  # type: ignore
 
         return cls(session_serializer=auth_serializer, client_id=config.aad.client_id.get_secret_value(),
                    tenant_id=config.aad.tenant_id.get_secret_value(),
                    redirect_path=config.routing.login_redirect_path,
-                   client_secret=client_secret, enabled=config.enabled,
+                   client_secret=client_secret, enabled=config.enabled,   # type: ignore
                    scopes=config.aad.scopes, client_app_ids=config.aad.client_app_ids,
                    strict_token=config.aad.strict, api_audience=config.aad.api_audience,
                    prompt=config.aad.prompt, domain_hint=config.aad.domain_hint,
diff --git a/src/fastapi_aad_auth/oauth/validators/session.py b/src/fastapi_aad_auth/oauth/validators/session.py
index 8e9073a..bb18c10 100644
--- a/src/fastapi_aad_auth/oauth/validators/session.py
+++ b/src/fastapi_aad_auth/oauth/validators/session.py
@@ -22,7 +22,7 @@ class SessionValidator:
     def __init__(self, session_serializer: URLSafeSerializer, *args, **kwargs):
         """Initialise validator for session based authentication."""
         self._session_serializer = session_serializer
-        super().__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)  # type: ignore
 
     def get_state_from_session(self, request):
         """Get the session from the request."""
diff --git a/src/fastapi_aad_auth/oauth/validators/token.py b/src/fastapi_aad_auth/oauth/validators/token.py
index bb88c35..6877e35 100644
--- a/src/fastapi_aad_auth/oauth/validators/token.py
+++ b/src/fastapi_aad_auth/oauth/validators/token.py
@@ -153,6 +153,7 @@ def __init__(self,
 
     def _get_ms_jwk(self, token):
         try:
+            logger.info(f'Getting signing keys from {self.key_url}')
             jwks = requests.get(self.key_url).json()
             token_header = token.split(".")[0].encode()
             unverified_header = extract_header(token_header, jwt_errors.DecodeError)
@@ -167,10 +168,15 @@ def _get_ms_jwk(self, token):
     def _decode_token(self, token):
         jwk_ = self._get_ms_jwk(token)
         claims = None
+        logger.debug(f'Key is {jwk_}')
         try:
+            if hasattr(jwk, 'public_bytes'):
+                public_bytes = jwk_.public_bytes(serialization.Encoding.PEM, serialization.PublicFormat.PKCS1)
+            else:
+                public_bytes = jwk_.raw_key.public_bytes(serialization.Encoding.PEM, serialization.PublicFormat.PKCS1)
             claims = jwt.decode(
                 token,
-                jwk_.public_bytes(serialization.Encoding.PEM, serialization.PublicFormat.PKCS1),
+                public_bytes,
             )
         except Exception:
             logger.exception('Unable to parse error')
@@ -182,6 +188,7 @@ def _validate_claims(self, claims, options=None):
             options = self._claims_options
         # We need to do some 1.0/2.0 handling because it doesn't seem to work properly
         # TODO: validate whether we want this claim here?
+        # TODO: validate whether the 
         if 'appid' in options and 'azp' in options:
             if 'appid' not in claims:
                 options.pop('appid')
diff --git a/src/fastapi_aad_auth/ui/error.html b/src/fastapi_aad_auth/ui/error.html
index 1e70bbb..c48c5a8 100644
--- a/src/fastapi_aad_auth/ui/error.html
+++ b/src/fastapi_aad_auth/ui/error.html
@@ -5,8 +5,8 @@
         <meta charset="UTF-8">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <meta name="viewport" content="width=device-width, initial-scale=1">
-        <link href="/{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
-        <link rel="stylesheet" href="/{{static_path}}/css/cover.css">
+        <link href="{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
+        <link rel="stylesheet" href="{{static_path}}/css/cover.css">
         <link rel="icon" type="img/ipng" href="/static/img/favicon.png" />
         <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" >
         <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
diff --git a/src/fastapi_aad_auth/ui/login.html b/src/fastapi_aad_auth/ui/login.html
index 1345430..87874b2 100644
--- a/src/fastapi_aad_auth/ui/login.html
+++ b/src/fastapi_aad_auth/ui/login.html
@@ -5,8 +5,8 @@
         <meta charset="UTF-8">
         <meta http-equiv="X-UA-Compatible" content="IE=edge">
         <meta name="viewport" content="width=device-width, initial-scale=1">
-        <link href="/{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
-        <link rel="stylesheet" href="/{{static_path}}/css/cover.css">
+        <link href="{{static_path}}/css/bootstrap.min.css" rel="stylesheet">
+        <link rel="stylesheet" href="{{static_path}}/css/cover.css">
         <link rel="icon" type="img/ipng" href="/static/img/favicon.png" />
         <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" >
         <script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
diff --git a/tox.ini b/tox.ini
index 04e3455..e9a9573 100644
--- a/tox.ini
+++ b/tox.ini
@@ -14,10 +14,14 @@ deps =
     test,develop: pytest
     test,develop: pytest-cov
     test,develop: tox
-    docs: sphinx
-    docs: sphinx_rtd_theme
-    docs: sphinx_github_changelog
-    build: wheel
+    cq,develop: pylint
+    types,develop: mypy
+    types,develop: lxml
+    security,develop: bandit
+    docs,develop: sphinx
+    docs,develop: sphinx_rtd_theme
+    docs,develop: sphinx_github_changelog
+    build,develop: wheel
 
 commands = 
     lint: flake8 src/
@@ -27,7 +31,12 @@ commands =
     build: python setup.py sdist --format=zip
     build: python setup.py sdist --format=gztar
     build: python setup.py bdist_wheel
-
+    security: python -c "import os; a = 1 if os.path.exists('reports') else os.makedirs('reports')"
+    security: bandit -r src/ --format xml --output reports/security-results.xml -x *_version.py
+    security: bandit -r src/  -x *_version.py
+    types: python -c "import os; a = 1 if os.path.exists('reports') else os.makedirs('reports')"
+    types: mypy -p fastapi_aad_auth --linecoverage-report reports --junit-xml reports/mypy.xml --cobertura-xml-report test-reports
+    
 passenv =
     docs: SPHINX_GITHUB_CHANGELOG_TOKEN 
     

From 108183149ccdf7782f7a3d931bd96d21e123f618 Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 19:22:34 +0100
Subject: [PATCH 7/8] Updating todo

---
 src/fastapi_aad_auth/oauth/validators/token.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/fastapi_aad_auth/oauth/validators/token.py b/src/fastapi_aad_auth/oauth/validators/token.py
index 6877e35..abfb2f3 100644
--- a/src/fastapi_aad_auth/oauth/validators/token.py
+++ b/src/fastapi_aad_auth/oauth/validators/token.py
@@ -188,7 +188,7 @@ def _validate_claims(self, claims, options=None):
             options = self._claims_options
         # We need to do some 1.0/2.0 handling because it doesn't seem to work properly
         # TODO: validate whether we want this claim here?
-        # TODO: validate whether the 
+        # TODO: validate whether the user is approved for the app
         if 'appid' in options and 'azp' in options:
             if 'appid' not in claims:
                 options.pop('appid')

From 8be05862a8ffb988b61a44f2a8b44573468d860d Mon Sep 17 00:00:00 2001
From: David Pugh <djpugh@gmail.com>
Date: Sun, 18 Oct 2020 19:25:52 +0100
Subject: [PATCH 8/8] Working on lint

---
 .github/workflows/pipeline.yml | 32 ++++++++++++++++++++++++++++++++
 src/fastapi_aad_auth/auth.py   |  5 ++---
 src/fastapi_aad_auth/errors.py | 16 +++++++++-------
 3 files changed, 43 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/pipeline.yml b/.github/workflows/pipeline.yml
index 71d7d61..e66d5f8 100644
--- a/.github/workflows/pipeline.yml
+++ b/.github/workflows/pipeline.yml
@@ -21,6 +21,34 @@ jobs:
           pip install tox
       - name: Lint
         run: tox -e lint
+  
+  security:
+    name: Security Lint
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+      - name: Lint with Bandit
+        run: tox -e security
+
+  types:
+    name: Check Types
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+      - name: Check Types
+        run: tox -e types
 
   test:
     name: Test Python ${{ matrix.py }} - ${{ matrix.os }}
@@ -207,6 +235,8 @@ jobs:
     runs-on: ubuntu-latest
     needs: 
       - lint
+      - security
+      - types
       - test
       - build
       - license-scan
@@ -230,6 +260,8 @@ jobs:
     runs-on: ubuntu-latest
     needs: 
       - lint
+      - security
+      - types
       - test
       - build
       - sonarcloud
diff --git a/src/fastapi_aad_auth/auth.py b/src/fastapi_aad_auth/auth.py
index 7c16734..c2e8b2f 100644
--- a/src/fastapi_aad_auth/auth.py
+++ b/src/fastapi_aad_auth/auth.py
@@ -9,7 +9,7 @@
 from starlette.middleware.authentication import AuthenticationError, AuthenticationMiddleware
 from starlette.middleware.sessions import SessionMiddleware
 from starlette.requests import Request
-from starlette.responses import JSONResponse, RedirectResponse, Response
+from starlette.responses import RedirectResponse, Response
 from starlette.routing import Mount, request_response, Route
 from starlette.staticfiles import StaticFiles
 from starlette.templating import Jinja2Templates
@@ -106,9 +106,8 @@ async def configuration_error_handler(request: Request, exc: ConfigurationError)
             status_code = 500
             return base_error_handler(request, exc, error_type, error_message, error_templates, error_template_path, context=context.copy(), status_code=status_code)
 
-
         @app.exception_handler(AuthenticationError)
-        async def configuration_error_handler(request: Request, exc: AuthenticationError) -> Response:
+        async def authentication_error_handler(request: Request, exc: AuthenticationError) -> Response:
             error_message = "Oops! It seems like you cannot access this information. If this is an error, please contact an admin"
             error_type = 'Authentication Error'
             status_code = 403
diff --git a/src/fastapi_aad_auth/errors.py b/src/fastapi_aad_auth/errors.py
index 1caffd7..0bb2419 100644
--- a/src/fastapi_aad_auth/errors.py
+++ b/src/fastapi_aad_auth/errors.py
@@ -6,7 +6,9 @@
 
 logger = logging.getLogger(__name__)
 
-def base_error_handler(request, exception, error_type, error_message, templates, template_path, context=None, status_code=500):
+
+def base_error_handler(request, exception, error_type, error_message, templates, template_path, context=None, status_code=500) -> Response:
+    """Handle Error as JSON or HTML response depending on request type."""
     if context is None:
         context = {}
     logger.warning(f'Handling error {exception}')
@@ -16,13 +18,13 @@ def base_error_handler(request, exception, error_type, error_message, templates,
         logger.debug(f'Path: {template_path}')
         error_context = context.copy()
         error_context.update({'error': str(exception),
-                                'status_code': str(status_code),
-                                'error_type': error_type,
-                                'error_description': error_message,
-                                'request': request})  # type: ignore
+                              'status_code': str(status_code),
+                              'error_type': error_type,
+                              'error_description': error_message,
+                              'request': request})  # type: ignore
         response = templates.TemplateResponse(template_path.name,
-                                                error_context,
-                                                status_code=status_code)
+                                              error_context,
+                                              status_code=status_code)
     else:
         logger.info('Non-Interactive environment so returning JSON message')