Módulos de Azure DevOps
En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan Azure DevOps, así como conectarlo a varias aplicaciones y servicios de terceros.
Para obtener instrucciones sobre cómo crear un escenario, consulte los artículos en Crear escenarios: índice de artículos.
Para obtener información acerca de los módulos, consulte los artículos en Módulos: índice de artículos.
Requisitos de acceso
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Paquete de Adobe Workfront |
Cualquier paquete del flujo de trabajo de Adobe Workfront y cualquier paquete de integración y automatización de Adobe Workfront Workfront Ultimate Paquetes Workfront Prime y Select, con una compra adicional de Workfront Fusion. |
| Licencias de Adobe Workfront |
Estándar Trabajo o superior |
| Licencia de Adobe Workfront Fusion |
Basado en operaciones: disponible para organizaciones con licencias basadas en operaciones Basado en conector (heredado): Workfront Fusion for Work Automation and Integration |
| Producto | Si su organización tiene un paquete de Workfront Select o Prime que no incluye la automatización y la integración de Workfront, su organización debe adquirir Adobe Workfront Fusion. |
Para obtener más información sobre el contenido de esta tabla, consulte Requisitos de acceso en la documentación.
Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
Requisitos previos
Para usar módulos de Azure DevOps, debe tener una cuenta de DevOps de Azure.
Información de la API Azure DevOps
El conector DevOps de Azure utiliza lo siguiente:
Conexión de Azure DevOps a Workfront Fusion connect-azure-devops-to-workfront-fusion
Conexión de Azure DevOps a Adobe Workfront Fusion mediante una conexión federada
Una conexión federada funciona como la conexión principal de servicio, excepto que no utiliza un secreto de cliente.
En lugar de almacenar un secreto, indique a Microsoft Entra ID que confíe en los tokens que Workfront Fusion emite para una conexión específica. Cuando se ejecuta la conexión, Fusion presenta una prueba de identidad de corta duración y Microsoft Entra ID devuelve un token de acceso. Como no hay ningún secreto de cliente, no hay nada que caduque ni ningún secreto que rotar o almacenar.
| note |
|---|
| NOTE |
|
- Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una conexión federada
- Cree el registro de la aplicación en Microsoft Entra ID (conexión federada)
- Recopile sus datos de conexión (conexión federada)
- Creación de la conexión en Workfront Fusion (conexión federada)
- Agregar la credencial federada en Microsoft Entra ID
- Compruebe la conexión (conexión federada)
Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una conexión federada
Para crear esta conexión, necesita lo siguiente:
- Acceso de administrador global o administrador de aplicaciones en Microsoft Entra ID para registrar la aplicación y añadir las credenciales federadas. Si no tiene este acceso, pídale a alguien de su equipo de TI o de identidad que siga estos pasos.
- Acceso de administrador de recopilación de proyectos en su organización de Azure DevOps para agregar la entidad de servicio como miembro. A menudo se trata de una persona diferente a la persona que administra el Microsoft Entra ID.
- Nombre de su organización de DevOps de Azure. Puede encontrar esto en su URL de DevOps de Azure:
dev.azure.com/<your organization name>.
Cree el registro de la aplicación en Microsoft Entra ID (conexión federada)
- Inicie sesión en el Centro de administración de Microsoft Entra.
- Vaya a Registros de aplicaciones > Nuevo registro.
- Asigne a la aplicación un nombre claro y reconocible. Por ejemplo,
Workfront Fusion Azure DevOps Integration. - Deje URI de redireccionamiento en blanco. Esta conexión no implica iniciar sesión a través de un explorador.
- Seleccione Registrar.
- No cree un secreto de cliente. Una conexión federada no utiliza una.
- Continúe a Recopilar sus detalles de conexión.
Recopile sus datos de conexión (conexión federada)
-
En la página Información general del registro de la aplicación, tenga en cuenta los siguientes valores. Estos se introducen al crear la conexión en el módulo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Tenant ID En la página Información general, con la etiqueta Directorio (inquilino) ID. Client ID En la página Información general, ID de aplicación (cliente). Organization Nombre de su organización de Azure DevOps. Por ejemplo, si la dirección URL es dev.azure.com/yourorg, escribayourorg. -
Continuar a Crear la conexión en Workfront Fusion.
| note |
|---|
| NOTE |
| Al igual que con la conexión principal del servicio, puede omitir el área de permisos de API del registro de la aplicación. El acceso a Azure DevOps se concede dentro de Azure DevOps, en el siguiente procedimiento. |
Creación de la conexión en Workfront Fusion (conexión federada)
-
En la pantalla de configuración de la conexión del módulo, seleccione el tipo de conexión federada.
-
Introduzca lo siguiente:
- ID de inquilino
- Id. de cliente
- Organización
-
Seleccione Crear.
Workfront Fusion muestra tres valores. Deje esta página abierta, ya que necesitará estos valores más adelante en el proceso de creación de la conexión.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Emisor https://oidc.automations.adobe.com.Subject Esto identifica esta conexión. Se ve como fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. Es diferente para cada conexión que cree.Audience api://AzureADTokenExchange.note important IMPORTANT No cierre el panel ni seleccione Cancelar. La conexión no finaliza hasta que complete el resto del procedimiento. Si cierra el panel, debe eliminar la conexión y volver a iniciarla, ya que una nueva conexión recibe un nuevo Asunto. -
Copie el valor Subject.
-
Continuar a Agregar la credencial federada en Microsoft Entra ID.
Agregar la credencial federada en Microsoft Entra ID
Este procedimiento es el que reemplaza el secreto de cliente. Indica a Microsoft Entra ID que acepte tokens que Workfront Fusion emite para esta conexión.
-
En una nueva pestaña del explorador, vuelva al Centro de administración de Microsoft Entra y abra el registro de la aplicación.
-
Vaya a Certificados y secretos > Credenciales federadas.
-
Seleccione Agregar credencial.
-
En el escenario de Credenciales federadas, seleccione Otro emisor.
-
Introduzca lo siguiente:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Emisor https://oidc.automations.adobe.comIdentificador de asunto El asunto que ha copiado de Workfront Fusion. Péguelo exactamente sin añadir espacios. Name Un nombre que identifica esta conexión, para que pueda encontrarla más adelante. Por ejemplo, workfront-fusion-connection-28964.Audience api://AzureADTokenExchange. Normalmente, esto se rellena para usted. Mantenga el valor predeterminado. -
Haga clic en Añadir.
-
Continuar a Verificar la conexión.
| note |
|---|
| NOTE |
| El Microsoft Entra ID permite un máximo de 20 credenciales federadas en un único registro de aplicación, y el identificador de sujeto debe coincidir exactamente. No se admiten caracteres comodín. Dado que cada conexión de Workfront Fusion tiene su propio asunto, cada conexión necesita su propia credencial federada. Si espera más de 20 conexiones, registre más de una aplicación y extienda las conexiones entre ellas. |
Compruebe la conexión (conexión federada)
-
Vuelva a la pestaña del explorador de Workfront Fusion, donde el panel de conexión sigue abierto.
-
Haga clic en Guardar.
- Si todo está configurado correctamente, la conexión se valida correctamente y puede continuar con la configuración del módulo.
- Si la verificación falla, el panel permanece abierto y muestra el error. Corrija el problema en Microsoft Entra ID o en Azure DevOps y vuelva a seleccionar Guardar. No es necesario volver a crear la conexión y el asunto no cambia.
| note |
|---|
| NOTE |
| Una credencial federada que agregue al Microsoft Entra ID puede tardar poco tiempo en activarse. Si la verificación falla inmediatamente después de agregar la credencial, espere un minuto y seleccione Guardar de nuevo antes de investigar más a fondo. |
Resolución de problemas
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| La conexión falla en la verificación con un cliente no válido o un error de solicitud no válido | El ID de Microsoft Entra no pudo hacer coincidir el token con una credencial federada. Compruebe que el emisor sea exactamente https://oidc.automations.adobe.com sin barra diagonal y que el identificador de asunto sea idéntico carácter por carácter al asunto mostrado en Workfront Fusion. La causa más común es un asunto copiado de una conexión diferente. |
| La conexión se verifica, pero los módulos devuelven 401 o 403 desde Azure DevOps | La identidad es de confianza, pero no tiene acceso a los datos de Azure DevOps. Confirme que ha completado Agregar la entidad de seguridad de servicio a su organización de Azure DevOps y que la entidad de seguridad de servicio está asignada al proyecto específico que utiliza el módulo. |
| No puede agregar otra credencial federada | Ha alcanzado el límite de 20 credenciales federadas para el registro de esa aplicación. Registre una aplicación adicional y cree más conexiones con ella. |
Conexión de Azure DevOps a Workfront Fusion mediante EntraApp
Puede conectar Azure DevOps a Workfront Fusion mediante EntraApp.
-
Añada un módulo de Azure DevOps a su escenario.
-
Haga clic en Añadir junto al campo conexión.
-
En el campo Tipo de conexión, seleccione el tipo de conexión que desea utilizar.
note NOTE Azure DevOps (EntraApp) le permite solicitar todos los ámbitos de la conexión. -
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Connection name Introduzca un nombre para la conexión que está creando. Organization Introduzca el nombre de la organización en la que ha creado la aplicación Azure DevOps. App ID Introduzca el ID de la aplicación DevOps a la que se está conectando. Client Secret Escriba el secreto de cliente para las aplicaciones DevOps a las que se está conectando. Solicitar todos los ámbitos Si está usando el tipo de conexión Azure DevOps (EntraApp), habilite esta opción para solicitar todos los ámbitos de la conexión. -
Para escribir un ID de aplicación o un secreto de cliente de Azure DevOps, haga clic en Mostrar configuración avanzada e ingréselos en los campos que se abren.
-
Haga clic en Continuar para finalizar la configuración de la conexión y continuar creando el escenario.
Conexión de Azure DevOps a Workfront Fusion mediante una entidad de servicio
Puede crear una conexión que utilice una entidad de seguridad de servicio (una conexión API de aplicación) en lugar de una cuenta personal. Esto resulta útil cuando desea que la conexión se ejecute como una identidad de aplicación o servicio en lugar de como una persona específica. Esto puede resultar útil para que la integración no se interrumpa si, por ejemplo, esa persona abandona la empresa o cambia su contraseña.
Este tipo de conexión está disponible para todos los módulos DevOps de Azure.
| note |
|---|
| NOTE |
| La autenticación principal de servicio no es compatible con todas las funciones de Azure DevOps. Un pequeño número de acciones a nivel de administrador, como la administración de licencias de usuario, aún requieren una conexión de cuenta personal. Utilice la autenticación de entidad de seguridad de servicio si solo lo necesita para elementos de trabajo, tableros, repositorios o canalizaciones. |
- Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una entidad de servicio
- Creación del registro de la aplicación en Microsoft Entra ID
- Crear un secreto de cliente
- Recopilar los detalles de la conexión
- Añada la entidad de seguridad de servicio a su organización de DevOps de Azure
- Creación de la conexión
Requisitos previos para conectar Azure DevOps a Workfront Fusion mediante una entidad de servicio
Para crear esta conexión, necesita lo siguiente:
- Administrador global o Administrador de aplicaciones tienen acceso a la Microsoft Entra ID para registrar la aplicación. Si no tiene este acceso, pida a alguien de su equipo de TI o de identidad que complete ese paso por usted.
- Administrador de recopilación de proyectos tiene acceso a en su organización de Azure DevOps para agregar la entidad de seguridad de servicio como miembro. A menudo se trata de una persona diferente a la persona que administra el Microsoft Entra ID.
- Nombre de su organización de DevOps de Azure. Puede encontrar esto en su URL de DevOps de Azure:
dev.azure.com/<your organization name>.
Cree el registro de la aplicación en Microsoft Entra ID (entidad de servicio)
- Inicie sesión en el centro de administración de Microsoft Entra.
- Vaya a Registros de aplicaciones > Nuevo registro.
- Asigne a la aplicación un nombre claro y reconocible. Por ejemplo,
Workfront Fusion Azure DevOps Integration. - Deje URI de redireccionamiento en blanco. Esta conexión no implica iniciar sesión a través de un explorador.
- Seleccione Registrar.
- Continuar a Crear un secreto de cliente.
Crear un secreto de cliente
- En el registro de la nueva aplicación, ve a Certificados y secretos.
- Seleccione Nuevo secreto de cliente, agregue una descripción y elija un período de caducidad.
- Seleccione Agregar.
- Copie el Valor del secreto inmediatamente. Se muestra solo una vez. Si se aleja antes de copiarlo, debe crear uno nuevo.
- Continúe a Recopilar sus detalles de conexión.
Recopilar los detalles de conexión (entidad de seguridad de servicio)
-
En la página Información general del registro de la aplicación, tenga en cuenta los siguientes valores. Estos se introducen al crear la conexión en el módulo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Tenant ID En la página Información general, con la etiqueta Directorio (inquilino) ID. Client ID En la página Información general, ID de aplicación (cliente). Client Secret El valor que copió en Crear un secreto de cliente. Organization Nombre de su organización de Azure DevOps. Por ejemplo, si la dirección URL es dev.azure.com/yourorg, escribayourorg.note NOTE Puede omitir el área permisos de API del registro de la aplicación. Si agrega las DevOps de Azure, solo están disponibles permisos delegados. Los permisos de la aplicación aparecen atenuados. Esto es de esperar, ya que Azure DevOps no admite la concesión de acceso de esta manera. En su lugar, el acceso se concede directamente dentro de las operaciones de desarrollo de Azure, en la siguiente parte. -
Continuar a Agregar la entidad de seguridad de servicio a su organización de DevOps de Azure.
Añada la entidad de seguridad de servicio a su organización de DevOps de Azure
Al registrar la aplicación en Microsoft Entra ID, solo se crea su identidad. Todavía no da a la aplicación acceso a los datos de Azure DevOps. Este procedimiento concede ese acceso.
-
Inicie sesión en su organización de DevOps de Azure, en
dev.azure.com/<your organization name>. -
Seleccione Configuración de la organización en la esquina inferior izquierda, luego seleccione Usuarios.
-
Seleccione Agregar usuarios.
-
En el cuadro de búsqueda, busque por el nombre para mostrar de la aplicación, que es el nombre que le dio al registrar la aplicación. No buscar por ID de cliente.
-
Seleccione un nivel de acceso:
- Básico suele ser suficiente para leer y escribir elementos de trabajo, tableros y repositorios.
- Si el flujo de trabajo necesita examinar los procesos disponibles, como Agile, Scrum o plantillas personalizadas, como parte de la configuración, agregue la entidad de seguridad de servicio al grupo Administradores de la colección de proyectos en su lugar. Se trata de un nivel de acceso más amplio, por lo que solo debe otorgarlo si necesita esa capacidad.
-
Asigne el principal de servicio al proyecto o proyectos específicos que necesite, siguiendo las prácticas de acceso habituales de su organización.
-
Seleccione Agregar.
-
Continuar a Crear la conexión en Workfront Fusion.
Crear la conexión en Workfront Fusion (entidad de servicio)
-
En la pantalla de configuración de la conexión del módulo, seleccione el tipo de conexión Service Principal.
-
Introduzca lo siguiente:
- Id. de inquilino
- ID de cliente
- Secreto de cliente
- Organización
-
Guarde la conexión.
Si todo está configurado correctamente, la conexión se valida correctamente.
Módulos de Azure DevOps y sus campos
Al configurar módulos de Azure DevOps, Workfront Fusion muestra los campos que se indican a continuación. Junto a estos, pueden aparecer campos de Azure DevOps adicionales, en función de factores como el nivel de acceso del que disponga en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, consulte Asignar información de un módulo a otro.
Activadores
Ver elementos de trabajo
Este módulo de activador instantáneo ejecuta un escenario cuando se añade, actualiza o elimina un registro en Azure DevOps.
El módulo devuelve cualquier campo estándar asociado con el registro, junto con los campos y valores personalizados a los que accede la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Acciones
Creación de un registro
Este módulo de acción crea un nuevo proyecto o elemento de trabajo.
El módulo genera el ID de objeto para el elemento de trabajo recién creado o la URL y el código de estado de un proyecto recién creado.
Llamada API personalizada
Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Azure DevOps. De este modo, puede crear una automatización del flujo de datos imposibles de realizar por los otros Azure DevOps módulos.
Al configurar este módulo, se muestran los campos siguientes.
Introduzca la dirección URL relativa a la que desea conectarse para esta llamada API.
Ejemplo: {organization}/_apis[/{area}]/{resource}
Añada los encabezados de la solicitud en forma de objeto JSON estándar.
Por ejemplo: {"Content-type":"application/json"}
Añada la consulta para la llamada API en forma de objeto JSON estándar.
Por ejemplo: {"name":"something-urgent"}
Añada el contenido del cuerpo para la llamada API en forma de objeto JSON estándar.
Nota:
Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.
Descargar un archivo adjunto
Este módulo de acción descarga un archivo adjunto.
El módulo devuelve el contenido del archivo adjunto.
Vincular elementos de trabajo
Este módulo de acción vincula dos elementos de trabajo y define la relación entre ellos.
Leer registro
Este módulo de acción lee datos de un único registro en Azure DevOps.
Especifique el identificador del registro.
El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Actualizar un elemento de trabajo
Este módulo de acción actualiza un elemento de trabajo existente mediante su ID.
El módulo devuelve el ID del elemento de trabajo actualizado.
Cargar un archivo adjunto
Este módulo de acción carga un archivo y lo adjunta a un elemento de trabajo.
El módulo devuelve el ID de archivo adjunto y una URL de descarga para el archivo adjunto.
Búsquedas
Lista de elementos de trabajo
Este módulo de acción recupera todos los elementos de trabajo de un tipo específico en un proyecto de Azure DevOps.
El módulo devuelve el ID del elemento de trabajo principal y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.