Módulos do Azure DevOps
Em um cenário do Adobe Workfront Fusion, é possível automatizar fluxos de trabalho que usam Azure DevOps, bem como conectá-lo a vários aplicativos e serviços de terceiros.
Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo.
Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.
Requisitos de acesso
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront |
Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration Workfront Ultimate Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion. |
| Licenças do Adobe Workfront |
Padrão Trabalho ou maior |
| Licença do Adobe Workfront Fusion |
Baseado em operação: disponível para organizações com licenças baseadas em operação Baseado em conector (legado): Workfront Fusion for Work Automation and Integration |
| Produto | Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.
Pré-requisitos
Para usar módulos do Azure DevOps, você deve ter uma conta DevOps do Azure.
Informações da API Azure DevOps
O conector DevOps do Azure usa o seguinte:
Conectar o Azure DevOps ao Workfront Fusion connect-azure-devops-to-workfront-fusion
Conectar o Azure DevOps ao Adobe Workfront Fusion usando uma conexão federada
Uma conexão federada funciona como a conexão principal de serviço, exceto por não usar um segredo de cliente.
Em vez de armazenar um segredo, você informa ao Microsoft Entra ID para confiar em tokens que o Workfront Fusion emite para uma conexão específica. Quando a conexão é executada, o Fusion apresenta uma prova de identidade de curta duração e o Microsoft Entra ID retorna um token de acesso. Como não há segredo do cliente, não há nada que expire e nenhum segredo para girar ou armazenar.
| note |
|---|
| NOTE |
|
- Pré-requisitos para conectar o Azure DevOps ao Workfront Fusion usando uma conexão federada
- Criar o registro do aplicativo na Microsoft Entra ID (Federated connection)
- Coletar detalhes da conexão (Conexão federada)
- Criar a conexão no Workfront Fusion (conexão Federada)
- Adicionar a credencial federada na Microsoft Entra ID
- Verificar a conexão (Conexão federada)
Pré-requisitos para conectar o Azure DevOps ao Workfront Fusion usando uma conexão federada
Para criar essa conexão, você precisa do seguinte:
- Acesso de Administrador Global ou Administrador de Aplicativos no Microsoft Entra ID, para registrar o aplicativo e adicionar a credencial federada. Se você não tiver esse acesso, peça a alguém da sua equipe de TI ou de identidade que conclua essas etapas para você.
- Acesso de Administrador da Coleção de Projetos na sua organização de DevOps da Azure para adicionar a entidade de serviço como membro. Geralmente, essa é uma pessoa diferente da que gerencia a Microsoft Entra ID.
- O nome da sua organização DevOps da Azure. Você pode encontrar isso na URL do Azure DevOps:
dev.azure.com/<your organization name>.
Criar o registro do aplicativo na Microsoft Entra ID (Federated connection)
- Faça logon no centro de administração do Microsoft Entra.
- Acesse Registros do aplicativo > Novo registro.
- Dê ao aplicativo um nome claro e reconhecível. Por exemplo,
Workfront Fusion Azure DevOps Integration. - Deixe o URL de redirecionamento em branco. Essa conexão não envolve fazer logon por meio de um navegador.
- Selecione Registrar.
- Não crie um segredo de cliente. Uma conexão federada não usa uma.
- Prossiga para Coletar detalhes da conexão.
Coletar detalhes da conexão (Conexão federada)
-
Na página Visão geral do registro do aplicativo, observe os seguintes valores. Você os insere ao criar a conexão no módulo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header ID de Locatário Na página Visão Geral, rotulada ID do Diretório (locatário). Client ID Na página Visão Geral, rotulada ID do Aplicativo (cliente). Organização O nome de sua organização Azure DevOps. Por exemplo, se a URL for dev.azure.com/yourorg, digiteyourorg. -
Continue em Criar a conexão no Workfront Fusion.
| note |
|---|
| NOTE |
| Assim como na conexão da entidade de serviço, você pode ignorar a área de permissões da API do registro do aplicativo. O acesso ao Azure DevOps é concedido dentro do Azure DevOps, no próximo procedimento. |
Criar a conexão no Workfront Fusion (conexão Federada)
-
Na tela de configuração de conexão do módulo, selecione o tipo de conexão federada.
-
Insira o seguinte:
- ID do inquilino
- ID do cliente
- Organização
-
Selecione Criar.
O Workfront Fusion exibe três valores. Deixe esta página aberta, pois esses valores serão necessários posteriormente no processo de criação da conexão.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Emissor https://oidc.automations.adobe.com.Assunto Isso identifica essa conexão. Parece com fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. É diferente para cada conexão criada.Público-alvo api://AzureADTokenExchange.note important IMPORTANT Não feche o painel nem selecione Cancelar. A conexão não é concluída até que você conclua o resto do procedimento. Se fechar o painel, você deverá excluir a conexão e iniciar novamente, pois uma nova conexão recebe um novo Assunto. -
Copie o valor Assunto.
-
Continue para Adicionar a credencial federada na Microsoft Entra ID.
Adicionar a credencial federada na Microsoft Entra ID
Esse procedimento substitui o segredo do cliente. Ele instrui o Microsoft Entra ID a aceitar tokens que o Workfront Fusion emite para essa conexão única.
-
Em uma nova guia do navegador, retorne ao centro de administração do Microsoft Entra e abra o registro do aplicativo.
-
Acesse Certificados e segredos > Credenciais federadas.
-
Selecione Adicionar credencial.
-
No cenário de Credencial federada, selecione Outro emissor.
-
Insira o seguinte:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Emissor https://oidc.automations.adobe.comIdentificador de Assunto O Assunto copiado do Workfront Fusion. Cole exatamente, sem espaços adicionados. Name Um nome que identifica esta conexão, para que você possa localizá-la posteriormente. Por exemplo, workfront-fusion-connection-28964.Público-alvo api://AzureADTokenExchange. Isso geralmente é preenchido para você. Deixe o valor padrão. -
Clique em Adicionar.
-
Continue em Verificar a conexão.
| note |
|---|
| NOTE |
| A Entra ID da Microsoft permite no máximo 20 credenciais federadas em um único registro de aplicativo, e o identificador de Assunto deve corresponder exatamente. Curingas não são aceitos. Como cada conexão do Workfront Fusion tem seu próprio Subject, cada conexão precisa de sua própria credencial federada. Se você espera mais de 20 conexões, registre mais de um aplicativo e espalhe as conexões entre eles. |
Verificar a conexão (Conexão federada)
-
Retorne à guia do navegador Workfront Fusion, onde o painel de conexão ainda está aberto.
-
Clique em Salvar.
- Se tudo estiver configurado corretamente, a conexão será validada com êxito e você poderá continuar a configuração do módulo.
- Se a verificação falhar, o painel permanecerá aberto e exibirá o erro. Corrija o problema no Microsoft Entra ID ou no Azure DevOps e selecione Salvar novamente. Não é necessário recriar a conexão, e o Assunto não é alterado.
| note |
|---|
| NOTE |
| Uma credencial federada adicionada na Microsoft Entra ID pode levar algum tempo para se tornar ativa. Se a verificação falhar imediatamente após adicionar a credencial, aguarde um minuto e selecione Salvar novamente antes de investigar mais. |
Solução de problemas
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Falha na verificação da conexão com um cliente inválido ou erro de solicitação inválido | A Microsoft Entra ID não pôde corresponder o token a uma credencial federada. Verifique se o Emissor é exatamente https://oidc.automations.adobe.com sem barra à direita e se o identificador de Assunto é idêntico caractere por caractere ao Assunto mostrado no Workfront Fusion. Um Assunto copiado de uma conexão diferente é a causa mais comum. |
| A conexão é verificada, mas os módulos retornam 401 ou 403 do Azure DevOps | A identidade é confiável, mas não tem acesso aos dados DevOps do Azure. Confirme que você concluiu Adicionar a entidade de serviço à sua organização de DevOps da Azure e que ela está atribuída ao projeto específico que o módulo usa. |
| Não é possível adicionar outra credencial federada | Você atingiu o limite de 20 credenciais federadas para esse registro de aplicativo. Registre um aplicativo adicional e crie outras conexões com ele. |
Conectar o Azure DevOps ao Workfront Fusion usando o EntraApp
É possível conectar o Azure DevOps ao Workfront Fusion usando o EntraApp.
-
Adicione um módulo Azure DevOps ao seu cenário.
-
Clique em Adicionar ao lado do campo Conexão.
-
No campo Tipo de Conexão, selecione o tipo de conexão que deseja usar.
note NOTE O Azure DevOps (EntraApp) permite solicitar todos os escopos para a conexão. -
Preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Connection name Insira um nome para a conexão que você está criando. Organização Digite o nome da organização sob a qual você criou o aplicativo Azure DevOps. ID do Aplicativo Insira a ID do aplicativo DevOps ao qual você está se conectando. Client Secret Insira o segredo do cliente para os aplicativos DevOps aos quais você está se conectando. Solicitar Todos os Escopos Se você estiver usando o tipo de conexão Azure DevOps (EntraApp), habilite essa opção para solicitar todos os escopos para a conexão. -
Para inserir uma ID de Aplicativo DevOps da Azure ou um Segredo do Cliente, clique em Mostrar configurações avançadas e insira-as nos campos abertos.
-
Clique em Continuar para concluir a configuração da conexão e continuar criando seu cenário.
Conectar o Azure DevOps ao Workfront Fusion usando uma entidade de serviço
Você pode criar uma conexão que use uma entidade de serviço (uma conexão da API do aplicativo) em vez de uma conta pessoal. Isso é útil quando você deseja que a conexão seja executada como uma identidade de aplicativo ou serviço, em vez de uma pessoa específica. Isso pode ser útil para que a integração não seja interrompida se, por exemplo, essa pessoa sair da empresa ou alterar a senha.
Esse tipo de conexão está disponível para todos os módulos DevOps do Azure.
| note |
|---|
| NOTE |
| A autenticação da entidade de serviço não dá suporte a todos os recursos DevOps do Azure. Um pequeno número de ações de nível administrativo, como o gerenciamento de licenças de usuário, ainda requer uma conexão com a conta pessoal. Use a autenticação da entidade de serviço se você só precisar dela para itens de trabalho, quadros, repositórios ou pipelines. |
- Pré-requisitos para conectar o Azure DevOps ao Workfront Fusion usando uma entidade de serviço
- Criar o registro do aplicativo na Microsoft Entra ID
- Criar um segredo do cliente
- Coletar detalhes da conexão
- Adicionar a entidade de serviço à sua organização de DevOps da Azure
- Criar a conexão
Pré-requisitos para conectar o Azure DevOps ao Workfront Fusion usando uma entidade de serviço
Para criar essa conexão, você precisa do seguinte:
- Acesso de Administrador Global ou Administrador de Aplicativos na Microsoft Entra ID para registrar o aplicativo. Se você não tiver esse acesso, peça a alguém da sua equipe de TI ou de identidade para concluir essa etapa para você.
- Acesso de Administrador da Coleção de Projetos na sua organização de DevOps da Azure, para adicionar a entidade de serviço como membro. Geralmente, essa é uma pessoa diferente da que gerencia a Microsoft Entra ID.
- O nome da sua organização DevOps da Azure. Você pode encontrar isso na URL do Azure DevOps:
dev.azure.com/<your organization name>.
Criar o registro do aplicativo na Microsoft Entra ID (Entidade de serviço)
- Entre no centro de administração Microsoft Entra.
- Ir para Registros de aplicativo > Novo registro.
- Dê ao aplicativo um nome claro e reconhecível. Por exemplo,
Workfront Fusion Azure DevOps Integration. - Deixe URI de redirecionamento em branco. Essa conexão não envolve fazer logon por meio de um navegador.
- Selecione Registrar.
- Continue em Criar um segredo de cliente.
Criar um segredo do cliente
- No novo registro do aplicativo, acesse Certificados e segredos.
- Selecione Novo segredo do cliente, adicione uma descrição e escolha um período de expiração.
- Selecione Adicionar.
- Copie o Valor do segredo imediatamente. É exibido apenas uma vez. Se você navegar para fora antes de copiá-lo, deverá criar um novo.
- Prossiga para Coletar detalhes da conexão.
Coletar seus detalhes de conexão (Entidade de serviço)
-
Na página Visão geral do registro do aplicativo, observe os seguintes valores. Você os insere ao criar a conexão no módulo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header ID de Locatário Na página Visão Geral, rotulada ID do Diretório (locatário). Client ID Na página Visão Geral, rotulada ID do Aplicativo (cliente). Client Secret O valor copiado em Criar um segredo de cliente. Organização O nome de sua organização Azure DevOps. Por exemplo, se a URL for dev.azure.com/yourorg, digiteyourorg.note NOTE Você pode ignorar a área Permissões de API do registro de aplicativo. Se você adicionar Azure DevOps lá, somente Permissões delegadas estarão disponíveis. Permissões de aplicativo aparecem esmaecidas. Isso é esperado, pois o Azure DevOps não oferece suporte à concessão de acesso dessa maneira. Em vez disso, o acesso é concedido diretamente no Azure DevOps, na próxima parte. -
Continue em Adicionar a entidade de serviço à sua organização de DevOps da Azure.
Adicionar a entidade de serviço à sua organização de DevOps da Azure
Registrar o aplicativo na Microsoft Entra ID cria apenas sua identidade. Ele ainda não dá ao aplicativo acesso aos dados de DevOps do Azure. Esse procedimento concede esse acesso.
-
Faça logon na sua organização Azure DevOps, em
dev.azure.com/<your organization name>. -
Selecione Configurações da organização no canto inferior esquerdo e selecione Usuários.
-
Selecione Adicionar usuários.
-
Na caixa de pesquisa, pesquise pelo nome de exibição do aplicativo, que é o nome que você deu a ele ao registrar o aplicativo. Não pesquise pela ID do cliente.
-
Selecione um nível de acesso:
- Básico geralmente é suficiente para ler e gravar itens de trabalho, quadros e repositórios.
- Se o fluxo de trabalho precisar procurar processos disponíveis, como modelos Agile, Scrum ou personalizados, como parte da configuração, adicione a entidade de serviço ao grupo Administradores da Coleção de Projetos. Esse é um nível mais amplo de acesso, portanto, conceda-o somente se você precisar desse recurso.
-
Atribua o principal de serviço ao projeto ou projetos específicos de que ele precisa, seguindo as práticas de acesso comuns da sua organização.
-
Selecione Adicionar.
-
Continue em Criar a conexão no Workfront Fusion.
Criar a conexão no Workfront Fusion (Entidade de serviço)
-
Na tela de configuração de conexão do módulo, selecione o tipo de conexão Entidade de Serviço.
-
Insira o seguinte:
- ID do inquilino
- ID do cliente
- Segredo do cliente
- Organização
-
Salve a conexão.
Se tudo estiver configurado corretamente, a conexão será validada com êxito.
Azure DevOps módulos e seus campos
Ao configurar módulos do Azure DevOps, o Workfront Fusion exibe os campos listados abaixo. Junto com eles, outros campos do Azure DevOps podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.
Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro.
Acionadores
Fique atento aos itens de trabalho
Este módulo de disparador instantâneo executa um cenário quando um registro é adicionado, atualizado ou excluído no Azure DevOps.
O módulo retorna quaisquer campos padrão associados ao registro, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Ações
Criar um registro
Este módulo de ação cria um novo projeto ou item de trabalho.
O módulo gera a ID do objeto para o item de trabalho recém-criado ou o URL e o código de status de um projeto recém-criado.
Chamada de API personalizada
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API do Azure DevOps. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Azure DevOps.
Ao configurar esse módulo, os campos a seguir são exibidos.
Insira o URL relativo ao qual você deseja se conectar para esta chamada de API.
Exemplo: {organization}/_apis[/{area}]/{resource}
Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.
Por exemplo, {"Content-type":"application/json"}
Adicione a consulta para a chamada de API na forma de um objeto JSON padrão.
Por exemplo: {"name":"something-urgent"}
Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão.
Observação:
Ao usar instruções condicionais, como if em seu JSON, coloque as aspas fora da instrução condicional.
Baixar um anexo
Este módulo de ação baixa um anexo.
O módulo retorna o conteúdo do arquivo do anexo.
Vincular itens de trabalho
Esse módulo de ação vincula dois itens de trabalho e define a relação entre eles.
Ler registro
Este módulo de ação lê dados de um único registro em Azure DevOps.
Especifique a ID do registro.
O módulo retorna a ID do registro e todos os campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Atualizar um item de trabalho
Este módulo de ação atualiza um item de trabalho existente usando sua ID.
O módulo retorna a ID do item de trabalho atualizado.
Carregar um anexo
Este módulo de ação carrega um arquivo e o anexa a um item de trabalho.
O módulo retorna a ID do anexo e um URL de download para o anexo.
Pesquisas
Listar itens de trabalho
Este módulo de ação recupera todos os itens de trabalho de um tipo específico em um projeto Azure DevOps.
O módulo retorna a ID do item de trabalho principal e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.