Connexions

Les actions, workflows et applications peuvent utiliser des connexions qui envoient des données clients à des services tiers en dehors de la région Datadog for Government. Consultez le Trust Center pour obtenir des instructions sur l'obtention de la matrice de responsabilité client et des informations supplémentaires sur la région Datadog for Government.

Comme les actions se connectent à des systèmes logiciels externes, vous devrez peut-être authentifier votre compte Datadog auprès de l’intégration correspondante. Une application ou un workflow ne peut s’exécuter correctement que si chaque action nécessitant une authentification peut vérifier l’identité de votre compte Datadog. Lors de l’octroi d’autorisations à Datadog, assurez-vous de suivre les meilleures pratiques de sécurité et de n’accorder que les autorisations nécessaires à l’exécution d’une application ou d’un workflow.

Les actions peuvent être authentifiées à l’aide de deux types d’identifiants :

  • Identifiants et autorisations configurés dans la tuile d’intégration
  • Identifiants de connexion

Identifiants de la tuile d’intégration

Les identifiants et l’authentification de compte que vous configurez dans les tuiles d’intégration Datadog suivantes sont automatiquement propagés aux actions correspondantes dans les workflows ou les applications :

  • GitHub
  • Jira
  • Microsoft Teams
  • Opsgenie
  • PagerDuty
  • Slack
  • Statuspage

Configurez les tuiles d’intégration en suivant les instructions dans Datadog Integrations.

Si l’intégration que vous devez configurer n’est pas listée ci-dessus, configurez des identifiants de connexion.

Identifiants de connexion

Les connexions étendent vos intégrations installées pour vous donner le contrôle sur l’authentification des étapes de workflow. Utilisez des identifiants de connexion pour authentifier une action générique ou toute action pour laquelle la tuile d’intégration ne propose pas d’authentification. Pour obtenir une liste des intégrations qui utilisent la tuile d’intégration pour l’authentification, consultez la section Identifiants de la tuile d’intégration. Les identifiants de connexion ne sont disponibles que pour une utilisation au sein des produits Workflow Automation et App Builder.

Les connexions prennent en charge les exemples de cas d’utilisation suivants :

  • L’intégration dont vous avez besoin n’est pas disponible en tant que connexion intégrée.
  • Vous souhaitez authentifier une action personnalisée. Par exemple, vous devez utiliser l’action HTTP avec votre propre service.
  • Les autorisations nécessaires ne sont pas prises en charge par l’intégration, comme les autorisations d’écriture sur AWS.
  • Vous souhaitez un contrôle d’accès granulaire, par exemple en restreignant l’accès des utilisateurs à certains workflows.

Considérations sur la sécurité des connexions

Avant de créer une connexion, réfléchissez aux autorisations nécessaires pour accomplir la tâche requise et n’accordez à la connexion que les autorisations nécessaires pour accomplir cette tâche. De plus, la connexion doit être limitée aux seules personnes qui ont besoin de l’utiliser.

Dans la mesure du possible, utilisez des connexions granulaires pour différents workflows ou applications. Par exemple, si vous avez un workflow qui écrit dans un compartiment Amazon S3 et une application qui termine des instances Amazon EC2, n’utilisez pas la même connexion pour les deux. Créez plutôt deux connexions respectives, chacune correspondant à un rôle IAM avec un périmètre limité.

Travailler avec des connexions

Afficher les connexions

  1. Depuis la page Workflow Automation ou la page App Builder, cliquez sur l’onglet Connections. La liste des connexions s’ouvre.
  2. Cliquez sur une ligne pour afficher les détails de la connexion.

Créer une connexion

L’établissement d’une connexion nécessite les informations suivantes :

  • À quoi se connecter (par exemple, nom du produit, URL)
  • Comment s’authentifier (par exemple, clé d’API, nom d’utilisateur/mot de passe, oauth)

Pour créer une connexion :

  1. Depuis la page Workflow Automation ou la page App Builder, cliquez sur l’onglet Connections. La liste des connexions s’ouvre.
  2. Cliquez sur le bouton New Connection en haut à droite. La boîte de dialogue New Connection s’affiche.
  3. Cliquez sur une icône pour choisir un schéma d’intégration.
  4. Remplissez les champs appropriés.
    Si vous souhaitez ajouter la connexion à un groupe de connexions ultérieurement, ajoutez un ou plusieurs tags d’identifiant.
  5. Cliquez sur Create.

Sinon, ajoutez une connexion depuis une page de workflow ou d’application :

  1. Accédez à la liste Workflow Automation.
  2. Sélectionnez le workflow contenant l’action à laquelle vous devez ajouter des identifiants. Le générateur de workflow s’affiche.
  3. Dans la visualisation du workflow, cliquez sur l’action à laquelle vous devez ajouter des identifiants. Le volet latéral se remplit avec les détails de l’action.
  4. Sous l’onglet Configure, recherchez le menu déroulant Connection et cliquez sur l’icône +.
  5. Dans la boîte de dialogue New Connection, nommez la connexion et saisissez les détails d’authentification requis.
  6. Cliquez sur Save.
  1. Accédez à la liste des applications App Builder.
  2. Sélectionnez l’application contenant l’action à laquelle vous devez ajouter des identifiants. Le canevas de l’application s’affiche.
  3. Cliquez sur Edit dans le coin supérieur droit.
  4. Sous Data sur le côté gauche, cliquez sur l’action à laquelle vous devez ajouter des identifiants. Le panneau latéral gauche se remplit avec les détails de l’action.
  5. Recherchez la liste déroulante Connection et cliquez sur l’icône +.
  6. Dans la boîte de dialogue New Connection, nommez la connexion et saisissez les détails d’authentification requis.
  7. Cliquez sur Save.

L’exemple ci-dessous montre la boîte de dialogue New Connection pour la connexion OpenAI. Chaque connexion nécessite des informations d’authentification différentes. La connexion OpenAI nécessite un nom de connexion et un jeton API valides.

La boîte de dialogue Nouvelle connexion pour la connexion OpenAI

Modifier une connexion

  1. Depuis la page Workflow Automation ou la page App Builder, cliquez sur l’onglet Connections. La liste des connexions s’ouvre.
  2. Survolez la connexion que vous souhaitez modifier. Les icônes Edit, Permissions et Delete apparaissent sur la droite.
  3. Cliquez sur l’icône crayon (Edit). Une boîte de dialogue s’affiche.
  4. Mettez à jour les champs que vous souhaitez modifier.
  5. Cliquez sur Save.

Supprimer une connexion

  1. Accédez à la liste des connexions.
  2. Survolez la connexion que vous souhaitez supprimer. Les icônes Edit, Permissions et Delete apparaissent sur la droite.
  3. Cliquez sur l’icône corbeille (Delete). « Êtes-vous sûr ? » Le texte s’affiche.
  4. Sélectionnez Delete.

Restreindre l’utilisation de la connexion

Pour savoir comment restreindre l’utilisation d’une connexion, consultez Accès et authentification pour Workflow Automation ou App Builder.

Connexion HTTP

Pour vous connecter à un service arbitraire, utilisez le type de connexion HTTP. Pour les options d’authentification et les instructions de configuration, consultez l’action HTTP.

Tags d’identifiant de connexion

Vous pouvez ajouter des tags d’identifiant aux connexions. Les règles de tagging pour les connexions sont basées sur les tags Datadog, avec les exigences supplémentaires suivantes :

  • Les tags d’identifiant doivent respecter le format tag:value, et les deux-points supplémentaires ne sont pas autorisés. Par exemple, les tags d’identifiant env:staging:east et env sont des formats non valides pour les tags de connexion.
  • Les tags d’identifiant doivent commencer par une lettre, après quoi elles peuvent contenir :
    • Alphanumériques
    • Traits de soulignement
    • Tirets
    • Barres obliques
    • Exactement un deux-points
  • default est une valeur réservée pour les tags d’identifiant de connexion. Elle ne peut pas être utilisée comme clé de tag autonome ou comme valeur de tag. Par exemple, default:yes et aws:default sont non valides pour les tags de connexion.

Groupes de connexions

Vous pouvez créer des groupes de connexions afin que vos workflows et applications puissent s’authentifier auprès du ou des comptes corrects en fonction des entrées fournies. Les connexions ne peuvent être regroupées que si elles partagent la même intégration (par exemple, vous ne pouvez pas regrouper des connexions GCP et AWS au sein du même groupe).

Vous définissez les membres d’un groupe de connexions à l’aide des tags d’identifiant d’une connexion. Par exemple, vous pouvez créer un groupe de connexions composé de comptes AWS possédant le tag account_id.

Chaque connexion du groupe doit disposer d’un ensemble de tags d’identifiant uniques afin qu’un workflow puisse sélectionner dynamiquement la connexion correcte lors de l’exécution. Exemple :

  • connectionA {account_id:123456789} et connectionB {account_id:987654321} peuvent être regroupés.
  • connectionA {account_id:123456789} et connectionC {account_id:123456789} ne peuvent pas être regroupés, car le groupe contiendrait des valeurs de tag en double.

Créer un groupe de connexions

Vous ne pouvez ajouter des connexions à un groupe que si vous disposez de l'autorisation Resolver pour celles-ci.

Pour créer un groupe de connexions :

  1. Accédez à la liste des connexions.
  2. Sur la gauche, cliquez sur Groups.
  3. Cliquez sur
    • New Group
    , puis sélectionnez une intégration.
  4. Saisissez un nom de groupe, puis saisissez un ensemble de trois Identifier Tags au maximum que possèdent toutes les connexions que vous souhaitez inclure dans votre groupe.
  5. Sous Confirm Group, utilisez les cases à cocher pour sélectionner les membres spécifiques de votre groupe.
  6. Cliquez sur Next, Confirm Access, puis choisissez le niveau d’accès souhaité pour le groupe.
  7. Cliquez sur Create.

Utiliser un groupe de connexions

Pour utiliser un groupe de connexions :

  1. Dans votre workflow ou application, sélectionnez une action qui nécessite une connexion.
  2. Dans le champ Connection, dans la liste déroulante, sélectionnez le groupe de connexions souhaité sous Groups.
  3. Remplissez les valeurs souhaitées pour le groupe de connexions Identifiers. Par exemple, si votre groupe de connexions est défini à l’aide du tag d’identifiant env, et que vous avez deux environnements, prod et staging, vous pouvez utiliser l’une ou l’autre de ces valeurs (ou une expression qui s’évalue à l’une de ces valeurs).
  4. Remplissez toutes les autres valeurs d’étape requises, puis cliquez sur Save.

Remarque : vous ne pouvez utiliser des connexions au sein d’un groupe que si vous disposez de l’autorisation Resolver pour ces connexions. Si un workflow ou une application tente d’utiliser une connexion pour laquelle vous ne disposez pas de l’[autorisation Resolver], cela échoue avec une erreur 403 Forbidden. Pour résoudre ce problème, vous pouvez :

  • Configurez le workflow ou l’application de manière à ce qu’il ne puisse pas pointer vers une connexion qui ne dispose pas de l’[autorisation Resolver].
  • Supprimez du groupe de connexions la connexion qui ne dispose pas de l’[autorisation Resolver].
    Si vous utilisez un groupe de connexions pour plusieurs workflows ou plusieurs applications, la suppression d’une connexion dont dépend un autre workflow entraînera l’échec de ce workflow.

Mettre à jour un groupe de connexions

Si vous disposez d’un accès en modification à un groupe de connexions, vous pouvez mettre à jour les attributs suivants :

  • Nom du groupe
  • Tags d’identifiant (ceux-ci ne peuvent jamais être vides, mais ils peuvent être entièrement remplacés)
  • Connexions (un groupe peut être vide)

Supprimer un groupe de connexions

Pour supprimer un groupe de connexions :

  1. Passez la souris sur le groupe que vous souhaitez supprimer et cliquez sur l’icône delete (trash can).
  2. Cliquez sur Delete.
La suppression d'un groupe de connexions a un impact sur tous les workflows et applications qui utilisent ce groupe.

Pour aller plus loin


Avez-vous des questions ou des commentaires ? Rejoignez le canal #workflows ou #app-builder sur le Slack de la communauté Datadog.