Como integrar com Confluence Cloud

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 7 min. de leitura

    • Você pode integrar sua instância ServiceNow com a aplicação Confluence Cloud para rastrear suas assinaturas de software e recuperar licenças não utilizadas.

    Nota:
    Atualmente, esta integração oferece suporte a apenas uma integração de site por perfil.

    Criar uma aplicação Confluence Cloud OAuth 2.0 (3LO)

    Crie uma aplicação Confluence Cloud OAuth 2.0 (3LO) para permitir o acesso à API Confluence Cloud.

    Antes de Iniciar

    Atlassian Função necessária: administrador do site

    Procedimento

    1. Em um navegador da Web, abra o portal Atlassian Developer.
    2. Faça login na sua conta de administrador do site.
    3. No cabeçalho da página do portal, clique no ícone do seu perfil e selecione Console do desenvolvedor.
      A página Meus apps do Console do desenvolvedor Atlassian é aberta.
    4. Clique no menu Criar app e selecione Integração OAuth 2.0 (3LO).
      A página Criar uma nova integração OAuth 2.0 (3LO) é aberta.
    5. Insira um nome para a aplicação OAuth 2.0 (3LO) no campo Nome.
    6. Marque a caixa de seleção Concordo em estar vinculado aos termos de desenvolvedor da Atlassian e clique em Criar.
      A visão geral e as configurações do app recém-criado são abertas.
    7. Defina as configurações de autorização para sua aplicação.
      1. No painel de navegação esquerdo, selecione Autorização.
      2. Clique em Configurar para o tipo de autorização OAuth 2.0 (3LO).
        A página de concessões de código de autorização OAuth 2.0 (3LO) para aplicativos é aberta.
      3. No campo URL de retorno de chamada, insira o URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.
        Insira https://instance.service-now.com/oauth_redirect.do, em que <instance> é o nome da sua instância ServiceNow.
      4. Clique em Salvar mudanças.
    8. Configure escopos de API para sua aplicação.
      Os escopos de API especificam o nível de acesso que a aplicação tem às Atlassian APIs.
      1. No painel de navegação esquerdo, selecione Permissões.
      2. Na lista de APIs disponíveis, localize a API do Confluence e clique em Adicionar.
        O botão Adicionar ação muda automaticamente para o botão Configurar ação.
      3. Clique em Configurar.
        A página da API do Confluence é aberta.
      4. Adicione os seguintes escopos para a API do Confluence:
        • Pesquisar conteúdo do Confluence e resumos do espaço
        • Ler grupos de usuários
        • Criar, remover e atualizar grupos de usuários
        • Ler usuário
    9. Recupere o ID do cliente e o segredo do cliente atribuídos à sua aplicação.
      1. No painel de navegação esquerdo, selecione Configurações.
      2. Na seção Detalhes da autenticação, copie os valores nos campos ID do cliente e Segredo.
        Salve-os em um local seguro para uso posterior.

    Criação do perfil de Integração Confluence Cloud

    Crie um perfil de integração Confluence Cloud para rastrear assinaturas de software e otimizar o licenciamento de suas aplicações Confluence Cloud.

    Antes de Iniciar

    Para criar um perfil de integração Confluence Cloud, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

    Atlassian Função necessária: administrador do site

    ServiceNow Função necessária: sam_integrator, sn_confluence_spoke.confluence_cloud_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando o Software Asset Workspace, a opção para criar o perfil de integração Confluence Cloud na IU principal ficará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Confluence Cloud.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Confluence Cloud na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 1. Formulário de perfil de integração
      Campo Valor
      Nome de exibição Nome do perfil de integração. Por exemplo, Confluence Cloud Integration.
      Conexão e Credencial Alias de credencial e conexão para Confluence Cloud. Este campo é preenchido automaticamente.
      Status Status do perfil de integração. Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho. Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de Perfil Tipo de perfil de integração. Este campo é definido automaticamente como Assinatura do Confluence Cloud.
    3. Na guia Baixar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Subfluxo de assinaturas de download do Confluence Cloud.
    4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Subfluxo de atividade do usuário de atualização do Confluence Cloud.
      Você também pode selecionar a data e a hora a partir das quais deseja analisar a atividade do usuário no campo Analisar a atividade do usuário a partir de. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
      Você pode modificar este valor no campo Último limite de atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    5. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Subfluxo de assinatura de recuperação do Confluence Cloud.
    6. Clique em Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Confluence Cloud Baixar assinaturas, Confluence Cloud Atualizar atividade do usuário e Confluence Cloud Recuperar assinatura para recuperar dados do usuário da aplicação Confluence Cloud.
    7. Abra o registro dos aliases de conexão e credencial clicando no ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e, em seguida, clicando em Abrir registro na visualização do registro.
    8. No formulário Aliases de conexão e credencial, clique no link relacionado Criar nova conexão e credencial.
    9. Na caixa de diálogo, preencha os campos.
      Tabela 2. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome Nome da conexão.
      URL do local
      Nota:
      Este campo aparecerá somente se você tiver solicitado e instalado as integrações Gestão de ativos de software - Gestão de licenças de SaaS versão 6.0.0 ou anterior.
      		 URL do seu site Confluence Cloud.
      URL de Conexão
      Nota:
      Este campo aparecerá somente se você tiver solicitado e instalado as integrações Gestão de ativos de software - Gestão de licenças de SaaS versão 7.0.0 ou posterior.
      		 URL da API para Confluence Cloud. Este campo é definido automaticamente como https://api.atlassian.com.
      ID do cliente OAuth ID de cliente atribuído à aplicação Confluence Cloud OAuth 2.0 (3LO).
      Segredo do cliente OAuth Segredo do cliente que é atribuído à aplicação Confluence Cloud OAuth 2.0 (3LO).
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação. Este campo é preenchido automaticamente com base no URL de retorno de chamada que você especificou em Criar uma aplicação Confluence Cloud OAuth 2.0 (3LO).
    10. Clique em Criar e obter token do OAuth.
      A caixa de diálogo é fechada e você retorna automaticamente ao formulário Aliases de conexão e credencial.
    11. Especifique os grupos que têm acesso aos produtos do Confluence.
      Ao especificar esses grupos em sua instância ServiceNow, você pode recuperar dados e gerenciar licenças somente para os usuários desses grupos.
      1. Em uma nova guia, abra o portal de administração da Atlassian.
      2. Faça login na sua conta de administrador do site.
      3. Navegar até CONFIGURAÇÕES DO LOCAL > Acesso ao produto.
      4. Na seção Confluence, exiba a lista de grupos que têm acesso aos produtos do Confluence.
        Anote essas informações para uso posterior.
      5. Retorne à sua instância ServiceNow e navegue até Nuvem de confluência > Grupos de confluência.
      6. No formulário Grupos de confluência, clique no link relacionado Adicionar grupos.
        A caixa de diálogo Adicionar grupos de confluência é aberta.
      7. Na lista Disponível, selecione os grupos que têm acesso aos produtos do Confluence.
        Dica:
        A lista Disponível inclui todos os grupos associados à sua conta Atlassian. Selecione somente os grupos que têm acesso aos produtos do Confluence.
      8. Clique no botão de seta para a direita para mover os grupos da lista Disponível para a lista Selecionado.
      9. Clique em OK.
    12. Retorne ao seu perfil de integração navegando até Licença de SaaS > Administração > Perfis de Integração Direta e, em seguida, selecionando o perfil na lista Perfis de integração.
    13. Clique em Publicar.
      A caixa de diálogo Confirmação de publicação é aberta.
    14. Na caixa de diálogo, clique em OK.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de sua propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho programado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licença (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e para corrigir qualquer não conformidade.