latest rohe's OIDC certification improvements and FAPI OP example pro…

…ject

.gitignore

@@ -4,6 +4,7 @@ conf.yaml
 flask_op/debug.log
 flask_op/static/
 debug.log
+.pytest_cache/
 # Created by .ignore support plugin (hsz.mobi)
 ### Python template
 # Byte-compiled / optimized / DLL files

docs/source/conf.py

@@ -13,7 +13,7 @@
 # import os
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
-from recommonmark.parser import CommonMarkParser
+# from recommonmark.parser import CommonMarkParser
 
 # -- Project information -----------------------------------------------------
 

docs/source/contents/clients.rst

@@ -0,0 +1,75 @@
+********************
+The clients database
+********************
+
+Information kept about clients in the client database are to begin with the
+client metadata as defined in
+https://openid.net/specs/openid-connect-registration-1_0.html .
+
+To that we have the following additions specified in OIDC extensions.
+
+* https://openid.net/specs/openid-connect-rpinitiated-1_0.html
+    + post_logout_redirect_uri
+* https://openid.net/specs/openid-connect-frontchannel-1_0.html
+    + frontchannel_logout_uri
+    + frontchannel_logout_session_required
+* https://openid.net/specs/openid-connect-backchannel-1_0.html#Backchannel
+    + backchannel_logout_uri
+    + backchannel_logout_session_required
+* https://openid.net/specs/openid-connect-federation-1_0.html#rfc.section.3.1
+    + client_registration_types
+    + organization_name
+    + signed_jwks_uri
+
+And finally we add a number of parameters that are OidcOP specific.
+These are described in this document.
+
+--------------
+allowed_scopes
+--------------
+
+Which scopes that can be returned to a client. This is used to filter
+the set of scopes a user can authorize release of.
+
+-----------------
+token_usage_rules
+-----------------
+
+There are usage rules for tokens. Rules are set per token type (the basic set is
+authorization_code, refresh_token, access_token and id_token).
+The possible rules are:
+
++ how many times they can be used
++ if other tokens can be minted based on this token
++ how fast they expire
+
+A typical example (this is the default) would be::
+
+    "token_usage_rules": {
+        "authorization_code": {
+            "max_usage": 1
+            "supports_minting": ["access_token", "refresh_token"],
+            "expires_in": 600,
+        },
+        "refresh_token": {
+            "supports_minting": ["access_token"],
+            "expires_in": -1
+        },
+    }
+
+This then means that access_tokens can be used any number of times,
+can not be used to mint other tokens and will expire after 300 seconds
+which is the default for any token. An authorization_code can only used once
+and it can be used to mint access_tokens and refresh_tokens. Note that normally
+an authorization_code is used to mint an access_token and a refresh_token at
+the same time. Such a dual minting is counted as one usage.
+And lastly an refresh_token can be used to mint access_tokens any number of
+times. An *expires_in* of -1 means that the token will never expire.
+
+If token_usage_rules are defined in the client metadata then it will be used
+whenever a token is minted unless circumstances makes the OP modify the rules.
+
+Also this does not mean that what is valid for a token can not be changed
+during run time.
+
+

docs/source/contents/conf.rst

@@ -199,9 +199,9 @@ client_db
 
 If you're running an OP with static client registration you want to keep the
 registered clients in a database separate from the session database since
-it will change independent of the OP process. In this case you need this.
+it will change independent of the OP process. In this case you need *client_db*.
 If you are on the other hand only allowing dynamic client registration then
-keeping registered clients in the session database makes total sense.
+keeping registered clients only in the session database makes total sense.
 
 The class you reference in the specification MUST be a subclass of
 oidcmsg.storage.DictType and have some of the methods a dictionary has.

docs/source/contents/session_management.rst

@@ -481,7 +481,7 @@ add_grant
 +++++++++
 .. _add_grant:
 
-    add_grant(self, user_id, client_id, **kwargs)
+    add_grant(self, user_id, client_id, \*\*kwargs)
 
 find_token
 ++++++++++

docs/source/index.rst

@@ -1,6 +1,10 @@
 Welcome to Idpy OIDC-op Documentation
 ======================================
 
+.. image:: _images/oid-l-certification-mark-l-rgb-150dpi-90mm-300x157.png
+  :width: 300
+  :alt: OIDC Certified
+
 This project is a Python implementation of an **OIDC Provider** on top of `jwtconnect.io <https://jwtconnect.io/>`_
 that shows you how to 'build' an OP using the classes and functions provided by oidc-op.
 
@@ -66,6 +70,12 @@ under the `Apache 2.0 <https://en.wikipedia.org/wiki/Apache_License>`_.
 
    contents/developers.md
 
+.. toctree::
+   :maxdepth: 2
+   :caption: Client database
+
+   contents/clients.rst
+
 .. toctree::
    :maxdepth: 2
    :caption: FAQ