Integrar com GitHub Enterprise Cloud

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

Gerar um token de acesso de API para GitHub Enterprise Cloud

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

Antes de Iniciar

GitHub Função necessária: proprietário da organização

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

Por Que e Quando Desempenhar Esta Tarefa

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

Procedimento

  1. Em um navegador da Web, abra o GitHub.
  2. Entre na sua conta GitHub.
  3. No cabeçalho da página GitHub, clique na sua foto de perfil e selecione Configurações.
    Suas configurações de perfil serão abertas.
  4. No painel de navegação esquerdo, selecione Configurações do desenvolvedor.
    Suas configurações de desenvolvedor serã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, clique em Gerar novo token.
  8. Selecione Gerar novo token (clássico).
  9. Se você for solicitado a confirmar sua senha antes de prosseguir, insira sua senha GitHub e clique em Confirmar senha.
  10. No formulário Novo token de acesso pessoal, descreva a finalidade do token no campo Observação.
  11. Para dar uma expiração ao seu token, selecione o menu suspenso Vencimento e selecione um valor padrão ou use o seletor de calendário.
  12. Na seção de formulário Selecionar escopos, habilite os escopos OAuth repo e admin: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. O escopo OAuth admin:org permite 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 OAuth.
    1. Habilite o escopo do OAuth do repositório marcando a caixa de seleção do repositório.
      Ao habilitar este escopo OAuth, você habilita automaticamente os escopos OAuth repo:status, repo_deployment, public_repo, repo:invite e security_events.
    2. Habilite o escopo OAuth admin:org marcando a caixa de seleção admin:org.
      Ao habilitar este escopo OAuth, você habilita automaticamente os escopos write:org e read:org OAuth.
  13. Clique em Gerar token.
    Seu token de acesso pessoal gera.
  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 logon único SAML, autorize o token.
    Para obter mais informações, consulte Autorização de um token de acesso pessoal para uso com logon único SAML.

Criar uma GitHub conexão do Enterprise Cloud

Crie uma conexão entre suas aplicações Enterprise Cloud [ GitHub e sua instância ServiceNow.

Antes de Iniciar

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

ServiceNow Função necessária: administrador

Procedimento

  1. Na sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
    O Flow Designer é iniciado em uma nova guia.
  2. Selecione a guia Conexões.
  3. Clique em Exibir detalhes da sua conexão GitHub.
  4. Na lista de conexões disponíveis, localize GitHub e clique em Configurar.
    A caixa de diálogo Configurar conexão é aberta.
  5. Na caixa de diálogo, preencha os campos.
    Tabela 1. Caixa de diálogo Configurar conexão
    Campo Descrição
    Nome da conexão Nome da conexão GitHub.
    URL de Conexão URL do endpoint da API GitHub. Insira https://api.github.com.
    Usar MID Server Opção que permite que sua instância ServiceNow use um MID Server para comunicação com suas aplicações de nuvem empresarial GitHub. Se sua instância requer 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 configurado em sua instância. Consulte MID Server para obter instruções detalhadas.
    Chave de API Token de acesso pessoal que permite acessar a GitHub Enterprise Cloud API.
    • Se a versão do spoke GitHub instalada for 2.2.5 ou superior, insira<api-key> .
    • Se a versão do spoke GitHub instalada for anterior à 2.2.5, insira o Portador<api-key> .
    A <api-key> é o token de acesso pessoal que você gerou em Gerar um token de acesso de API para GitHub Enterprise Cloud
  6. Clique em Configurar conexão.

Criar um perfil de integração do Enterprise Cloud GitHub

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

Antes de Iniciar

Para criar um perfil de integração do GitHub Enterprise 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.

ServiceNow Função necessária: sam_integrator ou 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 em nuvem GitHub 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 GitHub Cloud Integration Profile.
    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 GitHub Cloud na lista suspensa.
    4. Selecione Continuar.
  2. No formulário, preencha os campos.
    Tabela 2. Formulário de perfil de integração
    Campo Descrição
    Nome de exibição Nome do perfil de integração. Por exemplo, GitHub Cloud Integration.
    Conexão e Credencial Alias de conexão e credencial para o spoke GitHub. Este campo é definido automaticamente como sn_github_spoke.GitHub.
    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. Na guia Baixar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Assinaturas de download do GitHub Cloud.
  4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como GitHub Cloud Update User Activity.
    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.
    Dica:
    Para evitar problemas de desempenho com este subfluxo, ServiceNow recomenda definir o campo Analisar a atividade do usuário de para um máximo de sete dias antes da data atual.
  5. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como GitHub Cloud Recuperar assinatura.
  6. Clique em Salvar.
    Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos GitHub Assinaturas de download de nuvem, GitHub Atividade de atualização de nuvem e GitHub Assinatura de recuperação de nuvem para recuperar dados do usuário de suas aplicações de nuvem empresarial GitHub.
  7. Depois que o formulário for recarregado, clique em Publicar.
    A caixa de diálogo Confirmação de publicação é aberta.
  8. 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.