aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFrederick Muriuki Muriithi2023-08-31 07:40:10 +0300
committerFrederick Muriuki Muriithi2023-08-31 07:40:10 +0300
commit09d9c0c6140fdca183703c96a65a570eec3c8573 (patch)
tree0ec0c3ffedff139d4a71d5fc4cc0173b80c58a15 /README.md
parent4811c56d8467a1373106f5f7b0c9f38149067b19 (diff)
downloadgn-auth-09d9c0c6140fdca183703c96a65a570eec3c8573.tar.gz
Add documentation on troubleshooting tokens
Diffstat (limited to 'README.md')
-rw-r--r--README.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/README.md b/README.md
index bd38f98..9d11a50 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,14 @@ variable of the same name as the variable you wish to override.
| `AUTH_MIGRATIONS` | Migrations | Relative (to the repo root) path to the migration scripts for the auth(entic/oris)ation database |
| `OAUTH2_SCOPE` | Supported OAuth2 scope for the application. |
+There are a few other variables we can set, if we want to customise, or troubleshoot token generation. These are:
+
+| Variable | Used By/For | Description |
+| ---- | ---- | ---- |
+| `OAUTH2_ACCESS_TOKEN_GENERATOR` | Generating new access tokens. | A string value that points to the function that generates the access token. e.g. `OAUTH2_ACCESS_TOKEN_GENERATOR='the_project.tokens.generate_token'`. |
+| `OAUTH2_REFRESH_TOKEN_GENERATOR` | Generating refresh tokens. | Similar to the `OAUTH2_ACCESS_TOKEN_GENERATOR` setting above, except this setting relates to the refresh token. |
+| `OAUTH2_TOKEN_EXPIRES_IN` | Limiting token expiry time. | This can be set to limit the amount of time a token is valid for. It can be a dict object or import string. |
+
## Installation
The recommended way to install the application is using GNU Guix[^gnu-guix]. You