---
sourceDocument: Gestion de la sécurité Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/security-management

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Gestion de la sécurité Xanadu

ft:clusterId :

    - security

bundleId :

    - security

workflow :

    - Technology


---

# Création d'informations d'identification OAuth 2.0 pour GitHub les applications : JWT pour le GitHub Application Vulnerability Integration

# Création d'informations d'identification OAuth 2.0 pour GitHub les applications : JWT pour le GitHub Application Vulnerability Integration {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 minutes de lecture

Procédez comme suit pour intégrer vos GitHub applications à l'aide du jeton JWT Bearer pour le GitHub Application Vulnerability Integration.  
Rôles requis :

* sn_vul.app_sec_manager et admin pour les enregistrements de votre Now Platformfichier .
* Aucun rôle d'instance requis pour les tâches de votre GitHub compte.
{#github-app-vuln-apps-oauth-jwt__ul_rnt_4jq_cbc}.

## Créez et configurez l'application GitHub pour le GitHub Application Vulnerability Integration {#ariaid-title2}

Créez une application personnalisée GitHub à partir de votre GitHub compte pour activer l'authentification OAuth 2.0 avec vous GitHub Application Vulnerability Integration dans votre instance.

### Avant de commencer

Rôle requis : aucun rôle d'instance requis

### Pourquoi et quand exécuter cette tâche

Suivez ces étapes à partir de votre GitHub compte. Reportez-vous à [Bâtiment GitHub Applications](https://developer.github.com/apps/building-github-apps/) sur le site Developer pour obtenir des instructions sur la création et la GitHub configuration d'applications personnalisées.

### Procédure

1. À partir de votre GitHub compte, créez votre GitHub application en accédant à Paramètres de développeurApplications GitHub.
2. Dans le champ URL de la page d'accueil , saisissez <kbd class="ph userinput">https://&lt;nom-instance&gt;.service-now.com</kbd>.
3. Dans le champ URL de rappel d'autorisation de l'utilisateur , saisissez <kbd class="ph userinput">https://&lt;nom-instance&gt;.service-now.com/oauth_redirect.do</kbd>.
4. Dans la section Identification et autorisation des utilisateurs , désélectionnez le champ Faire expirer les jetons d'autorisation de l'utilisateur .
5. Dans la section Webhook , sélectionnez le champ Actif .
6. Dans le champ URL Webhook , saisissez <kbd class="ph userinput">https://instance-name&gt;.service-now.com/</kbd>.
7. Laissez les champs restants vides (par défaut).
8. Dans la section Autorisations du référentiel , configurez les paramètres suivants.  

   |-|-|
   | Analyse de code | Lecture seule |
   | Contenus | Lecture seule |
   | Propriétés personnalisées | Lecture seule |
   | Alertes Dependabot | Lecture seule |
   | Métadonnées | Lecture seule |
   [ ]

   {#github-avr-config-github-app-jwt__table_j5m_wcs_4mb}  
   Remarque :  
   Si vous utilisez déjà une application GitHub et que vous mettez à jour l'une des autorisations, vous devez vérifier et accepter ces autorisations pour votre application GitHub. Vous pouvez accéder à votre application, puis sélectionner Configurer \> demande d'examen \> Accepter de nouvelles autorisations.
9. Laissez les autorisations restantes sur <kbd class="ph userinput">Aucun accès</kbd> (par défaut).
10. Dans la section S'abonner aux événements , sélectionnez l'option Règle de protection du déploiement .
11. Cliquez avec le bouton droit de la souris dans l'en-tête pour enregistrer les modifications.
12. Installez l'application nouvellement créée GitHub sur les comptes de votre choix.
    1. Sur la page des paramètres des applications GitHub, sélectionnez votre application.
    2. Dans la barre latérale gauche, sélectionnez Installer l'application.
    3. Sélectionnez Installer à côté du compte d'organisation ou personnel contenant le référentiel approprié.
    4. Installez l'application sur tous les référentiels ou sélectionnez des référentiels.  
       Pour plus d'informations, consultez [Installation d'applications 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. Après l'installation, sélectionnez les paramètres (icône d'engrenage) de votre application et notez ou notez les informations suivantes.  
    Ces détails sont requis lorsque vous créez le registre d'application dans votre Now Platform instance.
    * ID d'application
    * ID client
    * Secret client.
    * Notez le jeton dans l'URL. Il s'agit de l'ID de jeton que vous saisissez dans l'URL du jeton de votre instance.
    {#github-avr-config-github-app-jwt__ul_kz2_b4q_cbc}
14. Faites défiler la page vers le bas et générez une nouvelle clé privée et enregistrez-la sur votre ordinateur.

## Générer le certificat JKS pour le GitHub Application Vulnerability Integration {#ariaid-title3}

Générez un certificat JKS pour l'authentification JWT pour le GitHub Application Vulnerability Integration.

### Avant de commencer

Vous devez noter le mot de passe que vous utilisez pour générer le fichier .jks (mot de passe KeyStore).

Rôle requis : sn_vul.app_sec_manager

### Procédure

1. Créez un certificat signé par une autorité de certification à l'aide de la clé privée de l'application GitHub :  

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

2. Saisissez les informations requises.
3. Créez le fichier PKCS 12 à l'aide de la clé privée de l'application et du certificat signé par l'autorité de GitHub certification :  

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

4. Fournissez le mot de passe d'exportation.
5. Créez le fichier JKS :  

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

6. Fournissez les mots de passe de magasin de clés de destination et source.

## Joindre le GitHub certificat Java Key Store à votre instance pour le GitHub Application Vulnerability Integration {#ariaid-title4}

Activez l'authentification du jeton JWT Bearer Grant en joignant le certificat GitHub Java KeyStore (JKS) valide à votre instance.

### Avant de commencer

Un certificat Java KeyStore valide.

Rôle requis : sn_vul.app_sec_manager

### Procédure

1. Accédez à la ToutDéfinition du systèmeCertificats.
2. Sélectionnez Nouveau.
3. Renseignez les champs du formulaire.  
   {#avr-attach-jks-cert-github__table_hvh_4tt_xgb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, <kbd class="ph userinput">Certificat de mon application GitHub pour AVR</kbd>. |
   | Notification à l'expiration | Option permettant de spécifier les utilisateurs à notifier lorsque le certificat expire. |
   | Avertissement avant l'expiration (en jours) | Nombre de jours avant l'expiration du certificat. |
   | Actif | Option permettant d'activer le certificat. |
   | Type | Option permettant de sélectionner le type de certificat. Sélectionnez le magasin de clés Java. |
   | Échéance en jours | Nombre de jours avant l'expiration du certificat. |
   | Mot de passe de magasin de clés | Mot de passe associé au certificat (indice : le mot de passe KeyStore de destination précédemment créé). |
   | Description brève | Résumé du certificat. |
   [Tableau 1. Champs du formulaire Certificat X.509]

   {#avr-attach-jks-cert-github__table_hvh_4tt_xgb}
4. Sélectionnez l'icône de pièces jointes et joignez un certificat JKS.
5. Sélectionnez Valider les stocks/certificats.  
   Un message key_store valide s'affiche pour les fichiers de certificat valides.

## Créer une clé de signature JWT pour le GitHub certificat JKS pour le GitHub Application Vulnerability Integration {#ariaid-title5}

Créez une clé de signature JSON Web Token (JWT) à affecter à votre GitHub certificat Java KeyStore.

### Avant de commencer

Rôles requis :

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

### Procédure

1. Accédez à la ToutOAuth systèmeClés JWT.
2. Sélectionnez Nouveau.
3. Renseignez les champs du formulaire.  
   {#avr-create-jwt-key-github__table_jky_dk5_xgb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier de façon unique la clé de signature JWT. Par exemple, <kbd class="ph userinput">Clé JWT de mon application GitHub pour AVR</kbd>. |
   | Magasin de clés de signature | Sélectionnez le certificat JKS valide que vous avez joint lors de la tâche précédente. |
   | ID de clé | Laissez ce champ vide. |
   | Algorithme de signature | Laissez cette valeur sur RSA 256. |
   | Signature avec le mot de passe de clé | Mot de passe associé à la clé de signature. Il s'agit du mot de passe que vous avez utilisé pour générer le fichier JKS. |
   | Actif | Option permettant d'activer la clé. |
   [Tableau 2. Champs du formulaire Clés JWT]

   {#avr-create-jwt-key-github__table_jky_dk5_xgb}
4. Cliquez avec le bouton droit de la souris n'importe où dans l'en-tête gris de la page et sélectionnez Enregistrer.

## Créer un fournisseur JWT pour votre GitHub clé de signature pour le GitHub Application Vulnerability Integration {#ariaid-title6}

Ajoutez un fournisseur JSON Web Token (JWT) à votre ServiceNow instance pour GitHub.

### Avant de commencer

Rôles requis :

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

### Procédure

1. Accédez à la ToutOAuth systèmeFournisseurs JWT.
2. Sélectionnez Nouveau.
3. Renseignez les champs du formulaire.  
   {#avr-create-jwt-provider-github__table_l5g_3m5_xgb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier de façon unique le fournisseur JWT. Par exemple, <kbd class="ph userinput">Mon application GitHub Fournisseur JWT pour AVR</kbd>. |
   | Intervalle d'expiration (s) | Nombre de secondes pour définir la durée de vie des jetons de fournisseur JWT. Vous pouvez conserver ce paramètre par défaut. |
   | Configuration de la signature | Sélectionnez la clé JWT que vous avez créée lors des étapes précédentes. |
   [Tableau 3. Champs du formulaire Fournisseur JWT]

   {#avr-create-jwt-provider-github__table_l5g_3m5_xgb}
4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
5. Entrez votre GitHubID d'application d'application pour la valeur de la réclamation iss, dans la liste connexe des réclamations standard.  
   Il s'agit de l'ID de l'application dans votre GitHubGitHub console que vous avez créé lors des étapes précédentes.
6. Laissez les valeurs aud et sub vides (par défaut).
7. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.

## Enregistrer GitHub en tant que fournisseur OAuth (JWT) pour GitHub Application Vulnerability Integration {#ariaid-title7}

Utilisez les informations générées pendant GitHub la configuration du compte d'application pour vous inscrire GitHub en tant que fournisseur OAuth et permettre à l'instance de demander des jetons OAuth 2.0.

### Avant de commencer

Rôles requis :

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

### Procédure

1. Accédez à la ToutOAuth systèmeRegistre d'application.
2. Sélectionnez Nouveau.  
   Le message Quel type d'application OAuth ? s'affiche.
3. Sélectionnez Se connecter à un fournisseur OAuth tiers.
4. Renseignez les champs du formulaire.  
   {#avr-reg-github-oauth-prov-jwt__table_fd2_2xr_4mb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez <kbd class="ph userinput">Fournisseur de mon application GitHub pour AVR</kbd>. |
   | ID client | ID client de votre GitHub application. L'ID client provient de l'application dans votre GitHubGitHub console que vous avez créée lors des étapes précédentes. Cet ID est disponible dans la section À propos de votre GitHub configuration d'application dans GitHub. |
   | Accessible | Conservez la valeur actuelle de ce paramètre. |
   | Secret client | Secret client de votre GitHub application. Le secret client provient de l'application dans votre GitHubGitHub console que vous avez créée lors des étapes précédentes. Cet ID est disponible dans la section À propos de votre GitHub configuration d'application dans GitHub. |
   | Actif | Option permettant d'activer la clé. Laissez cette option sélectionnée. |
   | URL d'autorisation | Cette URL est générée automatiquement. |
   | URL de jeton | Emplacement du point de terminaison de jeton que l'instance utilise pour récupérer et actualiser les jetons. Saisissez le jeton à partir de l'URL dans votre GitHub application. Il s'agit du jeton affiché dans l'URL une fois votre application installée dans GitHub. Dans la section Installer l'application de votre configuration d'application GitHub dans GitHub, sélectionnez l'engrenage. Le jeton est affiché dans l'URL de la page Web. * Pour le cloud : <https://api.github.com/app/installations/49374672/access_tokens>. ID d'installation : 9374672. * Pour les services sur site : <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 de l'API OAuth | Option qui vous permet de référencer un include de script OAuthUtil modifié. Sélectionnez OAuthGitHubJWTHandler. |
   | Type d'accord par défaut | Type de subvention associé au registre d'application. Sélectionnez Support JWT. |
   [Tableau 4. Champs du formulaire Registre d'application]

   {#avr-reg-github-oauth-prov-jwt__table_fd2_2xr_4mb}
5. Laissez les autres champs de formulaire par défaut.
6. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
7. Faites défiler l'écran jusqu'à la liste connexe Profils des entités OAuth , sélectionnez-la et ouvrez le profil par défaut qui a été créé dans la liste.
8. Renseignez le champ Fournisseur JWT avec le fournisseur JWT précédemment créé et enregistrez le formulaire.
9. Revenez au fichier de registre de l'application et enregistrez-le.
10. Accédez à la Gestion des clésPolitiques d'accès au moduleTout.
11. Sélectionnez la politique qui a com_snc_platform_security_oauth_glideencrypter comme valeur de champ du module Chiffrement et l'include de script : OAuthGitHubJWTHandler.  

12. Vérifiez que le champ Résultat est défini sur Suivre et enregistrez vos changements.

## Créez des informations d'identification et des connexions pour le GitHub Application Vulnerability Integration {#ariaid-title8}

Créez un enregistrement d'informations d'identification auprès du fournisseur d'application GitHub précédemment créé pour autoriser les actions.

### Avant de commencer

Rôles requis :

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

### Procédure

1. Accédez à la Informations d'identification et connexionsInformations d'identification.
2. Sélectionnez Nouveau.
3. Sélectionnez Informations d'identification OAuth 2.0.
4. Sélectionnez Nouveau et renseignez les champs.

   | Champ | Description |
   | Nom | Nom unique de l'enregistrement. |
   | Concerne | Sélectionnez les informations d'identification OAuth 2.0 dans la liste. |
   | Profil de l'entité OAuth | Sélectionnez l'icône de recherche et localisez le profil d'entité que vous avez créé lors des étapes précédentes. |
   | Autres champs | Laissez ces champs dans leurs valeurs par défaut. |
   |-|-|

   {#avr-cred-connection-github__choicetable_rtl_kwf_gzb}
5. Cliquez avec le bouton droit de la souris n'importe où dans l'en-tête de la page et sélectionnez Enregistrer.  
   La liste des informations d'identification s'affiche.
6. Ouvrez l'enregistrement que vous venez de créer et sélectionnez le lien connexe Obtenir un jeton OAuth .  
   Un message s'affiche indiquant que le jeton OAuth a été importé avec succès.
7. Accédez à la Informations d'identification et connexionsConnexions.
8. Sélectionnez Nouveau.
9. Sélectionnez Connexion HTTP(s).
10. Sélectionnez Nouveau et renseignez les champs.

    | Champ | Description |
    | Nom | Nom de l'enregistrement. |
    | Application | Lecture seule. |
    | Alias parent (facultatif) | Sélectionnez l'icône de recherche et choisissez-en une dans la liste. |
    | Type | Connexion et informations d'identification. |
    | Type de connexion | HTTP. |
    | Prise en charge de plusieurs connexions actives (facultatif) | Désactivé. |
    | Politique des nouveaux essais par défaut | Politique des nouveaux essais HTTP par défaut |
    | Modèle de configuration | À laisser vide. |
    |-|-|

    {#avr-cred-connection-github__choicetable_j1h_dxf_gzb}
11. Sélectionnez Soumettre.  
    La liste des alias de connexion et d'informations d'identification s'affiche.
12. Ouvrez votre enregistrement et, dans l'onglet de la liste connexe Connexions, sélectionnez Nouveau et remplissez les champs de l'enregistrement de connexion HTTP.

    | Champ | Description |
    | Nom | Nom de l'enregistrement. |
    | Actif | Activé. |
    | Informations d'identification | Sélectionnez l'enregistrement Informations d'identification que vous avez créé lors des étapes précédentes. |
    | Alias de connexion | Votre enregistrement s'affiche. |
    | Générateur d'URL | Désactivé. |
    | URL de connexion | Il s'agit de l'URL de base : <https://api.github.com> pour Enterprise. L'élément sur site correspond à l'URL de votre point de terminaison GitHub. |
    | Utiliser un serveur MID (facultatif) | Serveur MID est requis sur site. C'est facultatif pour les entreprises. |
    | Délai de connexion | Saisissez une valeur. |
    |-|-|

    {#avr-cred-connection-github__choicetable_wfs_rxf_gzb}
13. Sélectionnez Soumettre.  
    La liste des alias de connexion et d'informations d'identification s'affiche. Vous êtes maintenant prêt à effectuer les étapes pour [Configurez la GitHub Application Vulnerability Integration.](https://servicenow-prod.fluidtopics.net/2_~8y9SE_QGFg3aOwMhGzw "Avant d’exécuter l’intégration sur votre instance, les étapes d’installation et de configuration doivent être terminées afin que le produit GitHub s’intègre correctement à Réponse aux vulnérabilités des applications. Cette application est disponible sous forme d’abonnement distinct."). Dans le champ Connexion, saisissez les informations d'identification que vous avez créées lors des étapes précédentes.