intégration d'enterprise 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

Vérifiez votre org GitHub

Vérifiez que l'org GitHub que vous souhaitez intégrer ne fait 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 sélectionnez une org.

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

    • 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.

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

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 entreprise.

  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 l'org suivante.

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

  1. Connectez-vous à GitHub en tant utilisateur disposant d' un rôle de propriétaire Enterprise pour l'entreprise.

  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 d'entreprise est activé.

  4. Partagez le slug entreprise. Le slug se trouve dans l'URL d'entreprise, par exemple : https://github.com/enterprises/my-org, où my-orgest le slug.

  5. Saisissez les ID d'org séparés par des virgules pour toutes les organisations. 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.

  6. Saisissez le jeton d'accès personnel que vous venez de créer.
  7. Cliquez sur Soumettre.