Credenciais do OAuth 2,0 para GitHub Apps - Código de autorização

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • Execute as etapas a seguir para integrar seus aplicativos do GitHub usando o código de autorização.

    Antes de começar

    Função necessária:
    • oauth_admin em Velocidade de mudança para DevOps.
    • Conta de administrador em GitHub.
    Nota:
    Há suporte para repositórios no nível do usuário. Você deve ter acesso a todos os GitHub repositórios que você deseja configurar em Velocidade de mudança para DevOps Usando código de autorização.

    O tipo de concessão Código de autorização OAuth é compatível com GitHub e GitHub Enterprise com MID Server.

    Configure o. GitHub Em seu GitHub Conta (código de autorização)

    Criar um personalizado GitHub Aplicativo do seu GitHub Conta para habilitar a autenticação OAuth 2,0 com seu ServiceNow instância.

    Antes de Iniciar

    GitHub requisito: GitHub Aplicativo configurado para integrar com ServiceNow

    Função necessária: Nenhuma função de instância necessária

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua estas etapas no seu GitHub conta. Confira Construção GitHub Apps em GitHub Site do desenvolvedor para obter instruções sobre como criar e configurar aplicações personalizadas.

    Procedimento

    1. Do seu GitHub, crie sua GitHub Navegando até Configurações do desenvolvedor > GitHub Apps.
    2. Em URL da página inicial campo, insira https://<instance-name>.service-now.com .
    3. Em URL de retorno de chamada de autorização do usuário campo, insira https://<instance-name>.service-now.com/oauth_redirect.do .
    4. Em Identificar e autorizar usuários desmarque Tokens de autorização do usuário expirados campo.
    5. Em Webhook desmarque Ativo campo.
    6. Deixe os campos restantes em branco (padrão).
    7. Em Permissões do repositório defina essas configurações.
      Ação Somente leitura
      Verificações Somente leitura
      Conteúdos Somente leitura
      Implantações Ler e gravar
      Ambientes Somente leitura
      Metadados Somente leitura
      Solicitações de extração Somente leitura
      Segredos Somente leitura
      Webhooks Ler e gravar
      Nota:
      Permissões de leitura e gravação são necessárias para configurar webhooks do ServiceNow.
    8. Deixe as permissões restantes como Sem acesso (padrão).
    9. Instale o recém-criado GitHub Nas contas de sua escolha.

    Adicione o ID do cliente à propriedade DevOps

    Depois de configurar seu app GitHub, você deve garantir que o prefixo do ID do cliente (primeiros 3 ou mais caracteres do ID) seja adicionado à propriedade DevOps: Especificador de ID do cliente para o aplicativo GitHub .

    Antes de Iniciar

    Função necessária: sn_devops.admin

    Procedimento

    1. Navegar até Espaços > Espaço de mudança de DevOps > Administração > Configuração do sistema > Propriedades.
    2. Mude o escopo da aplicação para Modelo de dados DevOps.
    3. Pesquisar a propriedade: Especificador de ID do cliente para o aplicativo GitHub [sn_devops.github_oauth_client_id_specifier].
    4. Insira o prefixo do ID do cliente (primeiros 3 ou mais caracteres do ID) do seu aplicativo GitHub na propriedade.
    5. Selecione Save (Salvar).

    Registre-se GitHub Como um provedor OAuth (código de autorização)

    Use as informações geradas durante GitHub Configuração da conta da aplicação a ser registrada GitHub Como um provedor OAuth e permitir que a instância solicite tokens OAuth 2,0.

    Antes de Iniciar

    Função necessária: administrador, sn_devops.admin

    Procedimento

    1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de aplicação OAuth?
    3. Selecione Conecte-se a um provedor OAuth de terceiros .
      O sistema exibe um formulário Registros de aplicações vazio.
    4. Preencha o formulário.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira Meu provedor de aplicações do GitHub .
      ID de cliente Insira o ID do cliente do seu GitHub(Dica: Disponível em Sobre . GitHub Configuração da aplicação em GitHub).
      Segredo do cliente Insira o segredo do cliente do seu GitHub(Dica: Disponível em Sobre . GitHub Configuração da aplicação em GitHub).
      Script da API OAuth Selecione OAuthDevOpsGitHubHandler .
      Tipo de concessão padrão Selecione Código de autorização.
      URL de Autorização

      Insira https://github.com/login/oauth/authorize .

      Para uma implantação no local, use o apropriado GitHub URL do host.
      URL do token

      Insira https://github.com/login/oauth/access_token .

      Para uma implantação no local, use o apropriado GitHub URL do host.
    5. Deixe o restante dos campos do formulário como padrão.
      Formulário Registro de aplicações
    6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      • O sistema valida as credenciais OAuth e preenche o. URL de redirecionamento (Dica: Ele deve corresponder a. URL de retorno de chamada de autorização do usuário fornecido anteriormente em seu GitHub Configuração da aplicação).
      • O sistema é preenchido Perfil de entidade OAuth com Tipo de concessão . Código de autorização . Por exemplo, Perfil de entidade OAuth criado com padrão Nome , Meu provedor de aplicações GitHub default_profile

    Crie um registro de credencial para GitHub Provedor de app (código de autorização)

    Crie um registro de credencial para GitHub Provedor de app criado anteriormente para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador, credential_admin

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar? .
    3. Selecione Credenciais OAuth 2.0.
      A janela pop-up exibe um formulário Credenciais do OAuth 2,0 vazio.
    4. Preencha esses valores.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira Minha credencial do aplicativo GitHub .
      Ativo Habilitar
      Perfil de Entidade OAuth Selecione o perfil de entidade OAuth padrão que você criou anteriormente.
      Aplica-se a Selecione os MID Servers que podem usar esta credencial. Por exemplo: selecione Todos os MID Servers.
      Nota:
      Você deve se conectar à instância da ferramenta do GitHub usando O MID Server para usar esta credencial.
      Ordem Selecione a ordem para aplicar esta credencial. Por exemplo: insira 100.
    5. Salve o registro.
    6. Clique em Obter token OAuth Link relacionado para gerar o token OAuth.