Se connecter avec AutonomousRelay

Un point d’accès /v1 pour tous les fournisseurs. Pointez votre client OpenAI vers une autre URL et une clé, avec vos clés et 0 % de majoration.

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.

Une connexion ne donne jamais de clé API à votre application : elle ne peut utiliser ni les crédits, ni les modèles, ni les clés de la personne. Un propriétaire ou un administrateur inscrit les applications. Tant qu’AutonomousRelay n’a pas examiné une application, seuls les membres de l’organisation qui l’a inscrite peuvent s’y connecter.

É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. https seulement, sauf http://localhost et http://127.0.0.1 sur 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 que client_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 :

http
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, nonce et PKCE (code_challenge_method=S256) sont obligatoires, y compris pour les applications serveur.
  • prompt peut valoir none, login, consent ou select_account; max_age et login_hint sont pris en charge.
  • Avec prompt=none, une personne non connectée, ou qui n’a pas approuvé votre application, revient avec error=login_required ou error=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
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"
json
{
  "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. Aussi auth_time et amr (fed pour Google ou GitHub, sso pour le fournisseur d’identité de l’organisation, wallet).
  • email : email et email_verified, seulement si l’adresse est vérifiée. Sinon, ni l’un ni l’autre n’est envoyé.
  • profile : name et picture, si la personne en a.
  • org : l’organisation que la personne choisit à l’écran de connexion : org_id, org_name et org_role (owner, admin ou member).

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
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.
  • 400 invalid_grant signifie 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.