Integrar com GitHubServidor empresarial

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

    • Integrando seu Gestão de ativos de softwareaplicação com GitHubA aplicação Enterprise Server ajuda você a rastrear suas assinaturas de software e recuperar licenças não utilizadas.

    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 de usuário necessária no GitHubAplicação do servidor empresarial Escopos de autenticação
    Download de assinaturas administrador do site site_admin
    Recuperar assinatura administrador do site site_admin

    Gere um token de acesso à API para GitHubServidor empresarial

    Gere um token que você pode usar para acessar o. GitHubAPI do Enterprise Server.

    Antes de Iniciar

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

    Por Que e Quando Desempenhar Esta Tarefa

    . GitHubo serviço de hospedagem de repositório usa tokens de acesso pessoal para conceder aos usuários acesso ao GitHubAPI. 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 GitHubSolicitações de API do Enterprise Server, você pode obter acesso ao GitHubAPI do Enterprise Server.

    Procedimento

    1. Em um navegador da web, abra seu GitHubInstância do Enterprise Server.
    2. Entre no GitHubconta.
    3. Em GitHubcabeçalho da página, selecione sua foto de perfil e, em seguida, selecione Configurações .
      Suas configurações de perfil estão abertas.
    4. No painel de navegação esquerdo, selecione Configurações do desenvolvedor .
      Suas configurações de desenvolvedor estão abertas.
    5. No painel de navegação esquerdo, selecione Tokens de acesso pessoal .
    6. Na página Tokens de acesso pessoal, selecione Gerar novo token .
    7. Se você for solicitado a confirmar sua senha antes de prosseguir, insira seu GitHube selecione Confirme a senha .
    8. No formulário Novo token de acesso pessoal, descreva a finalidade do token no Observação campo.
    9. Na seção Formulário Selecionar escopos, habilite o escopo do site_admin OAuth selecionando site_admin caixa de seleção.
      Os escopos do OAuth limitam o nível de acesso que a aplicação tem aos recursos protegidos. O escopo do site_admin OAuth permite gerenciar usuários, organizações e repositórios empresariais.
    10. Selecione Gerar token .
      Seu token de acesso pessoal é gerado.
    11. Copie o token de acesso e salve-o em um local seguro para uso posterior.

    Crie um GitHubConexão do Enterprise Server

    Crie uma conexão entre o. GitHubEnterprise Server Applications e seu ServiceNowinstância.

    Antes de Iniciar

    Se você quiser usar um MID Serverpara comunicação entre o. ServiceNowe seu GitHubEnterprise Server, você deve primeiro configurar um MID Serverem sua instância. Consulte MID Server para obter instruções detalhadas.

    ServiceNow Função necessária: administrador

    Procedimento

    1. Do seu ServiceNowinstância, navegue até Automação de Processo > Flow Designer.
      O Designer de fluxo é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Selecione Exibir detalhes para seu GitHubConexão do servidor.
    4. Na lista de conexões disponíveis, localize GitHubE 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 GitHubConexão do servidor.
      URL de conexão URL da sua instância do GitHub.
      Usar MID Server Opção que habilita seu ServiceNowinstância para usar um MID Serverpara comunicação com o. GitHubAplicações do Servidor 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 Serverconfigure em sua instância. Consulte MID Server para obter instruções detalhadas.
      Chave de API Token de acesso pessoal que permite acessar o. GitHubAPI do Enterprise Server. Insira Menos de api-chave > , em que > api-chave > é o token de acesso pessoal que você gerou em Gere um token de acesso à API para GitHubServidor empresarial.
    6. Selecione Configurar conexão.

    Crie um GitHubPerfil de integração do Enterprise Server

    Crie um GitHubPerfil de integração do Enterprise Server para rastrear assinaturas de software e otimizar o licenciamento para o. GitHubAplicações do Servidor Empresarial.

    Antes de Iniciar

    Para criar um GitHubPerfil de integração do Servidor empresarial, solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) do ServiceNow Store .

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

    Importante:
    Você deve selecionar GitHub spoke caixa de seleção desta integração ao instalar recursos opcionais no Application Managerpá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. GitHubPerfil de integração do servidor em IU principalestá inativo.

    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 assinatura do GitHub Server .
      Espaço de ativos de software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione GitHub Server na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. 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 .
      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 github_server_subscription .
    3. Na seção Configuração do processo, 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 SaaSlicenças.
      Nota:
      Para obter mais informações sobre as funções e escopos necessários, consulte Permissões mínimas do usuário tabela.

      • . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.

      • Nota:
        . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, o trabalho agendado da atividade SAM - Refresh <displayname> Activitynão foi criado.
        Em Analise a atividade do usuário você também pode selecionar a data e a hora a partir de quando você 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:
        Gestão de ativos de software extrai os eventos 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 da última atividade das regras de recuperação de software. Para obter mais informações, consulte Revise uma regra de recuperação de software.

      • . 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 à remoção serão criados, mas o subfluxo de recuperação de assinatura não será acionado ou o processo de recuperação não será iniciado.

    4. Selecione Salvar.
      Seu ServiceNowa 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_Server .

    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.

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

    6. Depois que a conexão for validada, selecione Publicar .
    7. Na caixa de diálogo Confirmação de publicação, selecione OK .
      Nota:
      Se você limpar Atividade de download após a publicação do perfil de integração, 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 .
      • . Valide a conexão o botão aparece no formulário.
      • O atual SAM - Refresh <displayname> Activityo trabalho é excluído.

    O que Fazer Depois

    Após a integração se conectar, seu ServiceNowa instância 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 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 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.
    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 ( Gestão de ativos de softwareaplicaçã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.