Requêtes HTTP

Utilisez l’action Make request pour effectuer une requête personnalisée vers un endpoint HTTP. Vous pouvez contrôler la méthode de requête et son contenu, la manière dont elle est authentifiée et traitée, et comment elle doit répondre à des scénarios tels que des certificats expirés ou des redirections. Si vous devez ajouter des plages d’adresses IP Datadog à votre liste d’autorisation pour que l’action HTTP fonctionne comme prévu, utilisez les adresses IP indiquées dans l’objet webhooks. Consultez l’API des plages IP pour plus de détails.

Pour ajouter une requête HTTP :

    • Dans un nouveau workflow, cliquez sur Add step et recherchez Make request. Sélectionnez l’action Make request pour l’ajouter à votre workflow.
    • Dans un workflow existant, cliquez sur
      et recherchez `Make request`. Sélectionnez l'action Make request pour l'ajouter à votre workflow.

      Spécifiez la méthode de requête et toute authentification nécessaire. Lisez les sections ci-dessous pour plus d’informations sur les options de configuration disponibles. Facultativement, la requête peut attendre des conditions que vous spécifiez dans la section Conditional wait, et réessayer à un intervalle donné si la condition n’est pas satisfaite.

      1. Dans votre application, sous Data, cliquez sur
      2. New
        3. et sélectionnez Query 1. Recherchez `HTTP`, puis sélectionnez l'action Make request pour l'ajouter à votre application.

        Spécifiez la méthode de requête et toute authentification nécessaire. Lisez les sections ci-dessous pour plus d’informations sur les options de configuration disponibles.

        Authentification

        Si vous devez authentifier votre requête, utilisez l’élément Connection de l’action pour configurer la méthode d’authentification. Vous pouvez soit sélectionner une connexion préconfigurée dans la liste déroulante, soit créer une connexion.

        Créer une connexion AWS

        1. Dans la section Connection, cliquez sur l’icône plus (
          ).
        2. Sélectionnez AWS.
        3. Saisissez un Connection Name, Account ID et AWS Role Name.
        4. Cliquez sur Create.

        Créer une connexion Azure

        1. Dans la section Connection, cliquez sur l’icône plus (
          ).
        2. Sélectionnez Azure.
        3. Saisissez un Connection Name, Tenant ID, Client ID et Client Secret.
        4. Facultativement, saisissez la Custom Scope à demander à Microsoft lors de l’acquisition d’un jeton d’accès OAuth 2.0. Le périmètre d’une ressource est construite en utilisant l’URI d’identifiant pour la ressource et .default, séparés par une barre oblique (/). Par exemple, {identifierURI}/.default. Pour plus d’informations, consultez la documentation Microsoft sur le périmètre .default.
        5. Cliquez sur Create.

        Créer une connexion d’authentification par jeton HTTP

        La connexion d’authentification par jeton utilise un jeton d’accès (Bearer) pour authentifier la requête HTTP.

        1. Dans la section Connection, cliquez sur l’icône plus (
          ).
        2. Sélectionnez HTTP.
        3. Saisissez un Connection Name.
        4. Saisissez le Base URL pour l’authentification.
        5. Dans la liste déroulante Authentication Type, sélectionnez Token Auth.
        6. Saisissez un Token Name et un Token Value. Vous pouvez saisir plusieurs jetons. Pour référencer votre jeton dans un en-tête, un paramètre ou le corps de la requête, utilisez la syntaxe {{ secretTokenName }}.
        7. Facultativement, ajoutez des Request Headers, URL parameters et un Body supplémentaires à votre requête.
        8. Cliquez sur Create.

        Créer une connexion d’authentification HTTP de base

        La connexion d’authentification de base utilise un en-tête d’autorisation avec un nom d’utilisateur et un mot de passe pour authentifier la requête HTTP.

        1. Dans la section Connection, cliquez sur l’icône plus (
          ).
        2. Sélectionnez HTTP.
        3. Saisissez un Connection Name.
        4. Saisissez le Base URL pour l’authentification.
        5. Dans la liste déroulante Authentication Type, sélectionnez Basic Auth.
        6. Saisissez un Username et un Password. L’en-tête de requête d’autorisation requis est automatiquement renseigné à l’aide de votre nom d’utilisateur et de votre mot de passe.
        7. Cliquez sur Create.

        Créer une connexion d’authentification HTTP en 2 étapes

        La connexion HTTP en 2 étapes vous permet d’effectuer une requête préliminaire pour récupérer un jeton d’accès avec lequel authentifier la requête HTTP. Ceci est utile pour authentifier les applications JSON Web Token (JWT) et OAuth.

        1. Dans la section Connection, cliquez sur l’icône plus (
          ).
        2. Sélectionnez HTTP.
        3. Saisissez un Connection Name.
        4. Saisissez le Base URL pour l’authentification.
        5. Dans la liste déroulante Authentication Type, sélectionnez 2 Step Auth.

          Configurez la requête de jeton d’accès préliminaire :

          1. Dans la liste déroulante Secret Type, sélectionnez Token Auth.
          2. Saisissez un nom de jeton et une valeur de jeton
          3. Saisissez le Request URL et spécifiez le type de requête comme étant GET ou POST.
          4. Facultativement, ajoutez des Request Headers, URL parameters et un Body supplémentaires à la requête.

          Obtenez le jeton d’accès à partir de la réponse :

          1. Sous Variable Path to Access Token, saisissez le chemin d’accès au jeton d’accès dans la réponse. Il s’agit du chemin par lequel votre jeton d’accès est renvoyé après avoir effectué l’appel d’authentification. Par exemple, si le jeton d’accès est renvoyé en tant que corps de la demande d’accès, utilisez body. Si le jeton d’accès est renvoyé dans une propriété appelée token de la réponse body, utilisez body.token. Les chemins sont sensibles à la casse.
          2. Facultativement, saisissez une Refresh Interval. Il s’agit de la durée avant l’expiration du jeton d’accès, spécifiée en secondes. Lorsque le jeton expire, la connexion demande automatiquement un nouveau jeton d’accès. Définir un intervalle de 0 désactive le rafraîchissement du jeton.

          Utilisez votre jeton récupéré pour authentifier votre connexion :

          1. Sous Request Detail, saisissez Request Headers, URL parameters et un Body pour compléter votre demande en utilisant le jeton d’accès récupéré.
          2. Cliquez sur Create.

          Configurez la requête d’authentification préliminaire :

          1. Dans la liste déroulante Secret Type, sélectionnez Basic Auth.
          2. Saisissez un Username et un Password. La section Request Headers est automatiquement remplie à l’aide de votre nom d’utilisateur et de votre mot de passe.

          Configurez la demande d’authentification :

          1. Saisissez le Request URL et spécifiez le type de requête comme étant GET ou POST.
          2. Facultativement, ajoutez des Request Headers, URL parameters et un Body supplémentaires à la requête.

          Obtenez le jeton d’accès à partir de la réponse :

          1. Sous Variable Path to Access Token, saisissez le chemin d’accès au jeton d’accès dans la réponse. Il s’agit du chemin par lequel votre jeton d’accès est renvoyé après avoir effectué l’appel d’authentification. Par exemple, si le jeton d’accès est renvoyé en tant que corps de la demande d’accès, utilisez body. Si le jeton d’accès est renvoyé dans une propriété appelée token de la réponse body, utilisez body.token. Les chemins sont sensibles à la casse.
          2. Facultativement, saisissez une Refresh Interval. Il s’agit de la durée avant l’expiration du jeton d’accès, spécifiée en secondes. Lorsque le jeton expire, la connexion demande automatiquement un nouveau jeton d’accès. Définir un intervalle de 0 désactive le rafraîchissement du jeton.

          Utilisez votre jeton récupéré pour authentifier votre connexion :

          1. Sous Request Detail, saisissez Request Headers, URL parameters et un Body pour compléter votre demande en utilisant le jeton d’accès récupéré.
          2. Cliquez sur Create.

          Créez une connexion HTTP mTLS

          La connexion d’authentification TLS mutuelle (mTLS) vous permet d’utiliser une clé privée et un certificat TLS pour authentifier la requête HTTP.

          Le certificat client (.crt, .pem) et la clé privée (.key, .pem) doivent utiliser le format PEM.
          1. Dans la section Connection, cliquez sur l’icône plus (
            ).
          2. Sélectionnez HTTP.
          3. Saisissez un Connection Name.
          4. Saisissez le Base URL pour l’authentification.
          5. Dans la liste déroulante Authentication Type, sélectionnez mTLS Auth.
          6. Cliquez sur Upload File pour télécharger votre Private Key.
          7. Cliquez sur Upload File pour télécharger votre Certificate.
          8. Cliquez sur Create.

          Entrées

          Une URL et une méthode de requête sont requises pour votre requête. Facultativement, vous pouvez saisir :

          • Paramètres d’URL
          • en-têtes
          • le type de contenu
          • un corps de requête
          • cookies

          Vous pouvez également choisir si vous souhaitez autoriser les certificats expirés ou suivre les redirections.

          Options de réponse

          Sous Error on Status, saisissez une liste séparée par des virgules de tous les codes d’état pour lesquels renvoyer une erreur. Utilisez la liste déroulante Response Parsing pour remplacer la méthode de parsing de réponse par défaut déduite des en-têtes, et Response Encoding si le serveur cible spécifie le mauvais encodage dans ses en-têtes de réponse.

          Private Actions

          Rejoignez la Preview !

          Les Private Actions sont en préversion. Utilisez ce formulaire pour demander l’accès dès aujourd’hui.

          Request Access

          Vous pouvez utiliser une action HTTP privée pour interagir avec des services hébergés sur votre réseau privé sans exposer vos services à l’Internet public. Les Private Actions utilisent un exécuteur d’actions privées que vous installez sur un host de votre réseau à l’aide de Docker et que vous associez à une connexion Datadog. Pour plus d’informations, consultez Private Actions.

          Pour configurer une requête HTTP privée :

          1. Ajoutez une action HTTP à votre application.

          2. Dans la section Connection, cliquez sur l’icône plus (

            ).

          3. Sélectionnez HTTP.

          4. Saisissez un Connection Name.

          5. Saisissez le Base URL du host dans votre réseau privé.

          6. Pour Type, assurez-vous que Private Action Runner est sélectionné.

          7. Dans la liste déroulante Private Action Runner, sélectionnez votre private action runner.

          8. Dans la liste déroulante Authentication Type, sélectionnez un type d’authentification et remplissez les champs requis. Les requêtes HTTP privées prennent en charge les types d’authentification suivants :

            Pour plus d’informations sur la configuration des identifiants pour l’authentification par jeton, consultez Handling Private Action Credentials.

          9. Cliquez sur Next, Confirm Access et configurez l’accès à la requête.

          10. Cliquez sur Create.

          Pour aller plus loin

          Documentation, liens et articles supplémentaires utiles:

          En savoir plus sur les identifiants de connexionDOCUMENTATION more more


          Avez-vous des questions ou des commentaires ? Rejoignez le canal #workflows ou #app-builder sur le Datadog Community Slack.