Bien démarrer avec la résidence des données pour GitHub Enterprise Cloud

Lorsque vous adoptez GitHub Enterprise Cloud avec résidence des données, vous pouvez choisir l'endroit où le code et les données de votre entreprise sont stockés.

Une fois que vous avez travaillé avec L’équipe commerciale GitHub pour créer un compte d’entreprise avec une URL dédiée sur GHE.com, vous allez utiliser ce guide pour configurer votre entreprise. Vous allez :

• Ajoutez des utilisateurs en configurant l’authentification et l’approvisionnement avec un système de gestion des identités
• Configuration de la facturation pour votre entreprise
• Au choix, migrez des données depuis une autre plateforme
• Découvrez les fonctionnalités disponibles, notamment les fonctionnalités qui fonctionnent différemment ou nécessitent une configuration supplémentaire

Après cette configuration initiale, vous pourrez créer des organisations et des référentiels, collaborer sur du code, configurer des stratégies, etc.

Prérequis

• Vous devez avoir été approvisionné avec une entreprise sur GHE.com.

• Si vous envisagez de payer avec un abonnement Microsoft Azure, vous devez disposer d’un accès administrateur au portail Azure ou travailler avec quelqu’un pour configurer un flux de travail de consentement administrateur. Pour obtenir la liste complète des conditions préalables, consultez « Connexion à un abonnement Azure. »

• Vous devez vous assurer que les systèmes clients font confiance aux empreintes digitales de la clé SSH de GitHub et peuvent accéder à certains noms d'hôtes et adresses IP. Consultez « Détails du réseau pour GHE.com ».

1. Ajouter des utilisateurs à votre entreprise

Les entreprises sur GHE.com utilisent Enterprise Managed Users. Pour créer des comptes d’utilisateur et accorder l’accès à votre nouvelle entreprise sur GHE.com, vous devez configurer l’authentification et l’approvisionnement SCIM. Consultez « Bien démarrer avec Enterprise Managed Users ».

Connectez-vous en tant qu’utilisateur de configuration

Après avoir créé votre entreprise, vous recevrez un e-mail vous invitant à choisir un mot de passe pour l’utilisateur de configuration, qui est utilisé pour configurer l’authentification et l’approvisionnement. Le nom d’utilisateur est un shortcode généré de manière aléatoire, suffixe avec _admin.

En utilisant une fenêtre de navigation privée ou incognito :

1. Définissez le mot de passe de l’utilisateur.
2. Enregistrez les codes de récupération de l’utilisateur.

Si vous devez réinitialiser le mot de passe de votre utilisateur de configuration, contactez Support GitHub à partir du Portail de support GitHub. L’option de réinitialisation de mot de passe habituelle en fournissant votre adresse e-mail ne fonctionnera pas.

Créer un personal access token

Ensuite, créez un personal access token que vous pouvez utiliser pour configurer l’approvisionnement.

• Vous devez être connecté en tant qu’utilisateur d’installation lorsque vous créez le jeton.
• Le jeton doit avoir au moins l’étendue scim:enterprise.
• Le jeton ne doit pas avoir d’expiration.

Pour apprendre à créer un personal access token (classic), consultez « Gestion de vos jetons d'accès personnels ».

Configurer l’authentification

Ensuite, configurez la façon dont vos membres doivent s’authentifier.

Si vous utilisez Entra ID comme IdP, vous pouvez choisir entre OpenID Connect (OIDC) et Security Assertion Markup Language (SAML).

• Nous recommandons OIDC, qui inclut la prise en charge des stratégies d’accès conditionnel (CAP).
• Si vous avez besoin de plusieurs entreprises provisionnées à partir d'un seul locataire, vous pouvez utiliser SAML ou OIDC pour la première entreprise, mais vous devez utiliser SAML pour chaque entreprise supplémentaire.

Si vous utilisez un autre fournisseur d’identité, comme Okta ou PingFederate, vous devez utiliser SAML pour authentifier vos membres.

Pour démarrer, lisez le guide relatif à la méthode d’authentification choisie.

• « Configuration d’OIDC pour les utilisateurs managés par l’entreprise »
• « Configuration de l’authentification unique SAML pour Enterprise Managed Users »

Configurer l’approvisionnement

Après avoir configuré l'authentification, vous pouvez configurer le provisionnement SCIM, qui est la façon dont votre IdP créera comptes d’utilisateur managés sur GitHub. Consultez « Configurer l’approvisionnement SCIM pour les utilisateurs gérés par l’entreprise ».

Gérer l’appartenance à l’organisation

Une fois l’authentification et le provisionnement configurés, vous pouvez commencer à gérer l’appartenance à l’organisation pour vos comptes d’utilisateur managés en synchronisant les groupes d’IdP avec les équipes. Consultez « Gestion des appartenances aux équipes avec des groupes de fournisseur d’identité ».

2. Configurer la facturation

Pour payer des licences et des services, vous pouvez utiliser une carte de crédit, PayPal ou un abonnement Microsoft Azure.

• Pour ajouter une carte de crédit ou des détails PayPal, consultez « Gestion de vos informations de paiement et de facturation. »
• Pour lier un abonnement Azure, consultez « Connexion à un abonnement Azure. »

3. Migration des données

Au choix, pour migrer des données existantes vers votre nouvelle entreprise sur GHE.com, vous pouvez utiliser les outils de migration GitHub.

• Si vous migrez à partir de GitHub.com, GitHub Enterprise Server, Azure DevOps ou Bitbucket Server, vous pouvez migrer l’historique et les métadonnées du code source avec GitHub Enterprise Importer. Consultez « À propos de GitHub Enterprise Importer ».
• Si vous effectuez une migration à partir d’une autre plateforme, consultez « Chemins de migration vers GitHub. »

Script d’exemple pour GitHub Enterprise Importer

Le script suivant illustre l’utilisation de GitHub Enterprise Importer pour la migration d’un référentiel source individuel depuis GitHub.com vers un référentiel cible sur GHE.com. Le paramètre --target-api-url configure votre entreprise sur GHE.com en tant que destination de la migration.

Vous pouvez utiliser les définitions de variables d’environnement dans le script comme exemple pour créer des commandes supplémentaires qui migrent des données en utilisant GitHub Enterprise Importer.

Dans le script suivant, remplacez le texte d’espace réservé suivant par des valeurs réelles.

#!/bin/sh

export GH_PAT="TARGET-TOKEN"
export GH_SOURCE_PAT="SOURCE-TOKEN"
export TARGET_API_URL="TARGET-GHE-API-URL"
export GITHUB_SOURCE_ORG="SOURCE-GH-ORGANIZATION-NAME"
export SOURCE_REPO="SOURCE-GH-REPOSITORY-NAME"
export GITHUB_TARGET_ORG="TARGET-GHE-ORGANIZATION-NAME"
export TARGET_REPO="TARGET-GHE-REPOSITORY-NAME"

gh gei migrate-repo --target-api-url $TARGET_API_URL --github-source-org $GITHUB_SOURCE_ORG --source-repo $SOURCE_REPO --github-target-org $GITHUB_TARGET_ORG --target-repo $TARGET_REPO --verbose

#!/bin/sh

export GH_PAT="TARGET-TOKEN"
export GH_SOURCE_PAT="SOURCE-TOKEN"
export TARGET_API_URL="TARGET-GHE-API-URL"
export GITHUB_SOURCE_ORG="SOURCE-GH-ORGANIZATION-NAME"
export SOURCE_REPO="SOURCE-GH-REPOSITORY-NAME"
export GITHUB_TARGET_ORG="TARGET-GHE-ORGANIZATION-NAME"
export TARGET_REPO="TARGET-GHE-REPOSITORY-NAME"

gh gei migrate-repo --target-api-url $TARGET_API_URL --github-source-org $GITHUB_SOURCE_ORG --source-repo $SOURCE_REPO --github-target-org $GITHUB_TARGET_ORG --target-repo $TARGET_REPO --verbose

4. Découvrez les fonctionnalités de GitHub

Une fois que vous avez terminé la configuration initiale de votre entreprise, vous et les membres de votre entreprise pouvez commencer à utiliser les fonctionnalités de GitHub.

Les fonctionnalités disponibles avec différente sur GHE.com sont similaires aux fonctionnalités disponibles pour comptes d’utilisateur managés sur GitHub.com, avec quelques ajouts et exceptions. Certaines fonctionnalités fonctionnent différemment ou nécessitent une configuration supplémentaire par rapport à la fonctionnalité équivalente sur GitHub.com. Consultez « Vue d’ensemble des fonctionnalités de GitHub Enterprise Cloud avec résidence des données ».

Pour aller plus loin

• « Résolution des problèmes liés à votre entreprise sur GHE.com »