Intégration org GitHub

Suivez les étapes suivantes pour intégrer Identity Security Posture Management (ISPM) à vos organisations GitHub :

  1. Vérifiez votre org GitHub

  2. Placer des adresses IP ISPM sur la liste d'autorisation

  3. Installer Spera Security

  4. Création d'un jeton d'accès personnel

  5. Partager les paramètres

Avant de commencer

  • Effectuez les étapes de cette section uniquement si les organisations sélectionnées pour l'intégration ne font pas partie d'une entreprise.

  • Assurez-vous d'utiliser un compte qui dispose du rôle de propriétaire de l'organisation pour toutes les organisations que vous souhaitez intégrer à ISPM. C'est nécessaire pour ISPM pour surveiller et détecter les problèmes pour vos organisations.

Vérifiez votre org GitHub

Vérifiez que les organisations GitHub que vous souhaitez intégrer ne font pas partie d'une entreprise :

  1. Accédez à la page GitHub de l'organisation.

  2. Cliquez sur l'icône de profil pour ouvrir le menu déroulant.

  3. Cliquez sur Vos organisations, puis cliquezsélectionner une org.

    • Si le nom de entreprise n'apparaît pas après le nom de l'organisation, alors cette org ne fait pas partie d'une entreprise.

    • Si l'org appartient à une entreprise, le nom de entreprise apparaît après le nom de l'organisation.

  4. Si les organisations que vous souhaitez intégrer ne font pas partie d'une entreprise, suivez les étapes listées dans cette rubrique. Si les organisations que vous souhaitez intégrer font partie d'une entreprise, suivez les étapes listées dans la rubrique GitHubIntégration Enterprise.

  5. Répétez les étapes 1 à 4 pour chaque org que vous souhaitez intégrer à ISPM.

Placer des adresses IP ISPM sur la liste d'autorisation

Facultatif. Si votre entreprise GitHub est restreinte par une liste d'autorisation IP, ajoutez les adresses IP du serveur ISPM Okta à votre liste d'autorisation IP :

  1. Sélectionnez votre photo de profil , puis cliquez sur Votre organisation.

  2. À côté de votre entreprise, cliquez sur Paramètres.

  3. Dans la barre latérale, sélectionnez Sécurité de l'authentification.

  4. Faites défiler jusqu'à la section Liste d'autorisation IP :

    1. Activez la liste d'autorisation IP et cliquez sur Enregistrer.

    2. Activez la Configuration de la liste d'autorisation pour les applications GitHub installées et cliquez sur Enregistrer.

    3. Dans le champ Adresse IP ou plage en notation du routage inter-domaines sans classe (CIDR), saisissez l'une des adresses IP suivantes :

      • 18.98.16.160/27

      • 3.44.64.96/27

      • 3.40.0.96/27

      • 13.52.68.184

      • 54.193.209.206

      • 13.57.96.208

      • 184.72.14.192

      • 13.57.65.107

      • 13.57.96.250

      • 18.99.81.192/27

      • 18.97.155.0/27

    4. Cliquez sur Ajouter.

  5. Répétez l'étape 4 pour toutes les adresses IP ISPM.

Installer Spera Security

Vous devez être un propriétaire d'organisation pour effectuer cette tâche.

  1. Accédez à la page app Spera Security.

  2. Cliquez sur Installer ou Configurer.

  3. Sélectionnez l'org dans laquelle vous souhaitez installer l'app.

  4. Sélectionnez Tous les référentiels et cliquez sur Installer et autoriser. Le système vous invite à approuver plusieurs autorisations en lecture seule.

  5. Répétez les étapes 1 à 4 pour chaque org que vous souhaitez intégrer à ISPM.

Création d'un jeton d'accès personnel

  1. Connectez-vous à GitHub en tant qu'utilisateur avec le rôle de propriétaire de l'organisation pour les organisations que vous souhaitez intégrer à ISPM.

  2. Accédez à votre tableau de bord GitHub et cliquez sur l'icône de votre profil pour ouvrir le menu.

  3. Accédez à Paramètres > Paramètres du développeur > Jetons d'accès personnels > Jetons (classiques).

  4. Cliquez sur Générer un nouveau jeton et sélectionnez Générer un nouveau jeton (classique).

  5. Saisissez une Note pour votre nouveau jeton d'accès personnel (classique), par exemple, Identity Security Posture Management Integration.

  6. Définissez la valeur Expiration dans un an à partir d'aujourd'hui :

    1. Ouvrez le menu Expiration et sélectionnez Personnalisé.

    2. Saisissez ou sélectionnez la date d'expiration.

  7. Dans la section Sélectionner les permissions, sélectionnez les permissions suivantes :

    • read:org

    • read:user

    • user:email

    • read:enterprise

    • read:audit_log

  8. Cliquez sur Générer le jeton.

  9. Copiez votre jeton et stockez-le en toute sécurité.

Partager les paramètres avec ISPM

  1. Dans la console Identity Security Posture Management, accédez à Paramètres > Galerie des intégrations.

  2. Sélectionnez GitHub et cliquez sur Se connecter.

  3. Assurez-vous que le paramètre Compte Enterprise est désactivé.

  4. Partagez les ID d'org pour toutes les organisations sélectionnées. Vous pouvez trouver l'ID de l'org en vous rendant sur l'org que vous avez connectée à ISPM et en copiant l'ID depuis l'URL. Par exemple : https://github.com/my-org, où my-org correspond à l'ID de l'org.
  5. Saisissez le jeton d'accès personnel que vous venez de créer.
  6. Cliquez sur Soumettre.