---
sourceDocument: Xanadu IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-service-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Credenciais OAuth 2.0 para aplicações GitHub - Código de autorização

# Credenciais OAuth 2.0 para aplicações GitHub - Código de autorização {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](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:  
Somente repositórios de nível de usuário são compatíveis. Você deve ter acesso a todos os repositórios GitHub que deseja configurar em Velocidade de mudança para DevOps usando o código de autorização.  
Nota:  
Para o GitHub Enterprise Server (instância no local), o OAuth não será compatível se você estiver se conectando usando um MID Server.

## Configure o aplicativo GitHub em sua conta GitHub (código de autorização) {#ariaid-title2}

Crie um app GitHub personalizado de sua conta GitHub para habilitar a autenticação OAuth 2.0 com sua instância ServiceNow.

### Antes de Iniciar

GitHub requisito: GitHub app configurado para integração com ServiceNow

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

### Por Que e Quando Desempenhar Esta Tarefa

Conclua essas etapas na sua conta GitHub. Confira [Edifício GitHub Apps](https://developer.github.com/apps/building-github-apps/) no site do desenvolvedor GitHub para obter instruções sobre como criar e configurar aplicações personalizadas.

### Procedimento

1. Na sua conta GitHub, crie seu app GitHub navegando até Configurações do desenvolvedorAplicações do GitHub.
2. No campo URL da página inicial, insira <kbd class="ph userinput">https://</kbd>\<instance-name\> .service-now.com .
3. No campo URL de retorno de chamada de autorização do usuário, insira <kbd class="ph userinput">https://</kbd>\<instance-name\> .service-now.com/oauth_redirect.do .
4. Na seção Identificação e autorização de usuários, desmarque o campo Tokens de autorização do usuário expirados.
5. Na seção Webhook, desmarque o campo Ativo.
6. Deixe os campos restantes em branco (padrão).
7. Na seção 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: São necessárias permissões de leitura e gravação 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 aplicativo GitHub recém-criado nas contas de sua escolha.
{#dev-ops-config-github-acct-auth__steps_yy3_bls_4mb}

## Adicionar ID de cliente à propriedade de DevOps {#ariaid-title3}

Depois de configurar o app GitHub, você deve garantir que o prefixo do ID do cliente (primeiros 3 ou mais caracteres do ID) seja adicionado à propriedade do DevOps: especificador de ID de 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. Altere o Escopo da aplicação para Modelo de dados do DevOps.
3. Pesquise a propriedade: especificador de ID de cliente para 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 GitHub como um provedor OAuth (código de autorização) {#ariaid-title4}

Use as informações geradas durante a configuração da conta do aplicativo GitHub para registrar 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é TodosOAuth de SistemaRegistro de aplicações.
2. Clique em Nova.  
   O sistema exibe a mensagem Que tipo de aplicação OAuth?
3. Selecione Conectar-se a um provedor OAuth de terceiros.  
   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 apps do GitHub</kbd>. |
   | ID de cliente | Insira o ID de cliente do seu app GitHub (dica: disponível na seção Sobre da configuração do app \[ GitHub em GitHub ). |
   | Segredo do cliente | Insira o segredo do cliente do app GitHub (dica: disponível na seção Sobre da configuração do app \[ GitHub 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 URL do host GitHub apropriado. |
   | URL de Token | Insira <kbd class="ph userinput">https://github.com/login/oauth/access_token</kbd>. Para uma implantação no local, use o URL do host GitHub apropriado. |
   [ ]

   {#dev-ops-reg-github-oauth-prov-auth__table_fd2_2xr_4mb}
5. Deixe o restante dos campos de 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 a URL de redirecionamento (Dica: ela deve corresponder à URL de retorno de chamada de autorização do usuário fornecida anteriormente na configuração do aplicativo GitHub ).
   * O sistema preenche o perfil de entidade OAuth com o tipo de concessão como código de autorização. Por exemplo, o perfil de entidade OAuth é criado com o nomepadrão, Meu provedor de apps 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}

## Criar um registro de credencial para o provedor de aplicações GitHub (código de autorização) {#ariaid-title5}

Crie um registro de credencial para o provedor de aplicações GitHub criado anteriormente para autorizar ações.

### Antes de Iniciar

Função necessária: administrador, credential_admin

### Procedimento

1. Navegar até TodosConexõ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 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 à sua instância da ferramenta GitHub usando o MID Server para usar esta credencial. |
   | Ordem | Selecione a ordem 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 no link relacionado Obter token OAuth 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/NezbkYmzFDJgZtlrTKDYwA#github-actions-integration-with-devops "Informações de configuração em GitHub Actions, como segredos, fluxos de trabalho e limitações.")
* [Ações personalizadas do ServiceNow DevOps do mercado do GitHub](https://servicenow-prod.fluidtopics.net/IqmuBEkmGWsWUk9IJZ3shw#servicenow-devops-custom-actions-from-github-marketplace "Use as ações personalizadas do mercado GitHub 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.")