Integrar com GitHub Enterprise Server

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

Gerar um token de acesso de API para o GitHub Enterprise Server

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

Antes de Iniciar

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

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 GitHub solicitações de API do Enterprise Server, você pode obter acesso à GitHub API do Enterprise Server.

Procedimento

  1. Em um navegador da Web, abra sua instância do GitHub Enterprise Server.
  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. Na página Tokens de acesso pessoal, clique em Gerar novo token.
  7. Se você for solicitado a confirmar sua senha antes de prosseguir, insira sua senha GitHub e clique em Confirmar senha.
  8. No formulário Novo token de acesso pessoal, descreva a finalidade do token no campo Observação.
  9. Na seção de formulário Selecionar escopos, habilite o escopo do OAuth site_admin marcando a caixa de seleção site_admin.
    Os escopos do OAuth limitam o nível de acesso que a aplicação tem aos recursos protegidos. O escopo OAuth site_admin permite que você gerencie seus usuários corporativos, organizações e repositórios.
  10. Clique em Gerar token.
    Seu token de acesso pessoal gera.
  11. Copie o token de acesso e salve-o em um local seguro para uso posterior.

Criar uma GitHub conexão do Enterprise Server

Crie uma conexão entre as aplicações do Enterprise Server [ 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 Server, 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 conexão do seu servidor GitHub.
  4. Na lista de conexões disponíveis, localize GitHub Servidor 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 do servidor GitHub.
    URL de Conexão URL da sua instância GitHub.
    Usar MID Server Opção que permite que sua instância ServiceNow use um MID Server para comunicação com suas aplicações GitHub Enterprise Server. 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 Server API. Insira <api-key>, em que <api-key> é o token de acesso pessoal que você gerou em Gerar um token de acesso de API para o GitHub Enterprise Server.
  6. Clique em Configurar conexão.

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

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

Antes de Iniciar

Para criar um perfil de integração do GitHub Enterprise Server, 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 do servidor 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 Perfil de assinatura do GitHub Server.
    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 Servidor GitHub 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 Server Integration.
    Conexão e Credencial Alias de conexão e credencial para o spoke GitHub. Este campo é definido automaticamente como sn_github_spoke.GitHub_Server.
    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_server_subscription.
  3. Na guia Baixar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Assinaturas de download do servidor do GitHub.
    Você pode exibir eventos realizados por usuários individuais até um ano antes da data atual. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    Nota:
    Gestão de ativos de software extrai os eventos a partir do momento em que você inicia o download de assinaturas de usuário, independentemente da data de criação do perfil.
  4. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como GitHub Server Recuperar assinatura.
  5. 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 do servidor e GitHub Assinatura de recuperação do servidor para recuperar dados de suas aplicações do GitHub Enterprise Server.
  6. Depois que o formulário for recarregado, clique em Publicar.
    A caixa de diálogo Confirmação de publicação é aberta.
  7. 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.