Skip to main content
Un compte de service est une identité nommée pour une intégration. Il détient des clés API ou des clients OAuth et porte les autorisations que ces identifiants peuvent utiliser. La révision 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 peut pas authentifier une requête. Consultez Authentification pour choisir une méthode; une intégration par clé API n’a pas besoin d’OAuth. Gérez les comptes de service à partir de l’onglet Comptes de service 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éral pour tout. Les comptes propres à chaque charge de travail limitent les autorisations au strict minimum, rendent les journaux de requêtes attribuables et vous permettent de 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, afin que les futurs administrateurs puissent 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 pour chaque identifiant créé 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 plus tard; les identifiants existants conservent les portées qui leur ont été accordées.
3

Vérifier et créer

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

​
Gérer le cycle de vie

  • Modifiez les autorisations en tout temps. Retirer une autorisation du compte la retire de ce que ses clés API et ses jetons d’accès OAuth peuvent exercer.
  • Désactivez un compte pour interrompre l’accès à l’API par tous ses identifiants — utile lors du retrait d’une intégration ou pour contenir une fuite présumée d’identifiant pendant que vous enquêtez. Réactiver le compte 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éé, à quel moment, 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.