--- sourceDocument: Zurich IT Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/pt-BR/zurich/it-service-management Release : - zurich ft:locale : - pt-BR ft:publication_title : - Zurich IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Credenciais do OAuth 2,0 para GitHub Apps - Código de autorização # Credenciais do OAuth 2,0 para GitHub Apps - Código de autorização {#ariaid-title1} * Versão de lançamento: Zurich * * Atualizado 31 de jul. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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. {#dev-ops-github-apps-oauth-auth__ul_rxd_mpy_jsb} 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) {#ariaid-title2} 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](https://developer.github.com/apps/building-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 desenvolvedorGitHub 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. | [ ] {#dev-ops-config-github-acct-auth__table_j5m_wcs_4mb} 8. Deixe as permissões restantes como Sem acesso (padrão). 9. Instale o recém-criado GitHub 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 aplicativo 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 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) {#ariaid-title4} 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é 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 OAuth de terceiros . O sistema exibe um formulário 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 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. | [ ] {#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 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 {#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 GitHub Provedor de app (código de autorização) {#ariaid-title5} 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é 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 Credenciais do OAuth 2,0 vazio. 4. Preencha esses 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 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. | [ ] {#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://www.servicenow.com/docs/C6pMOQSwOPEveYlrebnsqw#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 GitHub Marketplace](https://www.servicenow.com/docs/3dmraH3h7Tn1_dpKxOogiQ#servicenow-devops-custom-actions-from-github-marketplace "Use as ações personalizadas do GitHub Marketplace 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.")