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

Identifiants d'application

Updated 2026-11-20
Sur cette page

Identifiants d'application

Les identifiants d'application permettent aux scripts, pipelines d'intégration continue et outils de s'authentifier à l'API Patrii Cloud sans votre mot de passe personnel. Créez un identifiant limité par intégration et révoquez-le indépendamment.

Un identifiant d'application est une identité à longue durée composée d'un ID et d'un secret. Il est limité au projet actif et porte un ensemble de rôles, de sorte qu'un script agit avec exactement les permissions que vous accordez, et non avec votre accès personnel complet. Les identifiants d'application contournent les invites interactives d'authentification multifacteur, ce qui les rend adaptés à l'automatisation.

Le secret n'est affiché qu'une seule fois, à la création. Vous le stockez dans votre intégration continue ou sur la machine qui exécute le script, et l'utilisez pour obtenir des jetons d'API. Si un identifiant n'est plus nécessaire ou risque d'avoir fuité, vous révoquez uniquement cet identifiant, sans changer votre mot de passe ni perturber les autres intégrations.

Capture d'écran — La page Identifiants d'application listant les identifiants avec leur ID, leurs rôles et leur expiration
La page Identifiants d'application listant les identifiants avec leur ID, leurs rôles et leur expiration

Concepts clés

Identifiant d'application — Un ID et un secret utilisés par l'automatisation pour s'authentifier à l'API.

Secret — La moitié confidentielle, affichée une seule fois à la création et jamais récupérable ensuite.

Portée — Le projet auquel l'identifiant est lié; il ne peut agir hors de ce projet.

Rôles — Les permissions que porte l'identifiant, qui peuvent être plus étroites que les vôtres.

Expiration — Une date facultative après laquelle l'identifiant cesse de fonctionner.

Avant de commencer

  • Le projet dans lequel l'automatisation doit agir est le projet actif.
  • Un endroit pour stocker le secret en toute sécurité (un coffre de secrets d'intégration continue ou le coffre de secrets).
  • Un nom pour l'identifiant qui identifie son intégration.

Étape par étape

  1. Ouvrez les identifiants d'application

    Ouvrez votre compte, ou le menu d'actions d'un projet, et allez dans Identifiants d'application.

    Capture d'écran — La page Identifiants d'application avec le bouton Créer
    La page Identifiants d'application avec le bouton Créer
  2. Créez un identifiant

    Donnez-lui un nom explicite (par exemple my-ci-pipeline), une description facultative et une date d'expiration facultative.

    Capture d'écran — La boîte de dialogue Créer un identifiant d'application
    La boîte de dialogue Créer un identifiant d'application
  3. Copiez le secret une seule fois

    L'ID et le secret de l'identifiant sont affichés une seule fois. Copiez-les, ou téléchargez le fichier .env, et stockez-les dans votre coffre de secrets d'intégration continue. Le secret n'est pas affiché de nouveau.

    Capture d'écran — La boîte de dialogue de création avec le secret à usage unique et le bouton Télécharger le .env
    La boîte de dialogue de création avec le secret à usage unique et le bouton Télécharger le .env
  4. Utilisez-le dans l'automatisation

    Définissez l'ID et le secret comme variables d'environnement là où s'exécute votre script ou pipeline, puis appelez l'API ou la CLI avec eux.

  5. Révoquez une fois terminé

    Supprimez l'identifiant lorsque l'intégration est retirée ou si le secret risque d'être exposé. Tous les jetons émis à partir de lui cessent de fonctionner.

Exemples

Utiliser un identifiant avec la CLI Patrii
export PATRII_APP_CREDENTIAL_ID=<id-identifiant>
export PATRII_APP_CREDENTIAL_SECRET=<secret-identifiant>
patrii server list
Utiliser le même identifiant avec Terraform
# Le fournisseur Terraform lit des variables aux noms différents
export PATRII_APPLICATION_CREDENTIAL_ID=<id-identifiant>
export PATRII_APPLICATION_CREDENTIAL_SECRET=<secret-identifiant>
terraform plan
Échanger l'identifiant contre un jeton d'API
curl -X POST https://api.patrii.cloud/auth/app-credential-login \
  -H 'Content-Type: application/json' \
  -d '{"credential_id": "<id>", "credential_secret": "<secret>"}'

Limites et caractéristiques

Champs d'un identifiant d'application :

ChampSignification
NomIdentifie l'intégration; lettres, chiffres, tirets et traits de soulignement.
ID d'identifiantL'identifiant non secret utilisé pour se connecter.
SecretLa moitié confidentielle, affichée une seule fois à la création.
RôlesLes permissions que porte l'identifiant dans son projet.
ExpireExpiration facultative; vide signifie qu'il n'expire pas de lui-même.

Bonnes pratiques

  • Créez un identifiant par intégration pour pouvoir les révoquer indépendamment.
  • Fixez une expiration pour que des identifiants oubliés ne vivent pas éternellement.
  • Stockez le secret dans un coffre de secrets d'intégration continue ou dans le coffre de secrets, jamais dans le dépôt.
  • N'accordez que les rôles dont l'automatisation a besoin, pas votre accès complet.
  • Révoquez immédiatement au moindre soupçon d'exposition; cela n'affecte pas votre mot de passe.

Questions fréquentes

J'ai perdu le secret. Puis-je le revoir ?
Non. Le secret est affiché une seule fois à la création et ne peut être récupéré ensuite. Supprimez l'identifiant et créez-en un nouveau, puis mettez à jour votre automatisation avec les nouvelles valeurs.
En quoi est-ce différent de mon mot de passe ?
Un identifiant d'application est limité à un seul projet, peut porter des rôles plus étroits, contourne l'MFA interactive pour l'automatisation et peut être révoqué à part sans changer votre mot de passe.
Qu'arrive-t-il aux tâches en cours quand je supprime un identifiant ?
Les jetons obtenus à partir de cet identifiant sont invalides, donc les tâches qui en dépendent échoueront à s'authentifier. Basculez vers un nouvel identifiant avant de supprimer l'ancien pour éviter une interruption.

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