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.
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
- 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éerLa page Identifiants d'application avec le bouton Créer - 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'applicationLa boîte de dialogue Créer un identifiant d'application - 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 .envLa boîte de dialogue de création avec le secret à usage unique et le bouton Télécharger le .env - 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.
- 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
export PATRII_APP_CREDENTIAL_ID=<id-identifiant> export PATRII_APP_CREDENTIAL_SECRET=<secret-identifiant> patrii server list
# 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
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 :
| Champ | Signification |
|---|---|
Nom | Identifie l'intégration; lettres, chiffres, tirets et traits de soulignement. |
ID d'identifiant | L'identifiant non secret utilisé pour se connecter. |
Secret | La moitié confidentielle, affichée une seule fois à la création. |
Rôles | Les permissions que porte l'identifiant dans son projet. |
Expire | Expiration 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 ?
En quoi est-ce différent de mon mot de passe ?
Qu'arrive-t-il aux tâches en cours quand je supprime un identifiant ?
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.