Sur cette page
Authentification unique (SSO)
Patrii Cloud peut agir comme fournisseur d'identité OpenID Connect (OIDC) et OAuth2, ce qui vous permet de vous connecter à d'autres applications avec votre compte Patrii Cloud et de brancher des intégrations en toute sécurité.
Lorsque Patrii Cloud est votre fournisseur d'identité, vos utilisateurs s'authentifient une seule fois auprès de Patrii Cloud et votre application reçoit des jetons standards décrivant leur identité. Il n'y a pas de mot de passe distinct à gérer dans chaque application.
La mise en œuvre suit les normes OpenID Connect et OAuth2; elle fonctionne donc d'emblée avec les bibliothèques d'identité courantes. Votre application lit le document de découverte pour connaître les points d'accès d'autorisation, de jetons, d'information utilisateur et de clés, et valide les jetons à l'aide des clés publiées.
Concepts clés
Fournisseur d'identité (IdP) — Le service qui authentifie les utilisateurs et émet des jetons; ici, Patrii Cloud.
OpenID Connect — Une couche d'identité par-dessus OAuth2 qui retourne un jeton d'identité vérifiable sur l'utilisateur.
Document de découverte — Une URL bien connue qui liste tous les points d'accès et réglages OIDC pour une configuration automatique.
Écran de consentement — La page où un utilisateur approuve la demande d'une application d'utiliser son identité.
JWKS — L'ensemble publié de clés publiques que votre application utilise pour vérifier la signature des jetons émis.
Avant de commencer
- Une application qui prend en charge OpenID Connect ou OAuth2.
- Les identifiants client émis par Patrii Cloud pour votre application.
- Une URL de redirection dans votre application pour recevoir le résultat de la connexion.
Étape par étape
- Lisez le document de découverte
Pointez votre application vers l'URL de découverte OIDC pour configurer automatiquement les points d'accès d'autorisation, de jetons, d'information utilisateur et JWKS.
- Configurez votre application
- Définissez vos identifiants client et votre URL de redirection.
- Demandez les portées dont votre application a besoin (par exemple openid, profile, email).
- Envoyez les utilisateurs se connecter
Redirigez les utilisateurs vers le point d'accès d'autorisation; ils s'authentifient auprès de Patrii Cloud et approuvent l'écran de consentement.
Capture d'écran — Un utilisateur approuvant l'écran de consentementUn utilisateur approuvant l'écran de consentement - Échangez le code contre des jetons
Votre application échange le code d'autorisation retourné au point d'accès de jetons contre un jeton d'identité et un jeton d'accès.
- Lisez l'utilisateur et vérifiez les jetons
Appelez le point d'accès d'information utilisateur pour les détails du profil, et validez les signatures des jetons à l'aide des clés JWKS.
Exemples
curl https://api.patrii.cloud/oauth2/.well-known/openid-configuration
curl https://api.patrii.cloud/oauth2/jwks
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ https://api.patrii.cloud/oauth2/userinfo
Limites et caractéristiques
Points d'accès OIDC / OAuth2 standards :
| Point d'accès | Rôle |
|---|---|
/oauth2/.well-known/openid-configuration | Document de découverte listant tous les points d'accès. |
/oauth2/authorize | Où les utilisateurs se connectent et donnent leur consentement. |
/oauth2/token | Échanger le code d'autorisation contre des jetons. |
/oauth2/userinfo | Retourner le profil de l'utilisateur authentifié. |
/oauth2/jwks | Clés publiques servant à vérifier les signatures des jetons. |
Bonnes pratiques
- Utilisez le document de découverte plutôt que de coder en dur les points d'accès, afin que votre application continue de fonctionner s'ils changent.
- Ne demandez que les portées dont votre application a réellement besoin.
- Validez toujours les signatures des jetons à l'aide des clés JWKS avant de faire confiance à un jeton.
- Gardez votre secret client confidentiel et hors du contrôle de version.
Questions fréquentes
Quelles normes Patrii Cloud prend-il en charge ?
Comment mon application connaît-elle les points d'accès ?
Puis-je automatiser l'API sans connexion par navigateur ?
Pour aller plus loin
Tout ce que vous faites ici dans la console est aussi disponible via l'API Patrii Cloud pour l'automatisation et les scripts.