Autenticação do Jira

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
Token de API (Basic sobre HTTPS)	Usa email e token de API do Atlassian Cloud	Contas de serviço, automações Unattended.
OAuth 2.0	Usa login e consentimento do usuário com escopos do Jira Cloud	Fluxos delegados por usuário, assistidos ou pessoais.
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 aplicativo e chaves do Jira.

Token de API (Basic sobre HTTPS)

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 é semelhante ao Código de autorização do OAuth 2.0, mas 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://cloud.uipath.com/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, 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 logon do Jira.
Senha	Usado na página de logon 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
Ler: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.
Gravar: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.

Código de autorização do OAuth 2.0

O método de código de autorização OAuth 2.0 no UiPath Integration Service é funcionalmente idêntico a Traga seu próprio aplicativo OAuth 2.0 (BYOA) em como os tokens são obtidos e como as atividades são executadas no Jira Cloud. A principal diferença está em quem possui as credenciais do aplicativo OAuth:

• O código de autorização do OAuth 2.0 usa o próprio aplicativo público registrado da UiPath para o Jira Cloud com escopos pré-configurados limitados.
  • Isso significa que o ID do cliente e o Segredo do cliente são gerenciados pela UiPath e não são exigidos do usuário.
  • Você só precisa fornecer a URL do seu site do Jira e selecionar os escopos desejados durante a configuração da conexão.
  • O restante da experiência de autenticação, incluindo login do usuário, consentimento e gerenciamento de token, é a mesma que para um aplicativo personalizado.
• O BYOA ( traga seu próprio OAuth ) permite que as organizações registrem e gerenciem seus próprios aplicativos OAuth 2.0 com a Atlassian.
  • O usuário ou o administrador deve fornecer o ID do Cliente, o Segredo do Cliente e o URL de retorno de chamada de acordo.​
  • Use BYOA se você precisar de um aplicativo privado para sua organização, quiser gerenciar suas próprias chaves ou precisar impor a governança na configuração do cliente do OAuth.​

Não há diferença nos escopos necessários, fluxo de consentimento ou nos recursos disponíveis; ambos usam o OAuth de 3 versões do Atlassian para adquirir tokens de acesso concedidos pelo usuário para o Jira Cloud. A única distinção é se você está usando a integração pública da UiPath (sem credenciais do cliente necessária) ou seu próprio aplicativo Atlassian OAuth (credenciais necessárias na configuração).