---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

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

# Credenciais do OAuth 2,0 para GitHubApps - Código de autorização {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Execute as etapas a seguir para integrar seus aplicativos 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.

{#dev-ops-github-apps-oauth-auth__ul_rxd_mpy_jsb}  
Nota:  
Há suporte para repositórios de nível de usuário. Você deve ter acesso a todos os GitHubrepositórios que você deseja configurar em Velocidade de mudança para DevOpsUsando 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. GitHubEm seu GitHubConta (código de autorização) {#ariaid-title2}

Crie um personalizado GitHubApp do seu GitHubConta para habilitar a autenticação OAuth 2,0 com seu ServiceNowinstância.

### Antes de Iniciar

GitHubrequisito: GitHubAplicação configurada 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 em GitHubconta. Confira [Prédio GitHub Apps](https://developer.github.com/apps/building-github-apps/) em GitHubSite do desenvolvedor para obter instruções sobre como criar e configurar aplicações personalizadas.

### Procedimento

1. Do seu GitHubconta, crie seu GitHubNavegando até Configurações do desenvolvedorGitHub Apps.
2. Em URL da página inicial campo, insira <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com </kbd>.
3. Em URL de retorno de chamada de autorização do usuário campo, insira <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do </kbd>.
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 vazios (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: As permissões de leitura e gravação são necessárias para configurar webhooks de ServiceNow. |
   [ ]

   {#dev-ops-config-github-acct-auth__table_j5m_wcs_4mb}
8. Deixe as permissões restantes como <kbd class="ph userinput">Sem acesso </kbd>(padrão).
9. Instale o recém-criado GitHubApp nas contas de sua escolha.
{#dev-ops-config-github-acct-auth__steps_yy3_bls_4mb}

## Adicione o ID do cliente à propriedade DevOps {#ariaid-title3}

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 app GitHub .

### Antes de Iniciar

Função necessária: sn_devops.admin

### Procedimento

1. Navegar até EspaçosEspaço de mudança de DevOpsAdministraçãoConfiguração do sistemaPropriedades.
2. Mude o escopo da aplicação para Modelo de dados DevOps.
3. Pesquisar a propriedade: Especificador de ID do cliente para o app 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 app GitHub na propriedade.
5. Selecione Salvar.

## Registrar GitHubComo provedor de OAuth (código de autorização) {#ariaid-title4}

Use as informações geradas durante GitHubConfiguração da conta da aplicação a ser registrada GitHubComo um provedor de 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é TudoOAuth de SistemaRegistro 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 de OAuth terceirizado .  
   O sistema exibe um formulário de Registros de aplicações vazio.
4. Preencha o formulário.  
   {#dev-ops-reg-github-oauth-prov-auth__table_fd2_2xr_4mb__entry__2}

   | Campo | Valor necessário |
   |-|-|
   | Nome | Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira <kbd class="ph userinput">Meu provedor de aplicações GitHub </kbd>. |
   | ID de cliente | Insira o ID do cliente do seu GitHubApp (dica: Disponível em Sobre de GitHubConfiguração da aplicação em GitHub). |
   | Segredo do cliente | Insira o segredo do cliente do seu GitHubApp (dica: Disponível em Sobre de GitHubConfiguraçã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 <kbd class="ph userinput">https://github.com/login/oauth/authorize </kbd>. Para uma implantação no local, use o apropriado GitHubURL do host. |
   | URL de Token | Insira <kbd class="ph userinput">https://github.com/login/oauth/access_token </kbd>. Para uma implantação no local, use o apropriado GitHubURL do host. |
   [ ]

   {#dev-ops-reg-github-oauth-prov-auth__table_fd2_2xr_4mb}
5. Deixe o restante dos campos do formulário como padrão.  
6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.  
   * O sistema valida as credenciais do 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 GitHubConfiguração da aplicação).
   * O sistema é preenchido Perfil da entidade OAuth com Tipo de concessão como Código de autorização . Por exemplo, Perfil da entidade OAuth é criado com o padrão Nome , Meu provedor de aplicações GitHub default_profile
   {#dev-ops-reg-github-oauth-prov-auth__ul_id2_2xr_4mb}
{#dev-ops-reg-github-oauth-prov-auth__steps_ed2_2xr_4mb}

## Crie um registro de credencial para GitHubProvedor de app (código de autorização) {#ariaid-title5}

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

### Antes de Iniciar

Função necessária: administrador, credential_admin

### Procedimento

1. Navegar até TudoConexões e CredenciaisCredenciais.
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 de Credenciais do OAuth 2,0 vazio.
4. Preencha estes valores.  
   {#dev-ops-create-cred-github-auth__table_sxv_zgp_gfb__entry__2}

   | Campo | Valor necessário |
   |-|-|
   | Nome | Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira <kbd class="ph userinput">Minha credencial do app GitHub </kbd>. |
   | 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 GitHub usando O MID Server para usar esta credencial. |
   | Ordem | Selecione o pedido para aplicar esta credencial. Por exemplo: insira <kbd class="ph userinput">100</kbd>. |
   [ ]

   {#dev-ops-create-cred-github-auth__table_sxv_zgp_gfb}
5. Salve o registro.
6. Clique em Obter token OAuth Link relacionado para gerar o token OAuth.
{#dev-ops-create-cred-github-auth__steps_o5h_52j_qfb}
**Conceitos relacionados**   

* [GitHub Actions configurações](https://servicenow-prod.fluidtopics.net/TuIpZkaTMxMiuBTyUvkwyw#github-actions-integration-with-devops "Informações de configuração em GitHub Actions, como segredos, fluxos de trabalho e limitações.")
* [Ações personalizadas da ServiceNow DevOps do GitHub marketplace](https://servicenow-prod.fluidtopics.net/GFmMK1iOJgcYgkoD_jBrbg#servicenow-devops-custom-actions-from-github-marketplace "Use as ações personalizadas do GitHubMarketplace para coletar dados de verificação do SonarQube, dados de segurança, pausar ou retomar o fluxo de trabalho ou retomar o fluxo de trabalho até que uma solicitação de mudança seja aprovada ou rejeitada em sua instância, ou obter e atualizar detalhes da solicitação de mudança e assim por diante.")