Integrar com GitHub Nuvem corporativa

Integrando seu Software Asset Management aplicação com GitHub O aplicativo Enterprise Cloud ajuda você a rastrear suas assinaturas de software e recuperar licenças não utilizadas.

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 GitHub Aplicação de nuvem empresarial	Escopos de autenticação
Download de assinaturas	Responsável pela organização	leitura:org
Extrair atividade do usuário	Responsável pela organização	leitura:org reposição
Recuperar assinatura	Responsável pela organização	write:org

Gere um token de acesso de API para GitHub Nuvem corporativa

Gere um token que você pode usar para acessar o. GitHub Enterprise Cloud API.

Antes de Iniciar

GitHub Função necessária: Responsável pela organização

A conta de usuário que você usa para autenticação deve ser capaz de ler todos os repositórios na organização da qual ela faz parte.

Por Que e Quando Desempenhar Esta Tarefa

. GitHub o serviço de hospedagem de repositório usa tokens de acesso pessoal para conceder aos usuários acesso ao GitHub API. Os tokens de acesso pessoal funcionam de forma semelhante aos tokens de acesso OAuth autorizando solicitações de API. Gerando um token de acesso pessoal para autorizar seu GitHub Solicitações de API do Enterprise Cloud, você pode obter acesso ao GitHub Enterprise Cloud API.

Procedimento

1. Em um navegador da Web, abra GitHub .
2. Entre no seu GitHub conta.
3. Em GitHub cabeçalho da página, selecione sua foto de perfil e selecione Configurações .
   Suas configurações de perfil são abertas.
4. No painel de navegação esquerdo, selecione Configurações do desenvolvedor .
   Suas configurações de desenvolvedor são abertas.
5. No painel de navegação esquerdo, selecione Tokens de acesso pessoal .
6. Selecione Tokens (clássico) .
7. Na página Tokens de acesso pessoal, selecione Gerar novo token .
8. Selecione Gerar novo token (clássico) .
9. Se você for solicitado a confirmar sua senha antes de prosseguir, insira seu GitHub e selecione Confirmar senha .
10. No formulário Novo token de acesso pessoal, descreva a finalidade do token no Observação campo.
11. Para conceder ao token uma expiração, selecione o menu suspenso Expiração e selecione um valor padrão ou use o seletor de calendário.
12. Na seção do formulário Selecionar escopos, habilite os escopos OAuth repositório, write:org e read:org.
    Os escopos do OAuth limitam o nível de acesso que a aplicação tem aos recursos protegidos. O escopo OAuth do repositório fornece controle total de seus repositórios privados. Os escopos OAuth write:org e read:org permitem que você gerencie toda a organização, incluindo todas as equipes, projetos e associações. Consulte Escopos para aplicações OAuth para obter mais informações sobre GitHub Escopos do OAuth.
    1. Habilite o escopo OAuth do repositório selecionando repositório caixa de seleção.
       Ao habilitar este escopo OAuth, você habilita automaticamente os escopos repo:status, repo_deployment, public_repo, repo:invite e security_events OAuth.
    2. Habilite os escopos Write:org e read:org OAuth.
13. Selecione Gerar token .
    Seu token de acesso pessoal é gerado.
14. Copie o token de acesso e salve-o em um local seguro para uso posterior.
15. Para usar seu token para acessar recursos pertencentes a uma organização que usa o Single Sign-on do SAML, autorize o token.
    Para obter mais informações, consulte Autorizando um token de acesso pessoal para uso com o Single Sign-on do SAML .

Crie um GitHub Conexão do Enterprise Cloud

Crie uma conexão entre seu GitHub Aplicações em nuvem empresarial e seu ServiceNow instância.

Antes de Iniciar

Se você quiser usar um MID Server para comunicação entre seu ServiceNow e seu GitHub Enterprise Cloud Applications, você deve primeiro configurar um MID Server em sua instância. Consulte MID Server para obter instruções detalhadas.

ServiceNow Função necessária: administrador

Procedimento

1. Do seu ServiceNow instância, navegue até Automação de Processo > Flow Designer.
   A guia Flow Designer é criada.
2. Selecione Conexões guia.
3. Selecione Exibir detalhes para seu GitHub conexão.
4. Na lista de conexões disponíveis, localize GitHub e selecione Configurar .
5. Na caixa de diálogo Configurar conexão, preencha os campos.

   Tabela 2. Caixa de diálogo Configurar conexão

   Campo	Descrição
   Nome da conexão	Nome do GitHub conexão.
   URL de conexão	URL do GitHub Endpoint da API. Insira https://api.github.com .
   Usar MID Server	Opção que habilita seu ServiceNow instância para usar um MID Server para comunicação com seu GitHub Aplicações de nuvem empresarial. Se sua instância exigir um MID Server defina este campo como verdadeiro . Se sua instância não exigir um MID Server deixe este campo em branco. Importante: Para habilitar esta opção, você já deve ter um MID Server configure em sua instância . Consulte MID Server para obter instruções detalhadas.
   Chave de API	Token de acesso pessoal que permite que você acesse GitHub Enterprise Cloud API. . GitHub a versão do spoke instalada é 2.2.5 ou superior, insira <api-key> . . GitHub a versão do spoke instalada é anterior à 2,2.5, insira Portador do <api-key> . " api-chave > é o token de acesso pessoal que você gerou em Gere um token de acesso de API para GitHub Nuvem corporativa

6. Selecione Configurar conexão.

Crie um GitHub Enterprise Perfil de integração na nuvem

Crie um GitHub Enterprise Perfil de integração do Enterprise Cloud para rastrear assinaturas de software e otimizar o licenciamento para seu GitHub Aplicações de nuvem empresarial.

Antes de Iniciar

Para criar um GitHub Enterprise Perfil de integração na nuvem, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do ServiceNow Store .

ServiceNow Função necessária: sam_integrator ou admin

Importante:

Você deve selecionar Spoke do GitHub 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. GitHub Perfil de integração de nuvem 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 do GitHub Cloud .
   Espaço de ativo do software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos. Selecione Novo. Selecione GitHub Cloud na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 3. Formulário Perfil de integração

   Campo	Descrição
   Nome de exibição	Nome do perfil de integração. Por exemplo, GitHub Cloud Integration .
   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 github_cloud_subscription .

3. Revise as funções de usuário necessárias ou permissões de API especificadas em 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 GitHub Cloud .
      Nota:

      . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.
      Software Asset Management Extrai membros, colaboradores externos, convites pendentes e colaboradores externos pendentes para fornecer uma exibição completa das assinaturas do GitHub Enterprise Cloud.

      Importante:

      Para extrair colaboradores externos pendentes, habilite sn_sam_saas_int.pull_pending_collaborator_githubpropriedade do sistema. Um número maior de repositórios levaria a um número maior de transações de API.
   2. Na seção Calcular subfluxo de atividade, verifique se Subfluxo o campo está definido como Atualização de nuvem do GitHub Atividade do usuário .
      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.

      Dica:

      Para evitar problemas de desempenho com este subfluxo, a melhor abordagem é definir Analisar a atividade do usuário de no máximo sete dias antes da data atual.
   3. Na seção Recuperar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinatura de recuperação do GitHub 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).
   . ServiceNow a instância cria um perfil de integração de rascunho.

   . Conexão e credencial o campo aparece e é definido automaticamente como sn_github_spoke.GitHub .

5. 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.

6. Depois que a conexão for verificada, selecione Publicar .
7. 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 perfis de integração.

Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas do 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 Criar direitos em Software Asset Management clássico.
• Para obter mais informações sobre como criar direitos de software no Software Asset Workspace, consulte Criar direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando 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 os resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou 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.

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