> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/votre-espace-de-travail/settings/authentications.md).

# Authentifications d’intégration

Testez les connexions d’intégration, suivez l’expiration des identifiants et utilisez les identifiants dans les Workflows.

Bon nombre des intégrations natives d’AirOps (Asana, HubSpot, Webflow, Shopify et d’autres) nécessitent une authentification avant de pouvoir être utilisées dans les étapes d’un workflow. Une fois authentifié, vous pouvez choisir d’ **exposer** ces identifiants afin qu’ils puissent être référencés directement dans les modèles Liquid et les étapes de code. C’est utile lorsque vous souhaitez appeler une API qui n’est pas prise en charge par l’étape native ou insérer un jeton dans une requête.

## Nommer une authentification

Lorsque vous ajoutez une authentification dans **Paramètres → Intégrations**, vous pouvez saisir un nom personnalisé pour distinguer les comptes ou les environnements. Laissez le champ vide pour utiliser le nom généré. Cette option s’applique également aux connexions OAuth.

## Tester une connexion

Utilisez **Tester la connexion** dans **Paramètres → Intégrations** pour vérifier les intégrations prises en charge avant de les utiliser dans les workflows. Vous pouvez tester de nouveaux identifiants pendant la configuration ou utiliser le menu de l’authentification enregistrée pour tester une connexion existante. Si des résultats sont déjà disponibles, sélectionnez **Afficher les résultats du test** et utilisez **Tester à nouveau** pour effectuer une nouvelle vérification.

La colonne **Dernière vérification de la connexion** décrit le résultat du test le plus récent. **Tests indisponibles** signifie qu’AirOps ne propose pas de tests pour cette intégration ; **Non testée** signifie qu’aucun test n’a été effectué. Aucun de ces libellés ne signifie que l’authentification est déconnectée.

Consultez les résultats enregistrés et les vérifications individuelles :

| Statut                     | Signification                                                                                  |
| -------------------------- | ---------------------------------------------------------------------------------------------- |
| **Connectée**              | Les vérifications de la connexion ont réussi.                                                  |
| **Partiellement vérifiée** | Certaines vérifications ont réussi, mais d’autres n’ont pas pu être effectuées.                |
| **Non vérifiée**           | Les vérifications n’ont pas permis d’établir si la connexion fonctionne.                       |
| **Accès limité**           | Consultez les vérifications d’accès échouées et les autorisations requises pour l’intégration. |
| **Échec de la connexion**  | Consultez l’erreur, corrigez les identifiants ou la configuration, puis testez à nouveau.      |
| **État indisponible**      | AirOps ne peut pas afficher de résultat de vérification fiable. Testez à nouveau la connexion. |

Un résultat individuel **Non vérifié** ne signifie pas nécessairement que les identifiants sont incorrects. Certaines actions ne peuvent pas être testées sans créer, modifier ou supprimer du contenu. Vérifiez ces actions avant de vous y fier dans un workflow.

Pour une nouvelle connexion, choisissez **Enregistrer l’intégration** après avoir consulté les résultats. **Enregistrer quand même** permet d’enregistrer des identifiants même si un résultat bloque l’opération ; cela ne résout pas les vérifications échouées.

Les tests de connexion à Contentful sont disponibles pour les authentifications avec accès complet et incluent l’ID de l’espace configuré.

Pour OAuth Semrush, **Tester la connexion** vérifie l’authentification du jeton et l’accès au serveur sans consommer d’unités d’API de rapport. Une vérification d’authentification réussie ne confirme ni les autorisations d’accès aux rapports ni le nombre de crédits de rapport disponibles. Consultez la remarque distincte sur l’accès aux rapports avant d’exécuter un workflow.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-781014a050068c906c2e9666c769859440c30986%2Fauthentications-01-integrations-list.png?alt=media" alt="Settings Integrations list with named authentications, a connection test result, an expiration badge, and Expose credentials"><figcaption><p>Testez les connexions, suivez les expirations et exposez les identifiants depuis Intégrations.</p></figcaption></figure>

## Suivre l’expiration des identifiants

Pour les connexions compatibles utilisant un jeton ou l’authentification de base, définissez une **Date d’expiration** facultative lors de la création ou de la modification des identifiants. Les administrateurs peuvent définir, modifier ou effacer cette date, et la liste des authentifications affiche la valeur configurée. Les connexions OAuth et celles gérées par Pipedream ne proposent pas ce champ.

Utilisez cette date pour consigner le moment où l’identifiant fourni par le prestataire doit être renouvelé. La définir ne renouvelle ni ne prolonge l’identifiant. AirOps envoie des **Boîte de réception** alertes 30 jours avant l’expiration, 14 jours avant l’expiration et à la date d’expiration des identifiants. Ces notifications renvoient vers **Intégrations**, où vous pouvez mettre à jour les identifiants et leur date d’expiration.

## Activer l’exposition

1. Accédez à **Paramètres > Intégrations**.
2. Recherchez l’authentification que vous souhaitez exposer.
3. Activez **Exposer les identifiants** pour cette ligne.

Le bouton est désactivé par défaut. Les workflows ne peuvent accéder aux identifiants que si vous les exposez explicitement.

## Référencer les identifiants dans les workflows

Une fois exposés, les identifiants sont accessibles via la variable `authentications` selon une structure hiérarchique : d’abord le nom du fournisseur, puis le nom d’affichage de l’authentification.

### Modèle Liquid

```
{{ authentications['asana']['Prod'].token }}
```

### Étape de code JavaScript

```javascript
const auth = authentications.asana["Prod"];
const token = auth.token;
```

### Étape de code Python

```python
auth = authentications["asana"]["Prod"]
token = auth["token"]
```

Le sélecteur de variables du générateur de workflows répertorie les authentifications exposées dans la catégorie « Authentifications des intégrations ». Cliquez sur une entrée pour insérer le chemin approprié au mode d’édition utilisé.

## Éléments disponibles

Les champs disponibles dépendent du type d’authentification. Pour les intégrations OAuth, vous disposez généralement de `token`, `refresh_token`, et de `expires_at`. Pour les intégrations utilisant une clé API, vous disposez du champ utilisé par l’intégration (souvent `api_key`).

## Désactiver l’exposition

Désactivez le bouton. Les workflows qui référencent les identifiants désormais masqués renverront des valeurs vides ; si un workflow dépendait de ces identifiants, les appels suivants risquent d’échouer. Réactivez l’exposition pour rétablir l’accès.

## Sécurité

Les identifiants sont automatiquement masqués sous la forme `*****` dans les journaux de traces et les messages d’erreur des étapes. Ainsi, le débogage d’erreurs mentionnant un jeton ne divulgue pas sa valeur dans l’historique d’exécution.

Les sorties des étapes ne sont pas masquées. Si une étape de code renvoie directement la valeur d’un identifiant (par exemple, `return token`), cette valeur apparaîtra dans la trace d’exécution. Veillez à ne pas inclure d’identifiants dans les sorties des étapes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/votre-espace-de-travail/settings/authentications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
