Integração com Confluence Cloud

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 10 min. de leitura

    • A integração da aplicação Gestão de ativos de software com a aplicação Confluence Cloud permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

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

    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Confluence Cloud Escopos de autenticação
    Download de assinaturas Função do usuário do produto de confluência
    • Ler grupos de usuários (read: confluence-groups)
    • Ler usuário (read:confluence-user)
    Extrair atividade do usuário Função do usuário do produto de confluência Pesquisar resumos de espaço e conteúdo do Confluence (search:confluence)
    Recuperar assinatura administrador do site
    • Ler grupos de usuários (read: confluence-groups)
    • Criar, remover e atualizar grupos de usuários (write:confluence-groups)

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

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

    Antes de Iniciar

    Atlassian Função necessária: consulte a tabela Permissões mínimas do usuário.

    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, selecione o ícone do seu perfil e selecione Console do desenvolvedor.
      A página Meus apps do Atlassian Console do desenvolvedor é aberta.
    4. Selecione o 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 selecione Criar.
    7. Defina as configurações de autorização da sua aplicação.
      1. No painel de navegação esquerdo, selecione Autorização.
      2. Selecione 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 apps é aberta.
      3. No campo URL de retorno de chamada, insira a 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. Selecione 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 selecione Adicionar.
        O botão Adicionar ação muda automaticamente para o botão Configurar ação.
      3. Selecione 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 de espaço
        • Ler grupos de usuários
        • Criar, remover e atualizar grupos de usuários
        • Ler usuário
    9. Recupere o ID 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.

    Obter o valor de ID de nuvem da instância Confluence Cloud

    Obtenha o valor do ID de nuvem da instância de nuvem Confluence Cloud. Este valor é necessário durante a configuração do registro de conexão em sua instância ServiceNow.

    Antes de Iniciar

    Confluence Cloud Função necessária: administrador

    Procedimento

    1. Faça login no Atlassian Administração.
    2. Selecione o botão Selecionar na organização necessária.
    3. Selecione a guia Produtos.
    4. Na página Produtos, selecione Gerenciar produto na linha de produtos do Confluence.

      O URL está no seguinte formato em uma nova janela: https://admin.atlassian.com/o/<orgID> /produtos/conf/<Cloud-Id> .

    5. Copie o valor do ID da nuvem 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 (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

    Importante:
    Você deve marcar a caixa de seleção Spoke do Confluence Cloud para esta integração ao instalar recursos opcionais na página Application Manager. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração Confluence Cloud em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > 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 diretos.
      2. Selecione Novo.
      3. Selecione Confluence Cloud na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 2. Formulário Perfil de integração
      Campo Valor
      Nome para exibição Nome do perfil de integração. Por exemplo, Integração do Confluence Cloud.
      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. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Confluence Cloud.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Atividade do usuário de atualização do Confluence Cloud.
        Nota:
        A caixa de seleção Baixar atividade está marcada por padrão. Se você desmarcar, o trabalho agendado de atividade SAM - Refresh <displayname> Activity não será criado.
        No campo Analisar atividade do usuário, você também pode selecionar a data e a hora a partir de quando deseja analisar a atividade do usuário. 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 Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      3. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Assinatura de recuperação do Confluence Cloud.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Save (Salvar).
      Sua instância ServiceNow cria um perfil de integração de rascunho.

      O campo Conexão e credencial aparece e é definido automaticamente como sn_conflunce_spoke.confluence_subscription_activity_reclaim quando todos os processos são selecionados.

    5. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização ( ícone de visualização) ao lado do campo Conexão e credencial e selecionando Abrir registro na visualização do registro.
    6. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    7. Na caixa de diálogo, preencha os campos.
      Tabela 3. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome O nome da conexão.
      URL de conexão

      URL da API para Confluence Cloud.Este campo é definido automaticamente como https://api.atlassian.com.

      Para Gestão de ativos de software - Gestão de licenças de SaaS versão 15.0.9 e superior, forneça o URL da sua instância Confluence Cloud em https://api.atlassian.com/ex/confluence/ <Cloud-ID formato. Para obter mais informações sobre como obter o valor do ID da nuvem, consulte Obter o valor de ID de nuvem da instância Confluence Cloud.
      ID do cliente do OAuth ID de cliente atribuído à sua aplicação Confluence Cloud OAuth 2.0 (3LO).
      Segredo do cliente do OAuth Segredo do cliente atribuído à sua 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).
    8. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    9. Quando a caixa de diálogo for exibida, conceda permissão à aplicação Confluence Cloud.
      A caixa de diálogo é fechada e você retorna automaticamente ao formulário Aliases de conexão e credencial.
    10. 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 Atlassian Administration.
      2. Faça login na conta de administrador com uma função site_admin.
      3. Selecione o botão Selecionar na organização necessária.
      4. Selecione a guia Produtos.
      5. Na página Produtos, selecione Gerenciar produto na linha de produtos do Confluence.
      6. Exiba a lista de grupos que têm acesso aos produtos do Confluence.
        Anote essas informações para uso posterior.
      7. Retorne à sua instância ServiceNow e navegue até Nuvem de confluência > Grupos de confluência.
      8. No formulário Grupos do Confluence, selecione o link relacionado Adicionar grupos.
        A caixa de diálogo Adicionar grupos do Confluence é aberta.
      9. Selecione a conexão e a credencial que foram definidas no perfil de integração.
      10. 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.
      11. Selecione o botão de seta para a direita para mover os grupos da lista Disponível para a lista Selecionada.
      12. Selecione OK.
    11. Retorne ao seu perfil de integração e selecione o perfil de integração.
    12. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs Baixar assinaturas e Calcular atividade, mas não as APIs Recuperar assinaturas.

    13. Depois que a conexão for verificada, selecione Publicar.
    14. Na caixa de diálogo Confirmação de publicação, selecione OK.
      Nota:
      Se você desmarcar a caixa de seleção Atividade de download após a publicação do perfil de integração, deverá revalidar as conexões e publicar novamente o perfil de integração, pois ocorrem os seguintes eventos:
      • O campo Status no formulário de perfil de integração muda para Rascunho.
      • O botão Validar conexão aparece no formulário.
      • O trabalho SAM - Refresh <displayname> Activity atual é excluído.

    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 software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    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 propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (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 corrigir qualquer não conformidade.