Se rendre au contenu
Open Beta — managed Kubernetes, DNS & more are live.
🎫

Authentification unique (SSO)

Updated 2026-11-20
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.

Capture d'écran — L'écran de consentement qu'un utilisateur voit lorsqu'une application tierce demande l'accès à son identité Patrii Cloud
L'écran de consentement qu'un utilisateur voit lorsqu'une application tierce demande l'accès à son identité Patrii Cloud

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

  1. 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.

  2. 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).
  3. 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 consentement
    Un utilisateur approuvant l'écran de consentement
  4. É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.

  5. 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

Récupérer le document de découverte OIDC
curl https://api.patrii.cloud/oauth2/.well-known/openid-configuration
Récupérer les clés de signature (JWKS)
curl https://api.patrii.cloud/oauth2/jwks
Obtenir le profil de l'utilisateur connecté
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èsRôle
/oauth2/.well-known/openid-configurationDocument de découverte listant tous les points d'accès.
/oauth2/authorizeOù les utilisateurs se connectent et donnent leur consentement.
/oauth2/tokenÉchanger le code d'autorisation contre des jetons.
/oauth2/userinfoRetourner le profil de l'utilisateur authentifié.
/oauth2/jwksClé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 ?
Patrii Cloud met en œuvre OpenID Connect et OAuth2, avec des points d'accès standards de découverte, d'autorisation, de jetons, d'information utilisateur et JWKS.
Comment mon application connaît-elle les points d'accès ?
Lisez le document de découverte à l'URL bien connue; il liste chaque point d'accès, de sorte que la plupart des bibliothèques se configurent automatiquement.
Puis-je automatiser l'API sans connexion par navigateur ?
Oui. Pour les scripts et services, utilisez des identifiants d'application pour vous authentifier directement plutôt que le flux de connexion interactif.

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.

Cet article vous a-t-il été utile?
Merci de votre rétroaction. Toujours bloqué? Écrivez-nous