Administração e configuração do conector Jira do Smartsheet

O conector Jira do Smartsheet sincroniza as informações entre o Smartsheet e uma ou mais instâncias do Jira criando fluxos de trabalho.

O conector Jira do Smartsheet está disponível como uma oferta premium. Entre em contato com a nossa equipe de vendas para obter informações sobre preços.

Se você adquiriu o conector Jira do Smartsheet no seu plano, faça o login para criar fluxos de trabalho entre o Smartsheet e o Jira.

Faça login no conector Jira do Smartsheet

Terminologia e tipos de permissão

• Conexão: o link entre o Smartsheet e uma instância específica do Jira.
• Fluxo de trabalho: o link dentro do conector Jira que conecta os elementos do Jira a uma planilha do Smartsheet.

Existem três tipos de permissões para os usuários interagirem com o conector Jira do Smartsheet:

• Administrador de sistema do Smartsheet: gerencia os administradores e usuários do conector Jira pelo aplicativo Smartsheet. Os administradores de sistema também podem habilitar uma configuração para restringir o acesso ao conector.
• Administrador do conector Jira: estabelece a conexão entre uma instância do Jira e o conector Jira do Smartsheet.
• Usuário do conector Jira: pode criar fluxos de trabalho para sincronizar informações entre o Smartsheet e o Jira.

Recursos por tipo de permissão

A tabela a seguir mostra quais permissões são necessárias para concluir tarefas específicas usando o conector Jira.

 *Administradores de sistema do Smartsheet e administradores do conector podem criar e editar seus fluxos de trabalho se o recurso para restringir lista de acesso estiver habilitado. Se o administrador de sistema ativar a configuração Restringir usuários no conector Jira, você também deverá manter a função de usuário do Jira no Smartsheet. Saiba mais sobre como restringir o acesso.

Configuração de conexão

Primeiro configure a conexão entre o Smartsheet e a instância do Jira de modo que os usuários possam criar fluxos de trabalho para conectar elementos no Smartsheet e no Jira. O conector Jira do Smartsheet é compatível com o Jira Cloud e as versões v6.x a v10.x do servidor do Jira e do Jira Data Center.

Estabeleça a conexão usando uma conta de e-mail licenciada genérica (smartsheet-jira@seudominio.com) para o Smartsheet e o Jira. Isso evita a necessidade de refazer conexões ou fluxos de trabalho caso a pessoa que gerencia o link do Jira saia da organização, pois não é possível alterar a propriedade da conexão.

Pré-requisitos

Para configurar a conexão entre o Smartsheet e o Jira, é preciso ter as seguintes permissões:

No Jira:

• Administrador de sistema do Jira (administrador de produto ou de organização)

No Smartsheet:

• Usuário licenciado do Smartsheet (modelo legado) ou membro (modelo de usuário)
• Função de administrador de sistema do Smartsheet ou função de administrador do conector Jira do Smartsheet

Apenas a função de administrador de sistema do Smartsheet OU de administrador do conector Jira do Smartsheet é necessária. A Smartsheet recomenda ter as duas funções para configurar o conector.

Como o conector Jira do Smartsheet permite fluxos de trabalho automáticos, o aplicativo deve ter credenciais de administrador de sistema do Jira para criar ou configurar um webhook por meio da API REST do Jira. As credenciais do administrador de sistema do Jira são usadas apenas para criar e configurar webhooks.

A conta usada para a configuração deve permanecer ativa com direitos de administrador no Jira e no Smartsheet. A remoção do status de administrador deste usuário aciona um erro: ausência de credenciais de usuário neste ponto de extremidade. A restauração das permissões de administrador corrige a conexão e retoma a sincronização normal do fluxo de trabalho. Se as credenciais de administrador do Jira forem removidas, você deverá recriar o link do aplicativo devido a alterações de token.

As etapas de configuração da conexão para OAuth 1.0 e OAuth 2.0 são um pouco diferentes, mas ambas exigem um novo servidor Jira no conector Jira do Smartsheet.

Você deve ter permissões de administrador do Jira para configurar uma conexão.

Registrar um novo servidor Jira no conector Jira do Smartsheet

Defina as configurações de firewall e gerais antes de estabelecer essa conexão.

1. Faça login no conector Jira do Smartsheet. Se for solicitado acesso à sua conta do Smartsheet, selecione Permitir.
2. Clique no menu superior esquerdo e selecione Administração da conta.
3. Selecione Registrar novo servidor do Jira.
4. Na página de Configurações:
   1. Insira o URL do host do JIRA do ambiente Jira que você deseja conectar ao seu ambiente Smartsheet (https://mbfcorp.atlassian.net/). 
   2. O URL da API do JIRA é provavelmente o mesmo do seu host do JIRA. 
   3. Em Nome, aceite o nome padrão ou altere-o para um descritor mais útil. 
   4. Selecione sua versão do JIRA.
5. Depois de definir esses itens na página de Configurações, selecione Continuar.
6. Na página de Configuração, consulte a Chave do consumidor, o Nome do consumidor e a Chave pública. Copie essas informações, pois você as usará nas etapas a seguir.

Configuração da conexão: OAuth 1.0

Etapa 1: crie um link de aplicativo (AppLink) para o Smartsheet no Jira

1. Entre no Jira (você precisa de permissões de administrador).

2. Acesse Configurações> Produtos.
    

   Brandfolder Image

   

3. Na barra lateral Produtos, em Integrações, selecione Links do aplicativo.

   Em versões anteriores do Jira hospedado no servidor, selecione Configurações > Aplicativos e clique em Links do aplicativo.

   Brandfolder Image

   
4. Selecione Criar link; uma caixa pop-up Criar link é exibida. Preencha os campos da seguinte forma:

   • No Jira Cloud, selecione Link direto do aplicativo e insira https://app.smartsheet.com como o URL do aplicativo. Em seguida, selecione Avançar.

     Brandfolder Image

     

   • Nas versões 9 e posteriores do Jira auto-hospedado, selecione Produto da Atlassian e acesse https://app.smartsheet.com como o URL do aplicativo. Em seguida, selecione Continuar.

     Brandfolder Image

     
5. Se alguma das mensagens a seguir aparecer, selecione Continuar e deixe o novo URL inalterado.
   • Se você não recebeu uma resposta do URL inserido, ele pode não ser válido. Se necessário, corrija o URL abaixo e selecione Continuar.
   • O URL do aplicativo informado foi redirecionado uma vez. Verifique o campo do URL redirecionado para garantir que seja um URL confiável.
6. Agora, uma caixa pop-up Revisar link ou Aplicativos de link será exibida. Preencha os campos da seguinte forma:
   • Na caixa Nome do aplicativo, digite Smartsheet.
   • Em Tipo de aplicativo, aceite o valor padrão de Aplicativo genérico.
   • Para a versão 9 ou posterior do Jira auto-hospedado, marque a caixa Criar link de entrada.

   • Selecione Continuar.

     Brandfolder Image

     

Etapa 2: edite o link do aplicativo

1. Para o link do aplicativo criado na Etapa 2, selecione o menu de três pontos que é exibido quando você passa o cursor sobre o link do aplicativo ou selecione o ícone Editar (dependente da versão). 

2. Uma caixa pop-up Configurar é exibida. Selecione Autenticação de entrada.
    

   Brandfolder Image

   
3. Preencha os campos da seguinte forma: 
   • Nome do prestador de serviços (se necessário): Smartsheet.
   • Nome do consumidor: cole o Nome do consumidor que você copiou do conector Jira na Etapa 1.
   • Chave do consumidor: cole a Chave do consumidor que você copiou do conector Jira na Etapa 1.
   • Chave pública/segredo compartilhado: cole a Chave pública que você copiou do conector Jira na Etapa 1.
   • Descrição: adicione uma descrição conforme desejado.
   • Se Solicitar URL do token, Acessar URL do token ou Autorizar URL forem necessários no seu ambiente Jira, use este URL para preencher esses campos: https://api.smartsheet.com/2.0/token.
4. Na parte inferior de Autenticação de entrada, selecione Salvar e, em seguida, Fechar no canto inferior direito.

Etapa 3: conclua a conexão do Jira com o Smartsheet

1. Volte à configuração do conector Jira do Smartsheet (ainda deve estar na página de Configuração em que você copiou as chaves) e selecione Continuar.
2. Na tela Conectar, selecione Conectar para concluir a conexão no lado do Smartsheet.
3. Uma tela de diálogo pergunta se você permite que o Smartsheet tenha acesso de leitura e redação no seu ambiente do Jira. Selecione Permitir. 

Sua conexão entre o Smartsheet e o Jira já está configurada! Os usuários licenciados ou membros da sua conta já podem criar fluxos de trabalho entre itens no Jira e planilhas no Smartsheet. 

Você pode conectar vários ambientes do Jira à sua conta do Smartsheet com o conector Jira do Smartsheet. Repita as instruções acima para cada instância adicional do Jira que quiser registrar. 

Configuração da conexão: OAuth 2.0

Você pode criar até três conexões por instância do Jira Cloud com o OAuth2.0.

Etapa 1: configure um link de aplicativo para conectores no Jira

1. Crie e configure um link de aplicativo de entrada no Jira seguindo a documentação da Atlassian. Forneça os seguintes detalhes ao configurar o link:
   1. Nome: insira um nome descritivo de sua escolha para o link.
   2. URL de redirecionamento: https://connectors.test.smartsheet.com/c/jira/signInCallback
   3. Permissão: selecione Administrador de sistema na lista suspensa de permissões.

Etapa 2: crie um link de aplicativo (AppLink) para o Smartsheet no Jira

1. Entrar no Jira
2. Acesse Configurações do Jira > Aplicativos.
3. Na barra lateral Aplicativos, em Integrações, selecione Links de aplicativos.

Se você não vir Aplicativos em Configurações, acesse Produtos e, na barra lateral Produtos, encontrará Links de aplicativos em Integrações.

4. Selecione Criar link. Uma caixa Criar link será exibida. Preencha os campos da seguinte forma:
   • Selecione Aplicativo externo como Tipo de aplicativo
   • Selecione Entrada como Direção
5. Selecione Continuar.
6. Configure um link de entrada; preencha os campos da seguinte forma:
   • Em Nome, adicione um descritor útil
   • URL de redirecionamento: {smartsheet-host}/c/jira/signInCallback
   • Em Permissão de aplicativo, selecione Administrador de sistema
7. Selecione Salvar.

Ao concluir essas etapas, você obtém o ID do cliente e o Segredo do cliente. Copie ambos antes das etapas a seguir.

Etapa 3: conclua a conexão do Jira com o Smartsheet

1. Retorne ao Conector Jira do Smartsheet.
2. Preencha o ID do cliente e o Segredo do cliente com os valores copiados na etapa anterior.
3. Selecione Continuar.
4. Na tela Conectar, selecione Conectar para concluir a conexão no lado do Smartsheet.

Uma tela de diálogo pergunta se você permite que o Smartsheet tenha acesso de leitura e gravação no seu ambiente do Jira. Selecione Permitir.

Restringir o acesso ao conector Jira do Smartsheet

Se você quiser restringir ainda mais quem pode criar fluxos de trabalho no conector Jira do Smartsheet, poderá restringir o acesso a determinados usuários licenciados ou membros em sua conta. O que você pode fazer no conector Jira sempre depende de quais permissões você tem sobre os itens tanto no Smartsheet (permissões de compartilhamento de planilhas) quanto no Jira (permissões de leitura/gravação no campo do problema), independentemente da existência de restrições adicionais habilitadas.

O conector respeita as permissões concedidas no Jira e no Smartsheet. Por exemplo, suponha que a pessoa que criou um fluxo de trabalho no conector não tenha permissão para editar dados específicos do projeto no Jira. Nesse caso, o fluxo de trabalho não pode editar os dados desse projeto por meio do conector.

Para restringir o acesso

O administrador de sistema do Smartsheet/Jira pode ativar a configuração Restringir acesso para limitar quem pode criar fluxos de trabalho com o conector Jira.

1. Entre no conector Jira do Smartsheet com as suas credenciais do Smartsheet.
2. Selecione no ícone de menu no canto superior esquerdo da página e, em seguida, selecione Gerenciamento de usuários.

3. Marque a caixa de seleção Restringir quais usuários podem acessar a integração JIRA do Smartsheet. 

   Brandfolder Image

   
4. Adicione o endereço de e-mail de qualquer pessoa a quem você queira conceder acesso ao conector.

Para remover o acesso

Todos os usuários removidos da lista não podem criar ou editar os fluxos de trabalho.

1. Entre no conector Jira do Smartsheet com as suas credenciais do Smartsheet.
2. Acesse Gerenciamento de usuários.
3. Selecione o ícone Excluir à direita das informações da conta dessa pessoa.