Dado que las acciones se conectan con sistemas de software externos, es posible que tengas que autenticar tu cuenta de Datadog en la integración correspondiente. Una aplicación o un flujo de trabajo sólo pueden ejecutarse correctamente si todas las acciones que requieren autenticación pueden verificar la identidad de tu cuenta de Datadog. Cuando concedas permisos a Datadog, asegúrate de seguir las prácticas recomendadas de seguridad y de conceder únicamente los permisos necesarios para que se ejecute una aplicación o un flujo de trabajo.

Las acciones pueden autenticarse de dos maneras:

• Credenciales y permisos configurados en el cuadro de integración
• Credenciales de conexión

Credenciales de cuadro de integración

Las credenciales y la autenticación de cuenta que configures en los siguientes cuadros de la integración Datadog se propagan automáticamente a las acciones correspondientes de los flujos de trabajo o las aplicaciones:

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

Configurar los cuadros de integración siguiendo las instrucciones de Datadog Integrations, integraciones Datadog.

Si la integración que necesitas configurar no aparece en la lista anterior, configura las credenciales de conexión.

Credenciales de conexión

Las conexiones amplían las integraciones instaladas para ofrecerte el control de la autenticación de pasos de flujos de trabajo. Utiliza credenciales de conexión para autenticar una acción genérica o cualquier acción para la que el cuadro de la integración no ofrezca autenticación. Para obtener una lista de las integraciones que utilizan el cuadro de la integración para la autenticación, consulta la sección Credenciales del cuadro de la integración. Las credenciales de conexión sólo están disponibles para su uso en los productos Workflow Automation y App Builder.

Las conexiones admiten los siguientes ejemplos de casos de uso:

• La integración que necesitas no está disponible como conexión integrada.
• Deseas autenticar una acción personalizada. Por ejemplo, necesitas utilizar la acción HTTP con tu propio servicio.
• Los permisos necesarios no son compatibles con la integración, como los permisos de escritura en AWS.
• Deseas un control de acceso granular, por ejemplo, restringiendo el acceso de los usuarios a determinados flujos de trabajo.

Consideraciones sobre la seguridad de la conexión

Antes de crear una conexión, piensa en los permisos necesarios para cumplir la tarea requerida y concede a la conexión solo los permisos necesarios para cumplir esa tarea. Además, la conexión debe estar restringida únicamente a las personas que necesiten utilizarla.

Siempre que sea posible, utiliza conexiones específicas para diferentes flujos de trabajo o aplicaciones. Por ejemplo, si tienes un flujo de trabajo que escribe en un bucket de Amazon S3 y una aplicación que cierra instancias Amazon EC2, no utilices la misma conexión para ambos. En su lugar, crea dos conexiones, cada una correspondiente a un rol IAM con contexto limitado.

Trabajar con conexiones

Ver conexiones

1. Desde la página de Workflow Automation o la página de App Builder, haz clic en la pestaña Conexiones. Se abre la lista de conexiones.
2. Haz clic en una línea para ver los detalles de la conexión.

Crear una conexión

Para establecer una conexión, se requiere la siguiente información:

• A qué conectarse (por ejemplo, nombre del producto, URL)
• Cómo autenticarse (por ejemplo, clave API, nombre de usuario/contraseña, oauth)

Para crear una conexión:

1. Desde la página de Workflow Automation o la página de App Builder, haz clic en la pestaña Conexiones. Se abre la lista de conexiones.
2. Haz clic en el botón New Connection (Nueva conexión) situado en la parte superior derecha. Aparece el cuadro de diálogo New Connection (Nueva conexión).
3. Haz clic en un icono para elegir un esquema integración.
4. Rellena los campos correspondientes.
   Si quieres añadir la conexión a un grupo de conexiones en el futuro, añade una o más etiquetas (tags) identificadoras.
5. Haz clic en Create (Crear).

Otra posibilidad es añadir una conexión desde la página de un flujo de trabajo o aplicación:

El siguiente ejemplo muestra el cuadro de diálogo New Connection (Nueva conexión) para la conexión OpenAI. Cada conexión requiere una información de autenticación diferente. La conexión OpenAI requiere un Nombre de conexión y un token de API válidos.

Editar una conexión

1. Desde la página de Workflow Automation o la página de App Builder, haz clic en la pestaña Conexiones. Se abre la lista de conexiones.
2. Pasa el cursor sobre la conexión que deseas editar. Los iconos Edit (Editar), Permissions (Permisos) y Delete (Eliminar) aparecen a la derecha.
3. Haz clic en el icono del lápiz (Edit). Aparecerá un cuadro de diálogo.
4. Actualiza los campos que deseas modificar.
5. Haz clic en Save (Guardar).

Eliminar una conexión

1. Navega hasta la connections list (lista de conexiones).
2. Pasa el cursor sobre la conexión que deseas eliminar. A la derecha aparecen los iconos Editar, Permisos y Eliminar.
3. Haz clic en el icono de la papelera (Eliminar). Aparecerá el texto “¿Estás seguro?”.
4. Selecciona Eliminar.

Restringir el uso de la conexión

Para saber cómo restringir el uso de la conexión, consulta Acceso y autenticación para Workflow Automation o App Builder.

Conexión HTTP

Para conectarte a un servicio arbitrario, utiliza el tipo de conexión HTTP. Para conocer las opciones de autenticación y las instrucciones de configuración, consulta la acción HTTP.

Etiquetas identificadoras de conexiones

Puedes añadir etiquetas identificadoras a las conexiones. Las reglas de etiquetado de las conexiones se basan en las etiquetas de Datadog, con los siguientes requisitos adicionales:

• Las etiquetas identificadoras deben seguir el formato tag:value y no se permiten dos puntos adicionales. Por ejemplo, las etiquetas identificadoras env:staging:east y env son formatos no válidos para las etiquetas de conexiones.
• Las etiquetas identificadoras deben empezar por una letra, después de la cual pueden contener:
  • Caracteres alfanuméricos
  • Guiones bajos
  • Signos de resta
  • Barras
  • Exactamente dos puntos
• default es un valor reservado para las etiquetas identificadoras de conexiones. No puede utilizarse como clave de etiqueta independiente ni como valor de etiqueta. Por ejemplo, default:yes y aws:default no son válidos para las etiquetas de conexión.

Grupos de conexiones

Puedes crear grupos de conexiones para que tus flujos de trabajo y tus aplicaciones puedan autenticarse en la cuenta o cuentas correctas en función de las entradas dadas. Las conexiones sólo pueden agruparse si comparten la misma integración (por ejemplo, no puedes agrupar conexiones de GCP y AWS en el mismo grupo).

Los miembros de un grupo de conexiones se definen mediante las Etiquetas identificadoras de una conexión. Por ejemplo, puedes crear un grupo de conexión formado por cuentas de AWS que tengan la etiqueta account_id.

Cada conexión del grupo debe tener un conjunto de etiquetas identificadoras únicas para que un flujo de trabajo pueda seleccionar dinámicamente la conexión correcta en el tiempo de ejecución. Por ejemplo:

• connectionA {account_id:123456789} y connectionB {account_id:987654321} pueden agruparse.
• connectionA {account_id:123456789} y connectionC {account_id:123456789} no pueden agruparse, porque el grupo contendría valores de etiqueta duplicados.

Crear un grupo de conexión

Para crear un grupo de conexión:

1. Ve a la lista de conexiones.
2. A la izquierda, haz clic en Groups (Grupos).
3. Haz clic en + New Group (+ Nuevo grupo) y selecciona una integración.
4. Introduce un nombre de grupo y, a continuación, introduce un conjunto de hasta tres Etiquetas identificadoras que tengan todas las conexiones que desees incluir en tu grupo.
5. En Confirm Group (Confirmar grupo), utiliza las casillas de verificación para seleccionar los miembros específicos de tu grupo.
6. Haz clic en Next, Confirm Access (Siguiente, Confirmar acceso) y, a continuación, elige el nivel de acceso que desees para el grupo.
7. Haz clic en Create (Crear).

Utilizar un grupo de conexión

Para utilizar un grupo de conexión:

1. En tu flujo de trabajo o aplicación, selecciona un acción que requiera una conexión.
2. En el campo Connection (Conexión), en el menú desplegable, selecciona el grupo de conexión deseado en Groups (Grupos).
3. Introduce los valores deseados para los Identificadores del grupo de conexión. Por ejemplo, si tu grupo de conexión se define utilizando la etiqueta identificadora env y tienes dos entornos, prod y staging, podrías utilizar cualquiera de esos valores (o una expresión que evalúe uno de esos valores).
4. Rellena cualquier otro valor de paso requerido y haz clic en Save (Guardar).

Nota: Sólo puedes utilizar conexiones dentro de un grupo si tienes el permiso Resolver para esas conexiones. Si un flujo de trabajo o una aplicación intenta utilizar una conexión para la que no tiene permiso Resolver, se producirá un error en 403 Forbidden. Para solucionar este problema, puedes:

• Configura el flujo de trabajo o la aplicación para que no pueda apuntar a una conexión que no tenga permiso Resolver.
• Elimina la conexión que no tiene un permiso Resolver del grupo de conexiones.
  Nota: Si utilizas un grupo de conexiones para varios flujos de trabajo o varias aplicaciones, la eliminación de una conexión de la que depende otro flujo de trabajo provocará el fallo de ese flujo de trabajo.

Actualizar un grupo de conexión

Si tienes acceso de edición a un grupo de conexión, puedes actualizar los siguientes atributos:

• Nombre del grupo
• Etiquetas identificadoras (nunca pueden estar vacías, pero pueden sustituirse por completo)
• Conexiones (un grupo puede estar vacío)

Eliminar un grupo de conexión

Para eliminar un grupo de conexión:

1. Pasa el ratón por encima del grupo que quieras eliminar y haz clic en el icono delete (trash can) (eliminar (papelera)).
2. Haz clic en Delete (Borrar).

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Empezando con la automatización de flujos de trabajoDOCUMENTACIÓN Documentación de App BuilderDOCUMENTACIÓN

¿Tienes preguntas o comentarios? Únete al canal #workflows o #app-builder en Datadog Community Slack.