Aller au contenu principal

Comptes de service

Prélude​

Un compte de service est un type spécial de clé d'API destiné à représenter un utilisateur non humain qui a besoin de s'authentifier et d'être autorisé pour des scénarios tels que le scan des secrets dans les pipelines CI ou le traitement par lot des incidents ouverts.

Veuillez noter que les comptes de service sont uniquement disponibles pour les workspaces sous notre plan Growth ou Enterprise.

Créer un compte de service​

Seuls les Managers du workspace sont autorisés à gérer les comptes de service.

  1. Rendez-vous sur la page Service accounts dans la section API de votre workspace. Cliquez sur Create service account.
  2. Nommez votre compte de service en fonction de son cas d'usage (par exemple <Service Name>-<Environment>)
  3. Définissez une date d'expiration pour votre token (dans 1 semaine, 1 mois, 3 mois, 6 mois, 1 an, ou jamais). Si une date d'expiration est définie, tous les Managers du workspace recevront une notification par e-mail 5 jours avant l'expiration.
  4. Choisissez un ou plusieurs scopes pour votre compte de service.
  5. Cliquez sur Create service account

Assurez-vous de copier le compte de service, il ne vous sera plus visible à l'avenir.

Service accounts modal

Dans les plans Growth et Enterprise, les Managers du workspace peuvent administrer les comptes de service émis pour leur workspace GitGuardian depuis la page Service accounts. Ils peuvent consulter chaque compte de service, en rechercher un par nom, filtrer par Creator ou Scope, et le révoquer directement depuis le tableau.

Service accounts table

Révoquer un compte de service​

Un token de compte de service peut être révoqué depuis la page Service accounts par un Manager du workspace, ou via l'API publique par un autre token détenant le scope api_tokens:write.

Un token de compte de service ne peut pas se révoquer lui-même. Étant donné qu'un token de compte de service peut être partagé entre plusieurs déploiements, lui permettre de s'auto-révoquer casserait chaque déploiement qui l'utilise. Toute tentative en ce sens (par exemple via ggshield auth logout) est refusée avec une erreur 403.