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 :
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.

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
Accédez à Paramètres > Intégrations.
Trouvez l'authentification que vous souhaitez exposer.
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 ?