> ## Documentation Index > Fetch the complete documentation index at: https://docs.bodyguard.ai/llms.txt > Use this file to discover all available pages before exploring further. # Obtenir votre clé API > Créez un compte de service et une clé API dans le dashboard Bodyguard pour authentifier vos requêtes API. Pour appeler l'API Bodyguard, votre application s'authentifie avec une clé API. Dans le dashboard, les clés API appartiennent à un **compte de service** : le compte de service est l'identité de votre application ou de votre processus automatisé (un outil de monitoring, un script, un pipeline de données, un environnement de staging ou de production), et la clé API est l'identifiant qu'il utilise pour s'authentifier. > [!NOTE] > > Les comptes de service et les clés API ne sont pris en charge que par la nouvelle API. ## Prérequis Vous avez besoin du rôle **Admin** dans votre organisation pour créer et gérer des comptes de service et des clés API. Les Members et les Editors peuvent les consulter. ## Étapes **1. Créer un compte de service** 1. Cliquez sur l'icône d'engrenage dans le menu de gauche pour ouvrir **Settings**, puis sélectionnez **Identity & access management**. ![Dashboard Bodyguard avec l'icône d'engrenage Settings dans le menu de gauche et l'entrée Identity & access management en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/01-open-identity-access-management.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=3c532a44d620aaa28e01b00ff3f95620) Settings > Identity & access management 2. Ouvrez l'onglet **Service accounts** et cliquez sur **Create service account**. ![Onglet Service accounts avec le bouton Create service account en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/02-create-service-account-button.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=eb53cd519b9cec5584337e650243ba9b) Onglet Service accounts 3. Remplissez le formulaire. Les numéros correspondent à la capture d'écran ci-dessous. **1.** Saisissez un **Name**.\\ **2.** Ajoutez une **Description** (facultative).\\ **3.** Vérifiez l'accès aux sources. **Grant full source access** est activé par défaut : le compte de service peut accéder à toutes les sources, actuelles et futures.\\ **4.** Cliquez sur **Create**. ![Fenêtre Create service account avec le champ Name (1), le champ Description (2), l'option Grant full source access (3) et le bouton Create (4) en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/03-create-service-account-form.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=e743a37f72a204681cc090a4cc38f5e8) Formulaire de création d'un compte de service Utilisez un nom clair qui identifie l'application ou l'environnement qui utilise le compte. Par exemple, nommez-le `Production Monitoring` et décrivez-le avec `Used by the production monitoring integration`. 4. Votre compte de service apparaît dans la liste. Cliquez sur l'icône d'agrandissement à la fin de sa ligne pour ouvrir sa page de détails. ![Liste des comptes de service avec le nouveau compte en surbrillance et une flèche pointant vers l'icône d'agrandissement qui ouvre sa page de détails](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/04-open-service-account-details.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=e1d50b7bcfaade82b2c03090037a4909) Ouvrir la page de détails du compte de service **2. Générer une clé API** 1. Sur la page de détails du compte de service, cliquez sur **Generate an API key**. ![Page de détails du compte de service avec le bouton Generate an API key en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/05-generate-api-key-button.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=c92294d33da1a0875332546f58778bd8) Page de détails du compte de service 2. Saisissez un nom et une description facultative. Pour que la clé expire, cochez **Set an expiration date** et choisissez une date. Cliquez ensuite sur **Generate and continue**. ![Fenêtre Generate an API key avec les champs Name, Description, Set an expiration date et Expiration date, et le bouton Generate and continue](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/06-generate-api-key-form.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=f3e43876ed8bf82236e8e3e2a5b0b4e8) Formulaire de génération d'une clé API 3. Copiez votre clé API avec l'icône de copie et conservez-la en lieu sûr, puis cliquez sur **Done**. La clé n'est affichée qu'une seule fois, lors de sa création. Il ne sera plus possible de l'afficher ensuite. ![Fenêtre Your API key has been generated avec le champ API key et son icône de copie en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/07-api-key-displayed-once.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=762e744f44a2f31268010e24dbf0c302) Clé API affichée à la création Vous pouvez ensuite modifier, désactiver ou supprimer une clé depuis le menu **⋮** à la fin de sa ligne. La modification d'une clé ne change que son nom, sa description et sa date d'expiration : vous ne pouvez ni changer ni afficher sa valeur. Si vous perdez la valeur d'une clé, générez-en une nouvelle. ![Ligne d'une clé API avec son menu ouvert, affichant les actions Edit API key, Deactivate et Delete](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/get-api-key/08-api-key-actions.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=b2356adafef5ccd8a281dc62cdc48548) Actions sur une clé API > [!WARNING] > > La désactivation d'un compte de service ne désactive pas ses clés API. Gérez les clés séparément si nécessaire. **3. Utiliser votre clé API** Envoyez la clé dans l'en-tête `Authorization` de chaque requête, avec le schéma `ApiKey` (sensible à la casse) : ```text En-tête Authorization theme={null} Authorization: ApiKey ``` Consultez [Authentification](https://docs.bodyguard.ai/fr/api-reference/introduction.md#authentification) pour les en-têtes requis et les erreurs d'authentification, et le [Démarrage rapide](https://docs.bodyguard.ai/fr/api-reference/introduction.md#démarrage-rapide) pour une première requête. > [!WARNING] > > Gardez votre clé API secrète et ne l'exposez jamais dans du code côté client. ## Étapes suivantes > [card] [Introduction à l'API](https://docs.bodyguard.ai/fr/api-reference/introduction.md) > > Authentifiez-vous et envoyez votre première requête. > [card] [Connecter votre webhook](https://docs.bodyguard.ai/fr/documentation/how-to/connect-webhook.md) > > Recevez des notifications sur votre endpoint. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.