> 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. De nombreuses intégrations natives d'AirOps (Asana, HubSpot, Webflow, Shopify et d'autres) vous obligent à vous authentifier avant de pouvoir les utiliser dans des étapes de workflow. Une fois authentifié, vous pouvez choisir d'activer l'option pour **exposer** ces identifiants afin qu'ils puissent être référencés directement depuis des modèles Liquid et des étapes de code. C'est utile lorsque vous souhaitez appeler une API que l'étape native ne couvre pas, ou interpoler 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 du nom vide pour utiliser le nom généré. Cette option s'applique également aux connexions OAuth. ## Tester une connexion Utiliser **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 un résultat existe déjà, sélectionnez **Voir les résultats du test** et utilisez **Re-tester** pour vérifier à nouveau. Consultez le **Statut de la connexion** et les vérifications individuelles : | Statut | Signification | | ------------------------- | ------------------------------------------------------------------------------------------------- | | **Connecté** | Les vérifications de la connexion ont réussi. | | **Partiellement vérifié** | Certaines vérifications ont réussi, mais d'autres n'ont pas pu être vérifiées. | | **Non vérifié** | Les vérifications n'ont pas pu déterminer si la connexion fonctionne. | | **Accès limité** | Examinez les vérifications d'accès ayant échoué et les autorisations requises pour l'intégration. | | **Connexion échouée** | Examinez l'erreur, corrigez les identifiants ou la configuration, puis retestez. | | **Statut indisponible** | AirOps ne peut pas afficher un résultat de vérification fiable. Retestez 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. Examinez ces actions avant de vous y fier dans un workflow. Pour une nouvelle connexion, choisissez **Enregistrer l’intégration** après avoir examiné les résultats. **Enregistrer quand même** vous permet d'enregistrer des identifiants malgré un résultat bloquant ; cela ne résout pas les vérifications échouées. Le test de connexion Contentful est disponible pour les authentifications avec accès complet et inclut l'ID d'espace configuré. ## Suivre l'expiration des identifiants Pour les connexions par jeton ou par authentification de base prises en charge, définissez un(e) optionnel(le) **Date d'expiration** lors de la création ou de la modification des identifiants. Les administrateurs peuvent définir, mettre à jour ou effacer la date, et la liste des authentifications affiche la valeur configurée. Les connexions OAuth et celles gérées par Pipedream n'exposent pas ce champ. Utilisez la date pour indiquer quand l'identifiant fourni par le fournisseur doit être renouvelé. La définir ne renouvelle ni n'étend l'identifiant. AirOps envoie **Boîte de réception** des avertissements 30 jours avant l'expiration, 14 jours avant l'expiration, et lorsque les identifiants expirent. Ces notifications renvoient vers **Intégrations**, où vous pouvez mettre à jour les identifiants et la date. ## Activation de l'exposition 1. Accédez à **Paramètres > Intégrations**. 2. Trouvez l'authentification que vous souhaitez exposer. 3. Activez **Exposer les identifiants** pour cette ligne. Le commutateur est désactivé par défaut. Les identifiants ne sont disponibles pour les workflows que lorsque vous choisissez explicitement de les exposer. ## Référence dans les workflows Une fois exposés, les identifiants sont accessibles via la variable `authentications` , indexée par le nom du fournisseur puis par 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 dans le constructeur de workflow répertorie les authentifications exposées sous la catégorie « Authentifications d'intégration ». Cliquer sur une entrée insère le chemin correct pour le mode d'édition dans lequel vous vous trouvez. ## Ce qui est disponible Les champs exacts dépendent du type d'authentification. Pour les intégrations OAuth, vous aurez généralement `token`, `refresh_token`, et `expires_at`. Pour les intégrations par clé API, vous aurez le champ utilisé par l'intégration (généralement `api_key`). ## Désactivation de l'exposition Désactivez le commutateur. Les workflows qui font référence aux identifiants désormais non exposés se résoudront en valeurs vides ; si un workflow dépendait de ces identifiants, les appels en aval peuvent échouer. Réactivez pour rétablir. ## Sécurité Les identifiants sont automatiquement masqués sous la forme de `*****` dans les journaux de trace et les messages d'erreur des étapes, de sorte que le débogage d'erreurs mentionnant un jeton ne divulgue pas la valeur dans l'historique d'exécution. Les sorties des étapes ne sont pas masquées. Si une étape de code renvoie directement une valeur d'identifiant (par exemple, `return token`), la valeur apparaîtra dans la trace d'exécution. Veillez à éviter d'émettre des 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=&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.