Garder vos applications disponibles pendant une panne de connexion
Mettez en cache le document de découverte et les clés de signature de Scrydon comme Scrydon vous l'indique, pour que vos applications continuent d'accepter les jetons qu'elles détiennent déjà quand la connexion est brièvement indisponible.
Votre application fait deux choses différentes avec Scrydon :
- Elle envoie les personnes se connecter, puis échange le code contre des jetons. Cela demande que Scrydon réponde, à chaque fois.
- Elle vérifie les jetons qu'elle détient déjà, à chaque requête. Cela ne demande que le document de découverte de Scrydon et ses clés de signature (le JWKS), et les deux peuvent être mis en cache.
Si votre application les met en cache comme décrit ici, une personne déjà connectée continue de travailler pendant que la connexion à Scrydon est indisponible. Seules les nouvelles connexions et les renouvellements de jetons attendent son retour.
Ce que Scrydon indique à votre cache
Scrydon envoie un en-tête Cache-Control avec chaque réponse réussie :
| Document | URL | Cache-Control |
|---|---|---|
| Découverte OIDC | <issuer>/.well-known/openid-configuration | public, max-age=3600, stale-if-error=86400 |
| Métadonnées du serveur d'autorisation | <issuer>/.well-known/oauth-authorization-server | public, max-age=3600, stale-if-error=86400 |
| Clés de signature | <issuer>/jwks (le jwks_uri de la découverte) | public, max-age=600, stale-if-error=86400 |
<issuer> vaut https://<auth host>/api/auth, ou
l'émetteur de votre organisation
https://<auth host>/api/auth/o/<organization id>. Les deux envoient les
mêmes en-têtes.
max-ageest la durée pendant laquelle une copie est fraîche : une heure pour la découverte, dix minutes pour les clés.stale-if-error=86400permet à votre cache de continuer à utiliser une copie expirée pendant un jour au plus lorsque Scrydon répond par une erreur ou ne répond pas du tout.
Une réponse d'erreur ne porte jamais ces en-têtes : votre cache n'en stocke donc jamais.
Ce qu'il faut configurer dans votre application
- Mettez en cache la découverte et le JWKS au lieu de les récupérer à
chaque requête. La plupart des bibliothèques OIDC et JWT le font déjà ;
vérifiez que la vôtre respecte le
Cache-Controldu serveur, ou réglez les mêmes durées à la main. - Gardez la dernière bonne copie quand un rafraîchissement échoue. Si
votre bibliothèque ne gère pas
stale-if-error, gardez le JWKS précédent en mémoire et utilisez-le jusqu'à ce qu'un rafraîchissement réussisse, pendant un jour au plus. - Récupérez le JWKS une fois quand un jeton désigne une clé que vous
n'avez pas (un
kidinconnu). Scrydon commence à signer avec une nouvelle clé sans l'annoncer à l'avance, c'est pourquoi lemax-agedes clés n'est que de dix minutes. Récupérez-le au plus une fois parkidinconnu, pas à chaque requête. - Ne mettez pas en cache les réponses du point de terminaison token, d'authorize ou de userinfo. Elles sont propres à chaque personne et à chaque requête.
Ce qui reste indisponible pendant une panne
| Vérifier un jeton que votre application détient déjà | Continue de fonctionner, avec les clés en cache |
| Une personne qui se connecte à votre application | Attend Scrydon |
| Renouveler un jeton | Attend Scrydon. Laissez la personne travailler jusqu'à l'expiration du jeton d'accès, et réessayez le renouvellement avec un délai croissant. |
| Appeler userinfo | Attend Scrydon. Si votre application n'a besoin des revendications qu'à la connexion, lisez-les plutôt dans le jeton d'identité. |
Limites de débit
| Point de terminaison | Limite |
|---|---|
Jeton (/oauth2/token) | 600 requêtes réussies par minute par application (identifiant client), depuis n'importe quelle adresse. Les requêtes en échec sont limitées à 20 par minute par adresse IP. |
| JWKS et découverte | 1 000 requêtes par tranche de 10 secondes par adresse IP |
| Connexion et autorisation | Par adresse IP, dimensionnées contre la devinette de mots de passe |
Les limites sont comptées sur chaque réplique de Scrydon. Une requête refusée
reçoit 429 Too Many Requests avec un en-tête Retry-After en secondes ; le
corps renvoyé par le point de terminaison de jeton est
{"error": "temporarily_unavailable"}. Attendez ce délai, puis réessayez.
Un JWKS en cache reste très en dessous de sa limite. Une application ou un proxy qui récupère le JWKS ou la découverte à chaque requête peut tout de même se voir refuser. La mise en cache décrite ci-dessus l'évite.