For the complete documentation index, see llms.txt. This page is also available as Markdown.

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) nécessitent que vous vous authentifiiez avant de pouvoir les utiliser dans les étapes de workflow. Une fois authentifié, vous pouvez choisir d' exposer ces identifiants afin qu'ils puissent être référencés directement depuis les modèles Liquid et les étapes de code. C'est utile lorsque vous تريد appeler une API que l'étape native ne couvre pas, ou interpoler un jeton dans une requête.

Donnez un nom à 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

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 un résultat existe déjà, sélectionnez Afficher les résultats du test et utilisez Retester pour vérifier à nouveau.

Consultez le statut de la connexion et les vérifications individuelles :

Statut
Signification

Connecté

Les vérifications de 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é

Consultez les vérifications d'accès ayant échoué et les autorisations requises pour l'intégration.

Échec de la connexion

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. Passez ces actions en revue 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 avec un résultat bloquant ; cela ne résout pas les vérifications en échec.

Le test de connexion Contentful est disponible pour les authentifications avec accès complet et inclut l'ID d'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 vérifie pas les autorisations de rapport ni les crédits de rapport disponibles. Consultez la note distincte sur l'accès aux rapports avant d'exécuter un Workflow.

Settings Integrations list with named authentications, a connection test result, an expiration badge, and Expose credentials
Testez les connexions, suivez l'expiration et exposez les identifiants depuis les Intégrations.

Suivre l'expiration des identifiants

Pour les connexions prises en charge par jeton ou par 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, 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 cette date pour indiquer quand les identifiants fournis par le fournisseur doivent être renouvelés. La définir ne renouvelle ni ne prolonge les identifiants. 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. Basculez Exposer les identifiants sur cette ligne.

Le bouton est désactivé par défaut. Les identifiants ne sont disponibles pour les workflows que lorsque vous choisissez explicitement de les exposer.

Référencement dans les workflows

Une fois exposés, les identifiants sont accessibles via la variable authentications , indexée d'abord par le nom du fournisseur, puis par le nom affiché de l'authentification.

Modèle Liquid

Étape de code JavaScript

Étape de code Python

Le sélecteur de variables dans le générateur de workflow répertorie les authentifications exposées dans 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 référencent les identifiants désormais non exposés seront résolus en valeurs vides ; si un workflow dépendait de ces identifiants, les appels en aval peuvent échouer. Réactivez pour restaurer.

Sécurité

Les identifiants sont automatiquement masqués comme ***** dans les journaux de trace et les messages d'erreur des étapes, de sorte que le débogage des 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 à ne pas émettre d'identifiants dans les sorties des étapes.

Mis à jour

Ce contenu vous a-t-il été utile ?