Solicitudes HTTP

Esta traducción no está actualizada. Para consultar la última versión en inglés, haz clic aquí

Utilice la acción Make request para realizar una solicitud personalizada a un punto de conexión HTTP. Puede controlar el método de solicitud y su contenido, cómo se autentica y procesa, y cómo debe responder a escenarios como certificados caducados o redirecciones. Si necesita agregar rangos de direcciones IP de Datadog a su lista de permitidos para que la acción HTTP funcione como se espera, utilice las IP enumeradas en el objeto webhooks. Consulte la API de rangos de IP para obtener más detalles.

Para agregar una solicitud HTTP:

    • En un nuevo flujo de trabajo, haga clic en Add step y busque Make request. Seleccione la acción Make request para agregarla a su flujo de trabajo.
    • En un flujo de trabajo existente, haga clic en
      y busque `Make request`. Seleccione la acción Make request para agregarla a su flujo de trabajo.

      Especifique el método de solicitud y cualquier autenticación necesaria. Lea las secciones a continuación para obtener más información sobre las opciones de configuración disponibles. Opcionalmente, la solicitud puede esperar a que se cumplan las condiciones que especifique en la sección Conditional wait y reintentar en un intervalo determinado si la condición no se cumple.

      1. En su aplicación, en Data, haga clic en
      2. New
        3. y seleccione Query 1. Busque `HTTP`, luego seleccione la acción Make request para agregarla a su aplicación.

        Especifique el método de solicitud y cualquier autenticación necesaria. Lea las secciones a continuación para obtener más información sobre las opciones de configuración disponibles.

        Autenticación

        Si necesita autenticar su solicitud, utilice el Connection de la acción para configurar el método de autenticación. Puede seleccionar una conexión preconfigurada del menú desplegable o crear una conexión.

        Crear una conexión de AWS

        1. En la sección Connection, haga clic en el icono de más (
          ).
        2. Seleccione AWS.
        3. Ingrese un Connection Name, Account ID y AWS Role Name.
        4. Haga clic en Create.

        Crear una conexión de Azure

        1. En la sección Connection, haga clic en el icono de más (
          ).
        2. Seleccione Azure.
        3. Ingrese un Connection Name, Tenant ID, Client ID y Client Secret.
        4. Opcionalmente, ingrese el Custom Scope que se solicitará a Microsoft al adquirir un token de acceso OAuth 2.0. El contexto de un recurso se construye utilizando el URI del identificador para el recurso y .default, separados por una barra diagonal (/). Por ejemplo, {identifierURI}/.default. Para obtener más información, consulte la documentación de Microsoft sobre el contexto .default.
        5. Haga clic en Create.

        Crear una conexión de autenticación de token HTTP

        La conexión de autenticación de token utiliza un token de portador para autenticar la solicitud HTTP.

        1. En la sección Connection, haga clic en el icono de más (
          ).
        2. Seleccione HTTP.
        3. Ingrese un Connection Name.
        4. Ingrese el Base URL para la autenticación.
        5. En el menú desplegable Authentication Type, seleccione Token Auth.
        6. Ingrese un Token Name y Token Value. Puede ingresar múltiples tokens. Para hacer referencia a su token en un encabezado, parámetro o en el cuerpo de la solicitud, use la sintaxis {{ secretTokenName }}.
        7. Opcionalmente, agregue Request Headers, URL parameters y un Body adicionales a su solicitud.
        8. Haga clic en Create.

        Cree una conexión de autenticación básica HTTP

        La conexión de autenticación básica utiliza un encabezado de autorización con un nombre de usuario y una contraseña para autenticar la solicitud HTTP.

        1. En la sección Connection, haga clic en el icono de más (
          ).
        2. Seleccione HTTP.
        3. Ingrese un Connection Name.
        4. Ingrese el Base URL para la autenticación.
        5. En el menú desplegable Authentication Type, seleccione Basic Auth.
        6. Ingrese un Username y Password. El encabezado de solicitud de autorización requerido se completa automáticamente usando su nombre de usuario y contraseña.
        7. Haga clic en Create.

        Cree una conexión de autenticación HTTP de 2 pasos

        La conexión HTTP de 2 pasos le permite realizar una solicitud preliminar para recuperar un token de acceso con el cual autenticar la solicitud HTTP. Esto es útil para autenticar aplicaciones de JSON Web Token (JWT) y OAuth.

        1. En la sección Connection, haga clic en el icono de más (
          ).
        2. Seleccione HTTP.
        3. Ingrese un Connection Name.
        4. Ingrese el Base URL para la autenticación.
        5. En el menú desplegable Authentication Type, seleccione 2 Step Auth.

          Configure la consulta de token de acceso preliminar:

          1. En el menú desplegable Secret Type, seleccione Token Auth.
          2. Ingrese un Nombre de token y un Valor de token
          3. Ingrese el Request URL y especifique el tipo de solicitud como GET o POST.
          4. Opcionalmente, agregue Request Headers, URL parameters y un Body adicionales a la solicitud.

          Obtenga el token de acceso de la respuesta:

          1. En Variable Path to Access Token, ingrese la ruta al token de acceso en la respuesta. Esta es la ruta a través de la cual se devuelve su token de acceso después de realizar la llamada de autenticación. Por ejemplo, si el token de acceso se devuelve como el cuerpo de la solicitud de acceso, use body. Si el token de acceso se devuelve en una propiedad llamada token de la respuesta body, use body.token. Las rutas distinguen entre mayúsculas y minúsculas.
          2. Opcionalmente, ingrese un Refresh Interval. Esta es la duración hasta que el token de acceso caduque, especificada en segundos. Cuando el token caduca, la conexión solicita automáticamente un nuevo token de acceso. Establecer un intervalo de 0 deshabilita la actualización del token.

          Use su token recuperado para autenticar su conexión:

          1. En Request Detail, ingrese Request Headers, URL parameters y un Body para completar su solicitud usando el token de acceso recuperado.
          2. Haga clic en Create.

          Configure la consulta de autenticación preliminar:

          1. En el menú desplegable Secret Type, seleccione Basic Auth.
          2. Ingrese un Username y Password. La sección Request Headers se completa automáticamente usando su nombre de usuario y contraseña.

          Configure la solicitud de autenticación:

          1. Ingrese el Request URL y especifique el tipo de solicitud como GET o POST.
          2. Opcionalmente, agregue Request Headers, URL parameters y un Body adicionales a la solicitud.

          Obtenga el token de acceso de la respuesta:

          1. En Variable Path to Access Token, ingrese la ruta al token de acceso en la respuesta. Esta es la ruta a través de la cual se devuelve su token de acceso después de realizar la llamada de autenticación. Por ejemplo, si el token de acceso se devuelve como el cuerpo de la solicitud de acceso, use body. Si el token de acceso se devuelve en una propiedad llamada token de la respuesta body, use body.token. Las rutas distinguen entre mayúsculas y minúsculas.
          2. Opcionalmente, ingrese un Refresh Interval. Esta es la duración hasta que el token de acceso caduque, especificada en segundos. Cuando el token caduca, la conexión solicita automáticamente un nuevo token de acceso. Establecer un intervalo de 0 deshabilita la actualización del token.

          Use su token recuperado para autenticar su conexión:

          1. En Request Detail, ingrese Request Headers, URL parameters y un Body para completar su solicitud usando el token de acceso recuperado.
          2. Haga clic en Create.

          Crear una conexión HTTP mTLS

          La conexión TLS mutua (mTLS) le permite usar una clave privada y un certificado TLS para autenticar la solicitud HTTP.

          El certificado de cliente (.crt, .pem) y la clave privada (.key, .pem) deben usar el formato PEM.
          1. En la sección Connection, haga clic en el icono de más (
            ).
          2. Seleccione HTTP.
          3. Ingrese un Connection Name.
          4. Ingrese el Base URL para la autenticación.
          5. En el menú desplegable Authentication Type, seleccione mTLS Auth.
          6. Haga clic en Upload File para cargar su Private Key.
          7. Haga clic en Upload File para cargar su Certificate.
          8. Haga clic en Create.

          Entradas

          Se requieren una URL y un método de solicitud para su solicitud. Opcionalmente, puede ingresar:

          • Parámetros de URL
          • encabezados
          • el tipo de contenido
          • un cuerpo de solicitud
          • cookies

          También puede seleccionar si desea permitir certificados caducados o seguir redirecciones.

          Opciones de respuesta

          En Error on Status, ingrese una lista separada por comas de cualquier código de estado en el que se deba devolver un error. Utilice el menú desplegable Response Parsing para anular el método de parseo de respuesta predeterminado inferido a partir de los encabezados, y Response Encoding si el servidor de destino especifica la codificación incorrecta en sus encabezados de respuesta.

          Private Actions

          ¡Únase a la vista previa!

          Las Private Actions están en vista previa. Utilice este formulario para solicitar acceso hoy mismo.

          Request Access

          Puede utilizar una acción HTTP privada para interactuar con servicios alojados en su red privada sin exponer sus servicios a la internet pública. Las Private Actions utilizan un ejecutor de acciones privadas que usted instala en un servidor de su red mediante Docker y lo vincula con una conexión de Datadog. Para obtener más información, consulte Private Actions.

          Para configurar una solicitud HTTP privada:

          1. Agregue una acción HTTP a su aplicación.

          2. En la sección Connection, haga clic en el icono de más (

            ).

          3. Seleccione HTTP.

          4. Ingrese un Connection Name.

          5. Ingrese el Base URL para el servidor en su red privada.

          6. Para Type, asegúrese de que Private Action Runner esté seleccionado.

          7. En el menú desplegable Private Action Runner, seleccione su ejecutor de acciones privadas.

          8. En el menú desplegable Authentication Type, seleccione un tipo de Autenticación y complete los campos obligatorios. Las solicitudes HTTP privadas admiten los siguientes tipos de autenticación:

            Para obtener información sobre cómo configurar las credenciales para la Autenticación por token, consulte Gestión de credenciales de acciones privadas.

          9. Haga clic en Next, Confirm Access y configure el acceso a la consulta.

          10. Haga clic en Create.

          Lecturas adicionales

          Documentación, enlaces y artículos útiles adicionales:

          Obtenga más información sobre las credenciales de conexiónDOCUMENTACIÓN more more


          ¿Tiene preguntas o comentarios? Únase al canal #workflows o #app-builder en el Datadog Community Slack.