Autenticação do Jira

Conecte a UiPath ao Jira Cloud no Automation Suite usando uma conta Atlassian. As instâncias do Jira Server e do Data Center não são compatíveis.

Antes de usar atividades ou gatilhos do Jira, você deve criar uma conexão com sua instância do Jira Cloud no UiPath Integration Service.

Importante:

O conector Jira é compatível apenas com instâncias do Jira Cloud. Instâncias do Jira Server e do Data Center não são compatíveis.

Métodos de autenticação compatíveis (apenas Jira Cloud)

Tipo de Autenticação	Description	Melhor para
Básica	Usa email e token de API do Atlassian Cloud	Contas de serviço, automações Unattended.
Traga seu próprio aplicativo OAuth 2.0	Usa seu próprio aplicativo OAuth com URL de retorno de chamada da UiPath.	Clientes que gerenciam seus próprios aplicativos e chaves.

Básica

Autentique com o Jira Cloud usando um e-mail de conta do Atlassian e o token de API, transmitido como autenticação básica HTTPS. Saiba mais .

A conexão é executada com o mesmo projeto e permissões de problema que o usuário do Jira configurado.

Campos obrigatórios

Campo	Description
URL do site	A URL do site do Jira, por exemplo https://your-domain.atlassian.net. Observação: inclua "https://" sem "/" no final da URL.
Username	E-mail da conta do Atlassian usado para fazer login no Jira Cloud
Token de API	Token da API do Jira Cloud associado à conta

Como gerar o token de API

1. Crie um token de API (sem escopo) na segurança da conta Atlassian.​ Saiba mais.
2. Copie o token gerado e o mantenha seguro para uso posterior.
3. No UiPath Integration Service, adicione uma conexão ao Jira e preencha:
   • URL do site
   • Username
   • Token de API​​

Ciclo de vida do token

Para sua segurança, os tokens não podem durar mais de um ano e podem ser revogados e excluídos da página de segurança da conta da Atlassian. Depois de excluídas, todas as chamadas do Integration Service que usam esse token falharão com 401 Não autorizado até que um novo token seja configurado.​

Solução de problemas

• 401 Não autorizado: verifique o email e o token, confirme se o token existe e se foi copiado corretamente.​
• 403 Proibido em algumas operações: confirme que o usuário do Jira tem as permissões de projeto necessárias para o projeto de destino e o tipo de problema.​

Perguntas frequentes

Posso limitar um token de API a projetos específicos?
No. Os tokens herdam todas as permissões do usuário; limitar o acesso configurando permissões de usuário/projeto no Jira.​

O captcha ou o SSO afetam as chamadas baseadas em token?
As regras de POTcha e de logon interativo se aplicam ao nome de usuário/senha, não a tokens de API; O SSO ainda rege a conta, mas não bloqueia o uso de token. Saiba mais​.

Como devo rotacionar os tokens usados pela UiPath?
Crie um novo token, atualize a conexão do Jira no UiPath com o novo token, valide as automações e, em seguida, revogue o token antigo.​

Traga seu próprio aplicativo OAuth 2.0

Esse tipo de autenticação requer que você traga seu próprio ID do cliente e credenciais de segredo do cliente.

Siga as diretrizes do Jira para criar seu próprio aplicativo: Aplicativos OAuth 2.0 (3LO). Você pode criar seu aplicativo a partir do console do desenvolvedor do Jira. Ao configurar seu próprio OAuth2.0 Aplicativo certifique-se de fornecer a URL de redirecionamento/retorno como: https://{yourDomain}/provisioning_/callback
Isso é recomendado quando as automações devem ser executadas no contexto de um usuário final e obedecer tanto os escopos do OAuth quanto as permissões de projeto desse usuário.​

Campos obrigatórios

Campo	Description
URL do site	URL do site do Jira, como por exemplo: https://your-domain.atlassian.net. Quando solicitado a conceder as permissões do aplicativo UiPath para acessar o Jira, certifique-se de selecionar a mesma URL do site do Jira.
ID do Cliente	Identificador de cliente para o aplicativo Atlassian OAuth 2.0 (3LO)
Segredo do Cliente	Segredo do aplicativo Atlassian OAuth 2.0 (3LO). Isso será armazenado no banco de dados do UiPath Integration Service.
Redirecionar URL	URL de retorno de chamada da UiPath, configurado exatamente no aplicativo Atlassian
Username	Usado na página de login do Jira
Senha	Usado na página de login do Jira

Compreensão dos escopos do Jira

Os escopos definem o nível de acesso que um aplicativo pode solicitar para interagir com um produto da Atlassian. Quando uma conexão é estabelecida e o usuário autoriza o aplicativo por meio da atividade Jira (por meio da API), o aplicativo OAuth recebe permissão para realizar as operações especificadas em nome do usuário — sujeito às configurações de permissão do usuário. Para obter uma lista completa de escopos disponíveis, consulte a documentação de escopos do Jira .

A tabela a seguir lista os escopos necessários para criar conexões:

Escopo	Tipo	Description
Read:Jira-user	Required	Visualize informações do usuário no Jira às quais o usuário tem acesso, incluindo nomes de usuário, endereços de email e avatares.
ler:jira-work	Required	Leia os dados de projetos e problemas do Jira, pesquise problemas e objetos associados a problemas, como anexos e logs de trabalho.
write:jira-work	Required	Crie e edite problemas no Jira, publique comentários como o usuário, crie logs de trabalho e exclua problemas.
Manage:Jira-project	Required	Criar e editar configurações do projeto e criar novos objetos de nível de projeto (por exemplo, versões e componentes).
acesso_offline	Required	Atualizar token do OAuth automaticamente
Manage:Jira-configuration	Opcional	Realizar ações de administração do Jira (por exemplo, criar projetos e campos personalizados, visualizar fluxos de trabalho e gerenciar tipos de links de problemas).
Manage:Jira-data-provider	Opcional	Gerenciar informações de desenvolvimento e lançamento para terceiros no Jira

Importante:

O aplicativo deve ter todos os escopos que sua conexão está solicitando.

Como gerar credenciais

1. Siga o guia do aplicativo 3LO do Atlassian .
2. Configure a URL de retorno de chamada do UiPath Jira da página de autenticação do Integration Service Jira como o URI de redirecionamento.
3. Selecione os escopos do Jira Cloud que você precisa (por exemplo, read:jira-work, write:jira-work, read:jira-user).
4. Copie o ID do cliente e o Segredo do cliente do aplicativo Atlassian para as configurações de conexão do UiPath Jira.

Ciclo de vida do token

Os tokens de acesso têm vida curta; A UiPath usa tokens de atualização para obter novos tokens de acesso até que o token de atualização expire ou seja revogado.​

Revogar o consentimento ou excluir o aplicativo Atlassian OAuth invalida os tokens e requer uma nova autorização da UiPath.​

Solução de problemas (OAuth)

• Incompatibilidade de URI de redirecionamento: certifique-se de que o URL de redirecionamento configurado no Atlassian corresponda exatamente ao URL de retorno de chamada da UiPath.​

• insufficient_scope ou 403: Adicione ao aplicativo qualquer escopo do Jira ausente e certifique-se de que o usuário tenha as permissões necessárias do Jira.​

Perguntas frequentes

Quais são os escopos mínimos para emitir CRUD?
Varia de um objeto para outro, mas geralmente read:jira-work e write:jira-work para problemas/comentários; adicione read:jira-user se a pesquisa/atribuição de usuário for usada.

Os escopos podem restringir o acesso a projetos específicos?
No. Os escopos são funcionais; o acesso ao nível do projeto ainda é regido pelas permissões do usuário de autorização no Jira.​

Por que ainda estou recebendo 403 após um logon bem-sucedido do OAuth?
Certifique-se de que read:jira-user esteja sendo inferido em seu aplicativo privado.

Adicionar a conexão do Jira

Para criar uma conexão com sua instância do Jira, você precisa realizar as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Jira. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Jira .
4. Selecione um tipo de autenticação.
5. Insira as credenciais necessárias para seu método de autenticação preferido e selecione Conectar.

Permissões

Com acesso à sua conta, o UiPath para Jira Cloud pode:

• Gerenciar configurações:
  • Obter ações de administração do Jira (por exemplo, criar projetos e campos personalizados, visualizar fluxos de trabalho, gerenciar os tipos de links de problemas).
  • Gerencie as informações de desenvolvimento e lançamento para terceiros no Jira.
  • Criar e editar as configurações do projeto e criar novos objetos no nível do projeto (p.ex., versões e componentes).
• Exibir dados:
  • Visualize informações do usuário no Jira às quais o usuário tem acesso, incluindo nomes de usuário, endereços de email e avatares.
  • Leia os dados de projetos e problemas do Jira, pesquise problemas e objetos associados a problemas, como anexos e logs de trabalho.
• Problemas com atualização :
  • Crie e edite problemas no Jira, publique comentários como o usuário, crie logs de trabalho e exclua problemas.