Skip to main content
Un compte de service est une identité nommée destinée à une intégration. Il détient des clés d’API ou des clients OAuth et porte les autorisations que ces identifiants peuvent utiliser. La revue des accès s’effectue donc au niveau du compte : ce qu’une intégration peut faire est visible en un seul endroit, quel que soit le nombre d’identifiants qu’elle possède. Le compte lui-même n’est pas un identifiant : son ID ne permet pas d’authentifier une requête. Consultez Authentification pour choisir une méthode ; une intégration qui utilise une clé d’API n’a pas besoin d’OAuth. Gérez les comptes de service depuis l’onglet Service accounts du Developer Hub.

​
Concevoir vos comptes en fonction des charges de travail

Créez un compte de service par intégration ou par charge de travail — par exemple reporting-pipeline, scim-sync ou soc-enrichment — plutôt qu’un seul compte générique pour l’ensemble. Des comptes dédiés à chaque charge de travail limitent les autorisations au strict nécessaire, permettent d’attribuer les journaux de requêtes à leur source et vous laissent désactiver une intégration sans toucher aux autres.

​
Créer un compte de service

1

Nommer le compte

Donnez au compte un nom qui identifie la charge de travail qu’il dessert, ainsi qu’une description de son rôle. Les deux apparaissent dans les listes et les journaux, ce qui permet aux futurs administrateurs de distinguer les comptes.
2

Accorder les autorisations

Sélectionnez les autorisations que le compte peut accorder à ses identifiants — par exemple entity:read, simulation:read ou reporting:read. Cet ensemble constitue le plafond de tous les identifiants créés sous le compte : un identifiant peut porter un sous-ensemble de ces autorisations, jamais davantage.
Accordez le minimum dont la charge de travail a besoin aujourd’hui. Vous pouvez ajouter des autorisations au compte ultérieurement ; les identifiants existants conservent les périmètres qui leur ont été accordés.
3

Vérifier et créer

Confirmez le nom et l’ensemble d’autorisations. Une fois le compte créé, sa page de détails vous permet de créer ses clés d’API.

​
Gérer le cycle de vie

  • Modifiez les autorisations à tout moment. Retirer une autorisation du compte la retire de ce que ses clés d’API et ses jetons d’accès OAuth peuvent exercer.
  • Désactivez un compte pour interrompre l’accès à l’API via tous ses identifiants — utile lors du retrait d’une intégration ou pour contenir une fuite présumée d’identifiant pendant votre enquête. La réactivation permet aux identifiants encore actifs et non expirés de s’authentifier à nouveau.
  • Supprimez un compte lorsque l’intégration a été retirée. Arrêtez d’abord l’intégration et révoquez ses identifiants. La suppression est définitive.
La page de détails de chaque compte indique qui l’a créé, quand, et quand l’une de ses clés a été utilisée pour la dernière fois — un moyen rapide de repérer les intégrations abandonnées qui devraient être désactivées.