HTTP リクエスト

Make request アクションを使用して、HTTP エンドポイントへのカスタムリクエストを作成します。リクエストメソッドとその内容、認証および処理方法、期限切れの証明書やリダイレクトなどのシナリオへの対応方法を管理できます。HTTP アクションが期待通りに動作するように Datadog の IP アドレス範囲を許可リストに追加する必要がある場合は、webhooks オブジェクトに記載されている IP を使用してください。詳細については、IP Ranges API を参照してください。

HTTP リクエストを追加するには、以下の手順を実行してください。

    • 新しいワークフローで、Add step をクリックし、Make request を検索します。Make request アクションを選択してワークフローに追加します。
    • 既存のワークフローで、
      をクリックし、`Make request` を検索します。Make request アクションを選択してワークフローに追加します。

      リクエストメソッドと必要な 認証 を指定します。利用可能な構成オプションの詳細については、以下のセクションをお読みください。オプションとして、Conditional wait セクションで指定した条件をリクエストが待機するように設定し、条件が満たされない場合に指定した間隔で再試行させることができます。

      1. アプリの Data で、
      2. New
        3. をクリックし、Query を選択します。 1. `HTTP` を検索し、Make request アクションを選択してアプリに追加します。

        リクエストメソッドと必要な 認証 を指定します。利用可能な構成オプションの詳細については、以下のセクションをお読みください。

        認証

        リクエストの認証が必要な場合は、アクションの Connection を使用して認証方法を構成します。ドロップダウンから事前構成済みのコネクションを選択するか、新しいコネクションを作成できます。

        AWS コネクションを作成する

        1. Connection セクションで、プラスアイコン (
          ) をクリックします。
        2. AWS を選択します。
        3. Connection Name、Account ID、および AWS Role Name を入力します。
        4. Create をクリックします。

        Azure コネクションを作成する

        1. Connection セクションで、プラスアイコン (
          ) をクリックします。
        2. Azure を選択します。
        3. Connection Name、Tenant ID、Client ID、および Client Secret を入力します。
        4. オプションとして、OAuth 2.0 アクセストークンを取得する際に Microsoft に要求する Custom Scope を入力します。リソースのスコープは、リソースの識別子 URI と .default を使用して構築され、スラッシュ (/) で区切られます。例: {identifierURI}/.default。詳細については、.default スコープに関する Microsoft のドキュメント を参照してください。
        5. Create をクリックします。

        HTTP トークン認証コネクションを作成する

        トークン認証コネクションは、ベアラートークンを使用して HTTP リクエストを認証します。

        1. Connection セクションで、プラスアイコン (
          ) をクリックします。
        2. HTTP を選択します。
        3. Connection Name を入力します。
        4. 認証用の Base URL を入力します。
        5. Authentication Type ドロップダウンで Token Auth を選択します。
        6. Token Name および Token Value を入力します。複数のトークンを入力できます。ヘッダー、パラメーター、またはリクエスト本文でトークンを参照するには、syntax {{ secretTokenName }} を使用します。
        7. オプションで、追加の Request Headers、URL parameters、および Body をリクエストに追加できます。
        8. Create をクリックします。

        HTTP 基本認証コネクションを作成する

        Basic Auth コネクションは、ユーザー名とパスワードを含む認証ヘッダーを使用して HTTP リクエストを認証します。

        1. Connection セクションで、プラスアイコン (
          ) をクリックします。
        2. HTTP を選択します。
        3. Connection Name を入力します。
        4. 認証用の Base URL を入力します。
        5. Authentication Type ドロップダウンで Basic Auth を選択します。
        6. Username および Password を入力します。必要な認証リクエストヘッダーは、ユーザー名とパスワードを使用して自動的に入力されます。
        7. Create をクリックします。

        2 ステップ HTTP 認証コネクションを作成する

        HTTP 2 ステップコネクションを使用すると、HTTP リクエストを認証するためのアクセストークンを取得するための予備リクエストを行うことができます。これは、JSON Web Token (JWT) および OAuth アプリケーションの認証に役立ちます。

        1. Connection セクションで、プラスアイコン (
          ) をクリックします。
        2. HTTP を選択します。
        3. Connection Name を入力します。
        4. 認証用の Base URL を入力します。
        5. Authentication Type ドロップダウンで 2 Step Auth を選択します。

          予備アクセストークンクエリを構成します。

          1. Secret Type ドロップダウンで Token Auth を選択します。
          2. トークン名とトークン値を入力する
          3. Request URL を入力し、リクエストのタイプを GET または POST として指定します。
          4. オプションで、リクエストに Request Headers、URL parameters、および Body を追加します。

          レスポンスからアクセストークンを取得します。

          1. Variable Path to Access Token で、レスポンス内のアクセストークンへのパスを入力します。これは、認証呼び出しを行った後にアクセストークンが返されるパスです。たとえば、アクセストークンがアクセスリクエストの本文として返される場合は、body を使用します。アクセストークンがレスポンス body の token というプロパティで返される場合は、body.token を使用します。パスの大文字と小文字は区別されます。
          2. オプションで、Refresh Interval を入力します。これは、アクセストークンが期限切れになるまでの時間 (秒単位) です。トークンの有効期限が切れると、コネクションは自動的に新しいアクセストークンを要求します。間隔を 0 に設定すると、トークンの更新が無効になります。

          取得したトークンを使用してコネクションを認証します。

          1. Request Detail で、Request Headers、URL parameters、および Body を入力し、取得したアクセストークンを使用してリクエストを完了します。
          2. Create をクリックします。

          予備の認証クエリを構成します。

          1. Secret Type ドロップダウンで Basic Auth を選択します。
          2. Username および Password を入力します。Request Headers セクションは、ユーザー名とパスワードを使用して自動的に入力されます。

          認証リクエストを構成します。

          1. Request URL を入力し、リクエストのタイプを GET または POST として指定します。
          2. オプションで、リクエストに Request Headers、URL parameters、および Body を追加します。

          レスポンスからアクセストークンを取得します。

          1. Variable Path to Access Token で、レスポンス内のアクセストークンへのパスを入力します。これは、認証呼び出しを行った後にアクセストークンが返されるパスです。たとえば、アクセストークンがアクセスリクエストの本文として返される場合は、body を使用します。アクセストークンがレスポンス token の body というプロパティで返される場合は、body.token を使用します。パスの大文字と小文字は区別されます。
          2. オプションで、Refresh Interval を入力します。これは、アクセストークンが期限切れになるまでの時間 (秒単位) です。トークンの有効期限が切れると、コネクションは自動的に新しいアクセストークンを要求します。間隔を 0 に設定すると、トークンの更新が無効になります。

          取得したトークンを使用してコネクションを認証します。

          1. Request Detail で、Request Headers、URL parameters、および Body を入力し、取得したアクセストークンを使用してリクエストを完了します。
          2. Create をクリックします。

          HTTP mTLS コネクションを作成する

          Mutual TLS (mTLS) 認証コネクションを使用すると、秘密鍵と TLS 証明書を使用して HTTP リクエストを認証できます。

          クライアント証明書 (.crt、.pem) および秘密鍵 (.key、.pem) は PEM 形式を使用する必要があります。
          1. Connection セクションで、プラスアイコン (
            ) をクリックします。
          2. HTTP を選択します。
          3. Connection Name を入力します。
          4. 認証用の Base URL を入力します。
          5. Authentication Type ドロップダウンで mTLS Auth を選択します。
          6. Upload File をクリックして Private Key をアップロードします。
          7. Upload File をクリックして Certificate をアップロードします。
          8. Create をクリックします。

          入力

          リクエストには URL とリクエストメソッドが必要です。オプションで、以下を入力できます。

          • URL パラメーター
          • ヘッダー
          • コンテンツタイプ
          • リクエスト本文
          • クッキー

          期限切れの証明書を許可するか、リダイレクトに従うかを選択することもできます。

          レスポンスオプション

          Error on Status の下に、エラーを返すステータスコードのリストをカンマ区切りで入力します。Response Parsing ドロップダウンを使用して、ヘッダーから推測されるデフォルトのレスポンスのパース方法を上書きし、ターゲットサーバーがレスポンスヘッダーで誤ったエンコーディングを指定している場合は Response Encoding を使用します。

          プライベートアクション

          プレビューに参加しましょう。

          Private Actions はプレビュー版です。このフォームを使用して、今すぐアクセスをリクエストしてください。

          Request Access

          プライベート HTTP アクションを使用すると、パブリックインターネットにサービスを公開することなく、プライベートネットワーク上でホストされているサービスとやり取りできます。プライベートアクションは、Docker を使用してネットワーク内のホストにインストールし、Datadog コネクションとペアリングするプライベートアクションランナーを利用します。詳細については、Private Actions を参照してください。

          プライベート HTTP リクエストを構成するには、以下の手順を実行します。

          1. アプリに HTTP アクションを追加します。

          2. Connection セクションで、プラスアイコン (

            ) をクリックします。

          3. HTTP を選択します。

          4. Connection Name を入力します。

          5. プライベートネットワーク内のホストの Base URL を入力します。

          6. Type については、Private Action Runner が選択されていることを確認します。

          7. Private Action Runner ドロップダウンから、プライベートアクションランナー を選択します。

          8. Authentication Type ドロップダウンから、認証タイプを選択し、必要なフィールドに入力します。プライベート HTTP リクエストは、以下の認証タイプをサポートしています。

            トークン認証の認証情報を構成する方法については、プライベートアクション視覚情報の処理 を参照してください。

          9. Next, Confirm Access をクリックし、クエリへのアクセスを構成します。

          10. Create をクリックします。

          参考資料

          役立つドキュメント、リンク、記事:

          接続の資格情報の詳細はこちらドキュメント more more


          ご質問やフィードバックがある場合は、Datadog Community Slack の**#workflows** または #app-builder チャンネルにご参加ください。