---
sourceDocument: Gestão de segurança do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/security-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Gestão de segurança do Xanadu

ft:clusterId :

    - security

bundleId :

    - security

workflow :

    - Technology


---

# Criação de credenciais OAuth 2.0 para aplicações GitHub - JWT para Integrações de vulnerabilidade de aplicação do GitHub

# Criação de credenciais OAuth 2.0 para aplicações GitHub - JWT para Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 min. de leitura

Execute as etapas a seguir para integrar seus aplicativos GitHub usando o token de portador JWT para o Integrações de vulnerabilidade de aplicação do GitHub.  
Funções necessárias:

* sn_vul.app_sec_manager e admin para registros em seu Now Platform.
* Nenhuma função de instância necessária para tarefas na sua conta GitHub.
{#github-app-vuln-apps-oauth-jwt__ul_rnt_4jq_cbc}.

## Criar e configurar o app GitHub para Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title2}

Crie um aplicativo GitHub personalizado de sua conta GitHub para ativar a autenticação OAuth 2.0 com seu Integrações de vulnerabilidade de aplicação do GitHub em sua instância.

### Antes de Iniciar

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, selecione o campo Ativo.
6. No campo URL do Webhook, insira <kbd class="ph userinput">https://instance-name&gt;.service-now.com/</kbd>.
7. Deixe os campos restantes em branco (padrão).
8. Na seção Permissões do repositório, defina as seguintes configurações.  

   |-|-|
   | Verificação de código | Somente leitura |
   | Conteúdos | Somente leitura |
   | Propriedades personalizadas | Somente leitura |
   | Alertas do Dependedabot | Somente leitura |
   | Metadados | Somente leitura |
   [ ]

   {#github-avr-config-github-app-jwt__table_j5m_wcs_4mb}  
   Nota:  
   Se você já estiver usando um app GitHub e atualizar qualquer uma das permissões, deverá revisar e aceitar essas permissões para seu app GitHub. Você pode navegar até seu app e selecionar Configurar \> Revisar solicitação \> Aceitar novas permissões.
9. Deixe as permissões restantes como <kbd class="ph userinput">Sem acesso</kbd> (padrão).
10. Na seção Assinar eventos, selecione a opção Regra de proteção de implantação.
11. Clique com o botão direito do mouse no cabeçalho para salvar as mudanças.
12. Instale o aplicativo GitHub recém-criado nas contas de sua escolha.
    1. Na página de configurações de apps do GitHub, selecione seu app.
    2. Na barra lateral esquerda, selecione Instalar app.
    3. Selecione Instalar ao lado da organização ou da conta pessoal que contém o repositório correto.
    4. Instale o aplicativo em todos os repositórios ou selecione repositórios.  
       Para obter mais informações, consulte [Instalação de apps do GitHub](https://docs.github.com/en/developers/apps/managing-github-apps/installing-github-apps).
    {#github-avr-config-github-app-jwt__substeps_v31_znx_qvb}
13. Após a instalação, selecione as configurações (ícone de engrenagem) do seu aplicativo e anote ou anote as informações a seguir.  
    Esses detalhes são necessários ao criar o registro da aplicação em sua instância Now Platform.
    * ID de aplicação
    * ID de cliente
    * Segredo do cliente.
    * Observe o token no URL. Este é o ID do token que você insere no URL do token em sua instância.
    {#github-avr-config-github-app-jwt__ul_kz2_b4q_cbc}
14. Role a página para baixo, gere uma nova chave privada e salve-a em sua máquina.

## Gerar o certificado JKS para o Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title3}

Gere um certificado JKS para a autenticação JWT para o Integrações de vulnerabilidade de aplicação do GitHub.

### Antes de Iniciar

Você precisa anotar a senha usada para gerar o arquivo .jks (senha do KeyStore).

Função necessária: sn_vul.app_sec_manager

### Procedimento

1. Crie um certificado assinado por CA usando a chave privada do app GitHub :  

       openssl req -new -x509 -key <file-name>.pem -out <certificate-name>.pem -days 1095

2. Insira os detalhes necessários.
3. Crie o arquivo PKCS 12 usando a chave privada do app GitHub e o certificado assinado por CA:  

       openssl pkcs12 -export -in <certificate-name>.pem -inkey <file-name>.pem -certfile <certificate-name>.pem -out <PKCS-12-file-name>.p12 

4. Forneça a senha de exportação.
5. Crie o arquivo JKS:  

       keytool -importkeystore -srckeystore <PKCS-12-file-name>.p12 -srcstoretype pkcs12 -destkeystore <JKS-certificate-filename>.jks -deststoretype JKS

6. Forneça as senhas do armazenamento de chaves de destino e de origem.

## Anexe o certificado GitHub Java Key Store à sua instância para Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title4}

Ative a autenticação de token de Concessão de Portador JWT anexando o certificado GitHub Java KeyStore (JKS) válido à sua instância.

### Antes de Iniciar

Um certificado Java KeyStore válido.

Função necessária: sn_vul.app_sec_manager

### Procedimento

1. Navegar até TodosDefinição do SistemaCertificados.
2. Selecione Novo.
3. No formulário, preencha os campos.  
   {#avr-attach-jks-cert-github__table_hvh_4tt_xgb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Nome para identificar exclusivamente o registro. Por exemplo, <kbd class="ph userinput">My GitHub App Certificate for AVR</kbd>. |
   | Notificar no vencimento | Opção para especificar os usuários a serem notificados quando o certificado expirar. |
   | Aviso emitido antes do vencimento (em dias) | Número de dias para enviar uma notificação antes que o certificado expire. |
   | Ativo | Opção para habilitar o certificado. |
   | Tipo | Opção para selecionar o tipo de certificado. Selecione Armazenamento de chaves Java. |
   | Dias até o vencimento | Número de dias até o certificado expirar. |
   | Senha do armazenamento de chaves | Senha associada ao certificado (dica: a senha do KeyStore de destino criada anteriormente). |
   | Descrição resumida | Resumo sobre o certificado. |
   [Tabela 1. Campos do formulário da certificação X.509]

   {#avr-attach-jks-cert-github__table_hvh_4tt_xgb}
4. Selecione o ícone de anexos e anexe um certificado JKS.
5. Selecione Validar armazenamentos/certificados.  
   Uma mensagem de key_store válido é exibida para arquivos de certificado válidos.

## Crie uma chave de assinatura JWT para o GitHub certificado JKS para o Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title5}

Crie uma chave de assinatura JSON Web Token (JWT) para atribuir ao seu certificado GitHub Java KeyStore.

### Antes de Iniciar

Funções necessárias:

* administrador
* sn_vul.app_sec_manager
{#avr-create-jwt-key-github__ul_y45_stq_cbc}

### Procedimento

1. Navegar até TodosOAuth de SistemaChaves de JWT.
2. Selecione Novo.
3. No formulário, preencha os campos.  
   {#avr-create-jwt-key-github__table_jky_dk5_xgb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Nome para identificar exclusivamente a chave de assinatura JWT. Por exemplo, <kbd class="ph userinput">My GitHub App JWT Key for AVR</kbd>. |
   | Armazenamento de chaves de assinatura | Selecione o certificado JKS válido que você anexou na tarefa anterior. |
   | ID de chave | Deixe esse campo em branco. |
   | Algoritmo de assinatura | Deixe este valor como RSA 256. |
   | Senha da chave de assinatura | Senha associada à chave de assinatura. Esta é a senha usada para gerar o arquivo JKS. |
   | Ativo | Opção para habilitar a chave. |
   [Tabela 2. Campos do formulário de chaves de JWT]

   {#avr-create-jwt-key-github__table_jky_dk5_xgb}
4. Clique com o botão direito do mouse em qualquer lugar no cabeçalho cinza da página e selecione Salvar.

## Crie um provedor JWT para sua chave de assinatura GitHub para Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title6}

Adicione um provedor JWT (JSON Web Token) à sua instância \[ ServiceNow para GitHub.

### Antes de Iniciar

Funções necessárias:

* administrador
* sn_vul.app_sec_manager
{#avr-create-jwt-provider-github__ul_y45_stq_cbc}

### Procedimento

1. Navegar até TodosOAuth de SistemaProvedores JWT.
2. Selecione Novo.
3. No formulário, preencha os campos.  
   {#avr-create-jwt-provider-github__table_l5g_3m5_xgb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Nome para identificar o provedor JWT de forma única. Por exemplo, <kbd class="ph userinput">My GitHub App JWT Provider for AVR</kbd>. |
   | Intervalo de Vencimento (s) | Número em segundos para definir a vida útil dos tokens do provedor JWT. Você pode deixar esta configuração no padrão. |
   | Configuração de Assinatura. | Selecione a chave JWT que você criou nas etapas anteriores. |
   [Tabela 3. Campos de formulário do Provedor JWT]

   {#avr-create-jwt-provider-github__table_l5g_3m5_xgb}
4. Clique com o botão direito no cabeçalho do formulário e selecione "Salvar".
5. Inserir seu GitHub App ID do app para o valor da declaração iss, na lista relacionada Declarações padrão.  
   Este é o ID do app GitHubGitHub no console \[\] que você criou nas etapas anteriores.
6. Deixe os valores de auditoria e sub em branco (padrão).
7. Clique com o botão direito no cabeçalho do formulário e selecione "Salvar".

## Registrar GitHub como um Provedor OAuth (JWT) para Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title7}

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ções necessárias:

* administrador
* sn_vul.app_sec_manager
{#avr-reg-github-oauth-prov-jwt__ul_y45_stq_cbc}

### Procedimento

1. Navegar até TodosOAuth de SistemaRegistro de aplicações.
2. Selecione Novo.  
   A aplicação Que tipo de OAuth? mensagem é exibida.
3. Selecione Conectar-se a um provedor OAuth de terceiros.
4. No formulário, preencha os campos.  
   {#avr-reg-github-oauth-prov-jwt__table_fd2_2xr_4mb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Nome para identificar exclusivamente o registro. Por exemplo, insira <kbd class="ph userinput">Meu provedor de apps GitHub para AVR</kbd>. |
   | ID de cliente | ID de cliente da sua aplicação GitHub. O ID de cliente é da aplicação GitHubGitHub no console \[\] que você criou nas etapas anteriores. Este ID está disponível na seção Sobre da configuração do aplicativo \[ GitHub em GitHub. |
   | Acessível | Deixe esta configuração em seu valor atual. |
   | Segredo do cliente | Segredo do cliente da sua aplicação GitHub. O segredo do cliente é da aplicação GitHubGitHub no console \[\] que você criou nas etapas anteriores. Este ID está disponível na seção Sobre da configuração do aplicativo \[ GitHub em GitHub. |
   | Ativo | Opção para habilitar a chave. Deixe selecionado. |
   | URL de Autorização | Este URL é gerado automaticamente. |
   | URL de Token | O local do endpoint do token que a instância usa para recuperar e atualizar tokens. Insira o token do URL na sua aplicação GitHub. Este é o token exibido no URL depois que o app é instalado em GitHub. Na seção Instalar app na configuração do app GitHub em GitHub, selecione a engrenagem. O token é exibido no URL da página da web. * Para nuvem: <https://api.github.com/app/installations/49374672/access_tokens>. ID de instalação: 9374672. * Para no local: <https://github-372.secops-eng.com/api/v3/app/installations/7/access_tokens/api/v3>. {#avr-reg-github-oauth-prov-jwt__ul_hjq_nfv_gbc} |
   | Script da API OAuth | Opção que permite fazer referência a uma inclusão de script OAuthUtil corrigida. Selecione OAuthGitHubJWTHandler. |
   | Tipo de concessão padrão | Tipo de concessão associado ao registro de aplicações. Selecione Portador JWT. |
   [Tabela 4. Campos de formulário de Registro de aplicações]

   {#avr-reg-github-oauth-prov-jwt__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 selecione "Salvar".
7. Role até a lista relacionada Perfis de entidade OAuth, selecione-a e abra o perfil padrão que foi criado na lista.
8. Preencha o campo Provedor JWT com o provedor JWT criado anteriormente e salve o formulário.
9. Retorne ao arquivo de registro da aplicação e salve-o.
10. Navegar até Gestão de chavePolíticas de Acesso ao MóduloTodos.
11. Selecione a política que tem com_snc_platform_security_oauth_glideencrypter como o valor do campo Módulo de criptografia e a Inclusão de script: OAuthGitHubJWTHandler.  

12. Verifique se o campo Resultado está definido como Rastrear e salve suas mudanças.

## Criar credenciais e conexões para o Integrações de vulnerabilidade de aplicação do GitHub {#ariaid-title8}

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

### Antes de Iniciar

Funções necessárias:

* administrador
* sn_vul.app_sec_manager
{#avr-cred-connection-github__ul_y45_stq_cbc}

### Procedimento

1. Navegar até Credenciais e conexõesCredenciais.
2. Selecione Novo.
3. Selecione Credenciais OAuth 2.0.
4. Selecione Novo e preencha os campos.

   | Campo | Descrição |
   | Nome | Nome exclusivo do registro. |
   | Aplica-se a | Selecione as credenciais do OAuth 2.0 na lista. |
   | Perfil de Entidade OAuth | Selecione o ícone de pesquisa e localize o perfil de entidade que você criou nas etapas anteriores. |
   | Outros campos | Deixe esses campos em seus padrões. |
   |-|-|

   {#avr-cred-connection-github__choicetable_rtl_kwf_gzb}
5. Clique com o botão direito do mouse em qualquer lugar no cabeçalho da página e selecione Salvar.  
   A lista Credenciais é exibida.
6. Abra o registro que você acabou de criar e selecione o link relacionado Obter token OAuth.  
   É exibida uma mensagem informando que o token OAuth foi importado com sucesso.
7. Navegar até Credenciais e conexõesConexões.
8. Selecione Novo.
9. Selecione Conexão HTTP(s).
10. Selecione Novo e preencha os campos.

    | Campo | Descrição |
    | Nome | Nome do registro. |
    | Aplicação | Somente leitura. |
    | Alias primário (opcional) | Selecione o ícone de pesquisa e escolha um na lista. |
    | Tipo | Conexão e credencial. |
    | Tipo de conexão | HTTP. |
    | Suporte a várias conexões ativas (opcional) | Desativado. |
    | Política de nova tentativa padrão | Política de Repetição de HTTP Padrão |
    | Modelo de configuração | Deixe em branco. |
    |-|-|

    {#avr-cred-connection-github__choicetable_j1h_dxf_gzb}
11. Selecione Enviar.  
    A lista Aliases de conexões e credenciais é exibida.
12. Abra seu registro e, na guia da lista relacionada a Conexões, selecione Novo e preencha os campos no registro de Conexão HTTP.

    | Campo | Descrição |
    | Nome | Nome do registro. |
    | Ativo | Ativado. |
    | Credenciais | Selecione o registro de credencial que você criou nas etapas anteriores. |
    | Alias de conexão | Seu registro é exibido. |
    | Construtor de URL | Desativado. |
    | URL de Conexão | Este é o URL base: <https://api.github.com> para Enterprise. O no local é o URL do endpoint do GitHub. |
    | Usar MID Server (opcional) | O MID Server é necessário para o no local. É opcional para Enterprise. |
    | Tempo limite de conexão | Insira um valor. |
    |-|-|

    {#avr-cred-connection-github__choicetable_wfs_rxf_gzb}
13. Selecione Enviar.  
    A lista Aliases de conexões e credenciais é exibida. Agora você está pronto para concluir as etapas para [Configure o Integrações de vulnerabilidade de aplicação do GitHub](https://servicenow-prod.fluidtopics.net/m_zU1BVji3TRMTFacd95PQ "Antes de executar a integração em sua instância, as etapas de instalação e configuração devem ser concluídas para que o produto GitHub se integre corretamente com Resposta a vulnerabilidades de aplicações. Esta aplicação está disponível como uma assinatura separada."). No campo Conexão, insira as credenciais criadas nas etapas anteriores.