Documentation Oracle Cloud Infrastructure

Configurer Git Credential Manager

Utilisez un gestionnaire d'informations d'identification Git pour stocker et réutiliser en toute sécurité des jetons d'authentification Oracle Cloud Infrastructure pour les opérations Git avec des référentiels de code DevOps.

Lorsque vous accédez à un référentiel de code OCI DevOps via HTTPS, vous devez fournir une authentification pour chaque opération Git. Nous vous recommandons d'utiliser des jetons d'authentification pour une sécurité renforcée.

Pour rationaliser davantage l'accès, vous pouvez utiliser un GCM pour stocker les informations d'identification en toute sécurité sur le système local. Vous pouvez également configurer des clés SSH pour l'authentification Git au lieu d'utiliser un jeton d'authentification via HTTPS.

Cette section explique comment stocker et gérer en toute sécurité les informations d'identification pour les opérations Git avec les référentiels de code Oracle Cloud Infrastructure (OCI) DevOps.

Prérequis

  • Accordez aux utilisateurs le droit d'accéder aux référentiels de code DevOps et aux ressources associées en créant des stratégies IAM. Pour plus d'informations, reportez-vous à Stratégies de référentiel de code et à Stratégies IAM DevOps.
  • Créez un jeton d'authentification pour chaque utilisateur qui utilise Git avec les référentiels de code OCI DevOps.
  • Créez un référentiel de code associé à un projet DevOps.
  • Installez Git version 2.11 ou ultérieure sur votre système.

  • Configurez le nom d'utilisateur et l'adresse électronique Git. Git utilise ces valeurs pour identifier les validations.

    git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Configurer Git Credential Manager

Vous pouvez utiliser GCM inclus avec le système d'exploitation pour stocker le jeton d'authentification OCI. Suivez les instructions du système d'exploitation.

Une fois le jeton d'authentification stocké par le gestionnaire d'informations d'identification, il réutilise automatiquement le jeton d'authentification pour les opérations Git via HTTPS. Vous êtes invité à nouveau uniquement si vous modifiez le jeton d'authentification ou enlevez les informations d'identification stockées.

Configuration de GCM pour Windows

Utilisez le gestionnaire d'informations d'identification Git inclus dans Git pour Windows pour stocker le jeton d'authentification OCI.

  1. Installez Git pour Windows. Le gestionnaire des informations d'identification Git est inclus par défaut.
  2. Ouvrez une invite de commande.
  3. Définissez GCM comme assistant par défaut : git config --global credential.helper manager-core
  4. Cloner le référentiel à l'aide de HTTPS : git clone https://<oci_user>@<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git
  5. Lorsque vous êtes invité à saisir un mot de passe, collez le jeton d'authentification OCI.

Configuration de GCM pour macOS

Utilisez l'assistant de trousseau macOS pour stocker le jeton d'authentification OCI pour les opérations Git sur HTTPS.

  1. Installez Git pour macOS.
  2. Définissez l'assistant du trousseau de clés macOS comme gestionnaire d'informations d'identification par défaut : git config --global credential.helper osxkeychain
  3. Cloner le référentiel à l'aide de HTTPS : git clone https://<oci_user>@<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git
  4. Lorsque vous êtes invité à saisir un mot de passe, collez le jeton d'authentification OCI.

Configuration de GCM pour Linux

Installez Git Credential Manager Core et configurez-le comme assistant par défaut pour Git.

  1. Installez Git à l'aide du gestionnaire de packages.
  2. Installez Git Credential Manager Core en suivant les instructions de la section Git Credential Manager Core.
  3. Définissez GCM comme assistant par défaut : git config --global credential.helper manager-core

    La valeur de l'assistant d'informations d'identification est manager-core.

  4. Cloner le référentiel à l'aide de HTTPS : git clone https://<oci_user>@<region>.devops.oci.oraclecloud.com/namespaces/<tenancy>/projects/<project>/repositories/<repo>.git
  5. Lorsque vous êtes invité à saisir un mot de passe, collez le jeton d'authentification OCI.

Vérification de la configuration de l'assistant d'informations d'identification

Exécutez la commande suivante pour vérifier la configuration de l'assistant d'informations d'identification :

git config --global credential.helper

La sortie doit afficher le gestionnaire d'informations d'identification pour votre système d'exploitation.

Une fois le jeton d'authentification stocké par le gestionnaire d'informations d'identification, il réutilise automatiquement le jeton d'authentification pour les opérations Git via HTTPS. Vous êtes invité à nouveau uniquement si vous modifiez le jeton d'authentification ou enlevez les informations d'identification stockées.

Mise à jour ou suppression des informations d'identification stockées

  • Sous Windows, utilisez Gestionnaire d'informations d'identification pour modifier ou supprimer des éléments enregistrés.
  • Sur macOS, utilisez Keychain Access.
  • Sous Linux, utilisez la documentation du gestionnaire d'informations d'identification pour gérer les entrées.

Pour effacer les informations d'identification de la ligne de commande, exécutez la commande suivante :

git credential-manager erase

Configuration d'un proxy pour Git

Si le réseau requiert un proxy pour le trafic HTTPS sortant, configurez les paramètres de proxy dans Git :

git config --global http.proxy http://proxy:port
git config --global https.proxy http://proxy:port

Pour supprimer les paramètres proxy, exécutez la commande suivante :

git config --global --unset http.proxy
git config --global --unset https.proxy

La configuration d'un proxy pour Git est facultative.

Conseils de sécurité

  • Effectuez une rotation périodique des jetons d'authentification et mettez à jour les informations d'identification stockées après la rotation.
  • Stockez les jetons d'authentification en toute sécurité et ne les partagez pas.

Dépannage

  • Si vous recevez des erreurs d'authentification, vérifiez que le gestionnaire d'informations d'identification est configuré correctement et que le jeton d'authentification est valide.
  • Si vous avez modifié ou révoqué un jeton, mettez à jour les informations d'identification stockées ou enlevez-les avant de réessayer.
  • Si vous recevez une erreur d'échec d'authentification, générez un nouveau jeton d'authentification et réessayez l'opération Git.
  • Si vous recevez une erreur de référentiel introuvable, vérifiez l'URL du référentiel et vérifiez que les stratégies IAM requises sont définies.
  • Si vous recevez une erreur 403 Forbidden, vérifiez que vous disposez des droits d'accès requis pour accéder au référentiel.

  • Pour réinitialiser la configuration de l'assistant d'informations d'identification, exécutez la commande suivante :

    git config --global --unset credential.helper

  • Pour supprimer les informations d'identification stockées, exécutez la commande suivante :

    git credential-manager erase

  • Pour collecter des informations de diagnostic, exécutez la commande suivante :

    git credential-manager diagnose