Se connecter avec AutonomousRelay permet aux gens de se connecter à votre application avec leur compte AutonomousRelay. C’est du OpenID Connect standard (le flux par code d’autorisation avec PKCE) : toute bibliothèque OpenID Connect convient. Votre application apprend qui est la personne et, si elle accepte, à quelle organisation elle appartient et son rôle dans celle-ci.
Étape 1 : Inscrire votre application
Dans Applications de connexion, sélectionnez Inscrire une application et remplissez :
- Nom : affiché à l’écran de connexion, avec le nom de votre organisation en dessous. Jusqu’à 60 caractères.
- Type d’application : une application serveur conserve un secret client sur un serveur; une application Web ou mobile ne peut pas en garder et se connecte avec PKCE seulement. Ce choix est définitif.
- Adresses de redirection : jusqu’à 10, comparées exactement, sans caractères génériques.
httpsseulement, saufhttp://localhostethttp://127.0.0.1sur tout port, pour le développement. - Page d’accueil, Adresse du logo et Politique de confidentialité : facultatives au départ, exigées pour l’examen.
Vous obtenez un identifiant client (arc_…, public) et, pour une application serveur, un secret client (arcs_…). Le secret n’est affiché qu’une seule fois : nous n’en conservons qu’un hachage. Nouveau secreten crée un autre, et l’ancien reste valide 24 heures, le temps de déployer le nouveau.
Étape 2 : Configurer votre bibliothèque
Configurez votre bibliothèque OpenID Connect avec :
- Émetteur :
https://autonomousrelay.com - Découverte :
https://autonomousrelay.com/.well-known/openid-configuration - Votre identifiant client et, pour une application serveur, le secret. Le point de terminaison des jetons l’accepte en HTTP Basic (
client_secret_basic) ou dans le formulaire (client_secret_post); une application Web ou mobile n’envoie queclient_id(none).
La plupart des bibliothèques lisent le reste dans la découverte. Pour référence, les points de terminaison sont :
- Autorisation :
https://autonomousrelay.com/auth - Jetons :
https://autonomousrelay.com/v1/oauth/token - Userinfo :
https://autonomousrelay.com/v1/oauth/userinfo - Révocation :
https://autonomousrelay.com/v1/oauth/revoke - Clés de signature :
https://autonomousrelay.com/v1/oauth/jwks
Étape 3 : Envoyer les gens se connecter
Redirigez le navigateur vers le point de terminaison d’autorisation :
GET https://autonomousrelay.com/auth ?response_type=code &client_id=arc_YOUR_CLIENT_ID &redirect_uri=https://app.example.com/callback &scope=openid email profile org &state=RANDOM_STATE &nonce=RANDOM_NONCE &code_challenge=BASE64URL_SHA256_OF_VERIFIER &code_challenge_method=S256
state,nonceet PKCE (code_challenge_method=S256) sont obligatoires, y compris pour les applications serveur.promptpeut valoirnone,login,consentouselect_account;max_ageetlogin_hintsont pris en charge.- Avec
prompt=none, une personne non connectée, ou qui n’a pas approuvé votre application, revient avecerror=login_requiredouerror=consent_required.
La personne voit ce que votre application recevra et choisit de continuer ou non. Si elle l’a déjà approuvée pour les mêmes portées, et que le nom et le logo de votre application n’ont pas changé, elle passe directement. Elle revient à votre adresse de redirection avec code, votre state et iss. Vérifiez que state est le vôtre et que iss vaut https://autonomousrelay.com.
Étape 4 : Échanger le code
Le code ne sert qu’une fois, pendant 60 secondes :
curl -sS -X POST https://autonomousrelay.com/v1/oauth/token \ -u "$CLIENT_ID:$CLIENT_SECRET" \ -d grant_type=authorization_code \ -d code="$CODE" \ -d redirect_uri=https://app.example.com/callback \ -d code_verifier="$VERIFIER"
{
"id_token": "eyJ...",
"access_token": "ar-oidc-...",
"token_type": "Bearer",
"expires_in": 300,
"refresh_token": "ar-rt-...",
"scope": "openid email profile org"
}Vérifiez le id_token comme le fait votre bibliothèque : signé en ES256 par une clé de notre JWKS, iss vaut https://autonomousrelay.com, aud est votre identifiant client, il n’est pas expiré (il dure 5 minutes) et nonce est celui que vous avez envoyé.
Portées et revendications
openid(obligatoire) :sub, l’identifiant de la personne. Il ne change jamais; utilisez-le, plutôt que le courriel, comme clé de compte. Aussiauth_timeetamr(fedpour Google ou GitHub,ssopour le fournisseur d’identité de l’organisation,wallet).email:emailetemail_verified, seulement si l’adresse est vérifiée. Sinon, ni l’un ni l’autre n’est envoyé.profile:nameetpicture, si la personne en a.org: l’organisation que la personne choisit à l’écran de connexion :org_id,org_nameetorg_role(owner,adminoumember).
Les mêmes revendications sont offertes au point de terminaison userinfo, avec le jeton d’accès en Authorization: Bearer. Un jeton d’accès dure 5 minutes et ne sert qu’à cet endroit; toutes les autres routes de l’API le refusent.
Jetons de renouvellement
Chaque échange de code renvoie un jeton de renouvellement. Échangez-le contre de nouveaux jetons :
curl -sS -X POST https://autonomousrelay.com/v1/oauth/token \ -u "$CLIENT_ID:$CLIENT_SECRET" \ -d grant_type=refresh_token \ -d refresh_token="$REFRESH_TOKEN"
- Chaque renouvellement renvoie un nouveau jeton de renouvellement; gardez-le et jetez l’ancien. Réutiliser un ancien jeton révoque toute la connexion.
- Un jeton de renouvellement expire après 30 jours sans usage, et une connexion dure au plus 90 jours depuis le début. La personne se reconnecte ensuite.
- Un renouvellement revérifie aussi la personne : son appartenance à l’organisation, son rôle et son nom sont à jour dans le nouveau jeton d’identité, qui n’a pas de
nonce. 400invalid_grantsignifie que la connexion est terminée (la personne a révoqué votre application, a quitté l’organisation, ou l’organisation a bloqué votre application). Déconnectez la personne de votre application.
Pour déconnecter quelqu’un, révoquez son jeton de renouvellement à https://autonomousrelay.com/v1/oauth/revoke avec token= et vos identifiants client. La réponse est 200 dans tous les cas, et met fin à tous les jetons de cette connexion.
Examen et badge Vérifiée
Pour permettre à toute personne ayant un compte AutonomousRelay de se connecter, sélectionnez Soumettre à l’examen. L’application doit avoir un logo, une page d’accueil et une politique de confidentialité, et aucune adresse de redirection localhost. Notre personnel vérifie que votre organisation est réelle, que le nom et le logo n’imitent personne, que la page d’accueil et la politique de confidentialité s’affichent, et que chaque adresse de redirection est sur un domaine que vous contrôlez. Une application vérifiée affiche un badge Vérifiée à l’écran de connexion.
Si des modifications sont demandées, la note figure sur votre page Applications de connexion; corrigez l’application et soumettez-la de nouveau. Changer le nom ou le logo d’une application vérifiée, ou ajouter une adresse de redirection sur un nouveau domaine, la renvoie d’elle-même à l’examen. D’ici l’approbation, les personnes hors de votre organisation voient le dernier nom et le dernier logo vérifiés et ne peuvent utiliser que les adresses de redirection vérifiées : les connexions continuent de fonctionner.
Ce que contrôlent les personnes et les organisations
- Une personne voit chaque application à laquelle elle s’est connectée sous Paramètres → Applications auxquelles vous vous êtes connecté, et peut en révoquer une : ses jetons de renouvellement cessent aussitôt de fonctionner et userinfo répond
401. - Un propriétaire ou un administrateur voit les applications auxquelles les membres ont partagé l’organisation, et combien de membres (jamais lesquels), sous Applications de connexion → Applications utilisées par vos membres. Bloquer une application lui retire immédiatement l’accès à l’organisation.
- Désactiver votre application arrête aussitôt les nouvelles connexions; Supprimer met aussi fin aux codes déjà émis.