Activation des produits GitHub Advanced Security pour votre entreprise

À propos de l’activation des produits GitHub Advanced Security

Quand vous activez GitHub Advanced Security pour votre entreprise, les administrateurs de référentiel dans toutes les organisations peuvent activer les fonctionnalités, sauf si vous configurez une stratégie visant à limiter l’accès. Consultez Application de stratégies de sécurité et d’analyse du code pour votre entreprise.

Vous pouvez également activer ou désactiver les fonctionnalités GitHub Advanced Security via l’API. Pour plus d’informations, consultez Points de terminaison d’API REST pour l’analyse de secrets dans la documentation de l’API REST.

Pour obtenir des conseils sur un déploiement par phases de GitHub Advanced Security, consultez Introduction à l'adoption de GitHub Advanced Security à grande échelle.

Vérification de la présence de Advanced Security dans votre licence

1. Dans le coin supérieur droit de GitHub Enterprise Server, cliquez sur votre photo de profil, puis sur Paramètres d’entreprise.
2. Sur le côté gauche de la page, dans la barre latérale du compte d'entreprise, cliquez sur Paramètres.
3. Sous Paramètres, cliquez sur ****.
4. Si votre licence inclut GitHub Advanced Security, la page de licence comprend une section montrant les détails de l’utilisation actuelle.

Prérequis pour l’activation de Advanced Security

1. Mettez à jour votre licence GitHub Enterprise pour inclure Advanced Security. Pour plus d’informations sur les licences, consultez Facturation de licences GitHub Advanced Security.

2. Téléchargez le nouveau fichier de licence. Consultez Téléchargement de votre licence pour GitHub Entreprise.

3. Chargez le nouveau fichier de licence sur GitHub Enterprise Server. Consultez Chargement d’une nouvelle licence sur GitHub Enterprise Server.

4. Passez en revue les prérequis pour les fonctionnalités que vous prévoyez d’activer.

   • Code scanning, consultez Configuration de l’analyse de code pour votre appliance.
   • Secret scanning, consultez Configuration de l’analyse de secrets pour votre appliance.
   • Dependabot, consultez Activation de Dependabot pour votre entreprise.

Activation et désactivation des fonctionnalités Advanced Security

1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

3. Dans la barre latérale « Site admin », cliquez sur Console de gestion.

4. Dans la barre latérale « Paramètres », cliquez sur Sécurité.

5. Sous « Sécurité », sélectionnez les fonctions que vous voulez activer et désélectionnez celles que vous voulez désactiver.

6. Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.

   Remarque

   L’enregistrement des paramètres dans la Console de gestion redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.

7. Attendez la fin de l’exécution de la configuration.

Une fois que GitHub Enterprise Server a redémarré, vous pouvez configurer les ressources supplémentaires nécessaires aux fonctionnalités nouvellement activées. Consultez Configuration de l’analyse de code pour votre appliance.

Activation ou désactivation des fonctionnalités Advanced Security via l’interpréteur de commandes d’administration (SSH)

Vous pouvez activer ou désactiver les fonctionnalités par programmation sur GitHub Enterprise Server. Pour plus d’informations sur l’interpréteur de commandes d’administration et les utilitaires de ligne de commande pour GitHub Enterprise Server, consultez Accès à l’interpréteur de commandes d’administration (SSH) et Utilitaires de ligne de commande.

Par exemple, vous pouvez activer n’importe quelle fonctionnalité de Advanced Security avec vos outils d'infrastructure en tant que code au moment de déployer une instance pour la mise en lots ou la reprise après sinistre.

1. Connexion SSH à votre instance GitHub Enterprise Server. Si votre instance comprend plusieurs nœuds, par exemple si la haute disponibilité ou la géoréplication sont configurées, connectez-vous via SSH au nœud principal. Si vous utilisez un cluster, vous pouvez vous connecter via SSH à n’importe quel nœud. Remplacez HOSTNAME par le nom d’hôte de votre instance, le nom d’hôte ou l’adresse IP d’un nœud. Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Activez les fonctionnalités pour Advanced Security.

   • Pour activer code scanning, entrez les commandes suivantes.

     Shell

     ghe-config app.minio.enabled true
     ghe-config app.code-scanning.enabled true
     

   • Pour désactiver l’secret scanning, entrez la commande suivante.

     Shell

     ghe-config app.secret-scanning.enabled true
     

   • Pour activer le graphique de dépendances, entrez la commande suivante.

     Shell

     ghe-config app.dependency-graph.enabled true
     

3. Vous pouvez désactiver les fonctionnalités pour Advanced Security.

   • Pour désactiver l’code scanning, entrez les commandes suivantes.

     Shell

     ghe-config app.code-scanning.enabled false
     

     • Si vous désactivez code scanning, vous pouvez également désactiver le service MinIO interne pour Advanced Security. Si les Dependabot updates sont activées pour l’instance et que vous souhaitez désactiver ce service, vous devez également désactiver les Dependabot updates. La désactivation du service n’affecte pas le stockage MinIO pour GitHub Actions ou GitHub Packages. Pour plus d’informations sur Dependabot updates, consultez Activation de Dependabot pour votre entreprise.

       • Pour désactiver les Dependabot updates, entrez la commande suivante.

         Shell

         ghe-config app.dependabot.enabled false
         

       • Pour désactiver MinIO, saisissez la commande suivante.

         Shell

         ghe-config app.minio.enabled false
         

   • Pour désactiver l’secret scanning, entrez la commande suivante.

     Shell

     ghe-config app.secret-scanning.enabled false
     

   • Pour désactiver le graphique de dépendances, entrez la commande suivante.

     ghe-config app.dependency-graph.enabled false
     

4. Pour appliquer la configuration, exécutez la commande suivante.

   Remarque

   Durant une exécution de configuration, les services sur votre instance GitHub Enterprise Server peuvent redémarrer, ce qui peut entraîner un bref temps d’arrêt pour les utilisateurs.

   Shell

   ghe-config-apply
   

5. Attendez la fin de l’exécution de la configuration.