Integração com Confluence Cloud

Integrando seu Software Asset Management aplicação com Confluence Cloud a aplicação 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 à 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 de usuário necessária no Confluence Cloud aplicação	Escopos de autenticação
Download de assinaturas	Função do usuário para o produto de confluência	Grupos de usuários de leitura (read:confluence-groups) Usuário de leitura (read:Confluence-user)
Extrair atividade do usuário	Função do usuário para o produto de confluência	Pesquisar resumos de conteúdo e espaço do Confluence (pesquisa:confluência)
Recuperar assinatura	administrador do site	Grupos de usuários de leitura (read:confluence-groups) Criar, remover e atualizar grupos de usuários (write:confluence-groups)

Crie um Confluence Cloud Aplicação OAuth 2,0 (3LO)

Crie um Confluence Cloud OAuth 2,0 (3LO) para habilitar o acesso ao Confluence Cloud API.

Antes de Iniciar

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

Procedimento

1. Em um navegador da web, abra o. Portal do desenvolvedor Atlassian .
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, em seguida, selecione Console do desenvolvedor .
   A página Meus apps do Atlassian O console do desenvolvedor é aberto.
4. Selecione Criar app e selecione Integração do OAuth 2,0 (3LO) .
   A página de integração Criar um novo OAuth 2,0 (3LO) é aberta.
5. Insira um nome para a aplicação OAuth 2,0 (3LO) no Nome campo.
6. Selecione Concordo em estar vinculado aos termos do desenvolvedor da Atlassian e, em seguida, selecione Criar .
7. Defina as configurações de autorização para 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 Concessões de código de autorização do OAuth 2,0 (3LO) para apps é aberta.
   3. Em URL de retorno de chamada , insira o URL do provedor de OAuth para o qual os usuários são redirecionados após a autenticação.
      Insira https:// instância .service-now.com/oauth_redirect.do , em que > instância > é o nome do seu ServiceNow instância.
   4. Selecione Salvar mudanças.
8. Configure escopos de API para sua aplicação.
   Os escopos da API especificam o nível de acesso que a aplicação tem ao 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 .
      . Adicionar o botão de ação muda automaticamente para Configurar botão de ação.
   3. Selecione Configurar.
      A página API do Confluence é aberta.
   4. Adicione os seguintes escopos para a API do Confluence:
      • PESQUISE resumos de espaço e conteúdo do Confluence
      • Grupos de usuários de leitura
      • Crie, remova e atualize grupos de usuários
      • Usuário de leitura
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 em ID do cliente e. Segredo campos.
      Salve-os em um local seguro para uso posterior.

Obtenha o valor do ID da nuvem de Confluence Cloud instância

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

Antes de Iniciar

Confluence Cloud Função necessária: administrador

Procedimento

1. Faça login em Administração Atlassian .
2. Selecione Selecione na organização necessária.
3. Selecione Produtos .
4. Na página Produtos, selecione Gerencie o produto Na linha do produto Confluence.

   O URL está no seguinte formato em uma nova janela: https://admin.atlassian.com/o/<orgID>/products/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 Confluence Cloud perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para o. Confluence Cloud aplicações.

Antes de Iniciar

Para criar um Confluence Cloud perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do 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 selecionar Spoke da Confluence Cloud caixa de seleção desta integração ao instalar recursos opcionais no Application Manager página. 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. Confluence Cloud perfil de integração em IU principal está inativo.

Procedimento

1. Navegue até o perfil de integração.

   Interface	Ação
   IU principal	Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta. Selecione Novo. Selecione Perfil de integração na nuvem do Confluence .
   Espaço de ativos de software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos. Selecione Novo. Selecione Nuvem de confluência na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 2. Formulário de perfil de integração

   Campo	Valor
   Nome de 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 tiver publicado o perfil de integração, este campo será definido automaticamente como Rascunho . Se você já tiver publicado 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 Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
   Nota:

   Para obter mais informações, consulte Permissões mínimas do usuário tabela.
   1. Na seção Baixar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinaturas de download do Confluence Cloud .
      Nota:

      . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.
   2. Na seção Calcular subfluxo de atividade, verifique se Subfluxo o campo está definido como Atualizar atividade do usuário na nuvem do Confluence .
      Nota:

      . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, a atividade será programada SAM - Refresh <displayname> Activitynão foi criado.

      Em Analisar a atividade do usuário , você também pode selecionar a data e a hora a partir da qual 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 você cria este perfil.

      Nota:

      Software Asset Management extrai os eventos da hora 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 da última atividade das regras de recuperação de software. Para obter mais informações, consulte Revise uma regra de recuperação de software.
   3. Na seção Recuperar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinatura de recuperação do Confluence Cloud .
      Nota:

      . Recuperar assinaturas a caixa de seleção está marcada por padrão. Se você não quiser recuperar assinaturas, desmarque esta caixa de seleção. Se você limpar, os candidatos a remoção serão criados, mas o subfluxo Recuperar assinatura não será acionado ou o processo de recuperação não será iniciado.
4. Selecione Save (Salvar).
   Um perfil de integração de rascunho é criado.

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

   Nota:

   O valor preenchido automaticamente em Conexão e credencial o campo muda com base na seleção no Atividade de download e. Recuperar assinaturas caixas de seleção.

   Tabela 3. Valores de conexão e credencial preenchidos automaticamente com base na seleção

   Seleção	Valor de conexão e credencial
   Ambos Atividade de download e. Recuperar assinaturas selecionados.	sn_conflunce_spoke.confluence_subscription_activity_reclaim
   Apenas Atividade de download selecionado.	sn_conflunce_spoke.confluence_subscription_activity
   Apenas Recuperar assinaturas selecionado.	sn_conflunce_spoke.confluence_subscription_reclaim
   Ambos Atividade de download e. Recuperar assinaturas não estão selecionados.	sn_conflunce_spoke.confluence_subscription

5. Selecione o ícone de visualização para abrir o registro de aliases de conexão e credencial ao lado de Conexão e credencial e, em seguida, selecionando Abrir registro na visualização do registro.
6. No formulário Aliases de conexão e credencial, selecione Criar nova conexão e credencial link relacionado.
7. Na caixa de diálogo, preencha os campos.

   Tabela 4. Caixa de diálogo Criar conexão e credencial

   Campo	Descrição
   Nome	Nome da conexão.
   URL de conexão	Forneça o URL do seu Confluence Cloud instância no https://api.atlassian.com/ex/confluence/<Cloud-ID formato. Para obter mais informações sobre como obter o valor do ID da nuvem, consulte Obtenha o valor do ID da nuvem de Confluence Cloud instância.
   ID do cliente OAuth	ID do cliente atribuído ao seu Confluence Cloud Aplicação OAuth 2,0 (3LO).
   Segredo do cliente OAuth	Segredo do cliente atribuído ao seu Confluence Cloud Aplicação 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 especificado em Crie um Confluence Cloud Aplicação OAuth 2,0 (3LO).

8. Selecione Criar e obter um Token do OAuth.
   Nota:

   Para obter a função necessária para executar esta etapa, consulte Permissões mínimas do usuário tabela.
9. Quando a caixa de diálogo for exibida, conceda permissão ao Confluence Cloud aplicação.
   A caixa de diálogo é fechada e você retorna automaticamente para o formulário Aliases de conexão e credencial.
10. Especifique os grupos que têm acesso aos produtos do Confluence.
    Especificando esses grupos em seu 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 Atlassian .
    2. Faça login na conta de administrador com uma função site_admin.
    3. Selecione Selecione na organização necessária.
    4. Selecione Produtos .
    5. Na página Produtos, selecione Gerencie o produto Na linha do produto Confluence.
    6. Exiba a lista de grupos que têm acesso aos produtos do Confluence.
       Anote essas informações para uso posterior.
    7. Retorne ao ServiceNow e navegue até Nuvem de confluência > Grupos de confluência.
    8. No formulário Grupos de fluência, selecione Adicione grupos link relacionado.
       A caixa de diálogo Adicionar grupos de fluência é aberta.
    9. Selecione a Conexão e a credencial que foi definida 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 ao seu Atlassian conta. 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 Selecionados.
    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.

    Validar a 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ê limpar Atividade de download caixa de seleção depois que o perfil de integração for publicado, você deve revalidar as conexões e publicar novamente o perfil de integração porque ocorrem os seguintes eventos:

    • . Status o campo no formulário de perfil de integração muda para Rascunho .
    • . Validar conexão o botão aparece no formulário.
    • O atual SAM - Refresh <displayname> Activityo trabalho é excluído.

O que Fazer Depois

Depois que a integração se conectar, seu ServiceNow a instância cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:

• Modelos de software
• Identificadores de assinatura não reconhecidos
• Trabalhos agendados
• Resultados de trabalhos programados
• Assinaturas de Software
• Regra de exclusão de identificador de assinatura
• Regra de exclusão do usuário de assinatura

Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e configurações para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários Confluence Cloud 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 Revise 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 próprio.

• Para obter mais informações sobre como criar direitos de software no Software Asset Management IU principal, consulte Crie direitos em Software Asset Management clássico.
• Para obter mais informações sobre como criar direitos de software no Espaço de ativos de software, consulte Crie direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando o. Software Asset Management Playbook, consulte Crie direitos usando o passo-a-passo guiado.

A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou o. Exibição de uso de licença (Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.

• Para obter mais informações sobre como executar reconciliação no Software Asset Management aplicação clássica, consulte Execute a reconciliação de software em Software Asset Management clássico.
• Para obter mais informações sobre como executar a reconciliação no Espaço de ativos de software, consulte Execute a reconciliação de software no espaço.