Se connecter à un fournisseur Git à l’aide d’OAuth 2.0 avec l’option ServiceNow IDE

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • Configurez un registre d’application OAuth 2.0 et des informations d’identification pour vous connecter à votre fournisseur Git à partir du ServiceNow IDE.

    Configurer un registre d’application OAuth 2.0 pour le ServiceNow IDE

    Configurez la façon dont l’ID client et le secret sont envoyés au fournisseur OAuth 2.0 associé à votre fournisseur Git.

    Avant de commencer

    Créez une application OAuth avec votre fournisseur Git, par exemple GitHub, GitLabou Bitbucket, et configurez-la pour qu’elle soit redirigée vers votre instance. Dans cette application OAuth, utilisez l’URL de votre instance comme URL de la page d’accueil et https://<instance>/oauth_redirect.do pour l’URL de rappel d’autorisation.

    Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    Pour utiliser l’authentification OAuth 2.0 avec le ServiceNow IDE, vous devez enregistrer l’application OAuth que vous avez créée à partir de votre fournisseur Git. Suivez cette procédure pour configurer un registre d’application OAuth [oauth_entity] sur votre instance.

    Procédure

    1. Accédez à la Tout > OAuth système > Registre d'application , puis sélectionnez Nouveau.
    2. Sur la page de l’intercepteur, sélectionnez Se connecter à un fournisseur OAuth tiers.
    3. Renseignez les champs du formulaire.

      Pour en savoir plus sur les champs du formulaire, reportez-vous à la rubrique Connect to a third-party OAuth provider.

      Tableau 1. Formulaire des registres d'application
      Champ Description
      Nom Nom unique de la connexion OAuth tierce.
      ID client ID client de l’application OAuth dans votre fournisseur Git.
      Secret client Clé secrète du client de l’application OAuth dans votre fournisseur Git.
      Script de l'API OAuth Script utilisé pour personnaliser la demande et la réponse au fournisseur OAuth externe. Sélectionnez l’une des options suivantes en fonction de votre fournisseur Git :
      • GitHub: OAuthAPIScriptForGitHub
      • GitLab: OAuthAPIScriptForGitLab
      • Bitbucket: OAuthAPIScriptForBitbucket
      Remarque :
      Pour utiliser d’autres fournisseurs Git, vous pouvez utiliser ces scripts à titre d’exemple pour créer votre propre script d’API OAuth pour votre fournisseur OAuth. Le nom du script doit commencer par « OAuth ».
      Type d'accord par défaut Type d’accord par défaut utilisé pour établir le jeton. Sélectionnez Code d’autorisation.

      Un code d’autorisation est accordé au client pour obtenir un jeton d’accès, qui est ensuite utilisé pour obtenir l’accès à la ressource.
      Durée de vie du jeton d'actualisation Durée, en secondes, pendant laquelle le jeton d’actualisation est valide. La durée par défaut est de 8 640 000 secondes.
      Application Périmètre de l’application qui contient cet enregistrement.
      Accessible depuis Une option permettant de rendre le registre d’application accessible à partir de tous les périmètres de l’application ou uniquement à partir de ce périmètre.
      Actif Option permettant d’activer ou de désactiver l’application OAuth.
      URL d'autorisation Point de terminaison du code d’autorisation OAuth pour votre domaine Git. Par exemple :
      • GitHub: https://github.com/login/oauth/authorize
      • GitLab: https://gitlab.com/oauth/authorize
      • Bitbucket: https://bitbucket.org/site/oauth2/authorize
      URL de jeton Point de terminaison de jeton du serveur OAuth pour votre domaine Git. Par exemple :
      • GitHub: https://github.com/login/oauth/access_token
      • GitLab: https://gitlab.com/oauth/token
      • Bitbucket: https://bitbucket.org/site/oauth2/access_token
      URL de redirection Point de terminaison de rappel OAuth. Si ce champ est vide, l’instance génère automatiquement une valeur de https://<instance>/oauth_redirect.do.
      Activer l'authentification réciproque Option permettant d’utiliser l’authentification réciproque. Laissez cette option décochée pour désactiver l’utilisation de l’authentification réciproque pour la demande et la révocation de jeton.
      Envoyer les informations d'identification La manière dont le client OAuth renseigne les informations d’identification du client dans la demande. Sélectionner comme en-tête d’autorisation de base.
    4. Sélectionnez Soumettre.

    Que faire ensuite

    Les développeurs qui utilisent le doivent configurer leurs propres informations d’identification ServiceNow IDE OAuth 2.0. Pour plus d'informations, consultez Configurez les informations d’identification OAuth 2.0 pour vous connecter à un fournisseur Git avec l’option ServiceNow IDE.

    Configurez les informations d’identification OAuth 2.0 pour vous connecter à un fournisseur Git avec l’option ServiceNow IDE

    Connectez-vous à un domaine ou à un référentiel Git à l’aide des informations d’identification OAuth 2.0 pour gérer les applications dans le contrôle de source à partir du ServiceNow IDE.

    Avant de commencer

    • Un administrateur doit configurer la manière dont l’ID client et le secret sont envoyés au fournisseur OAuth 2.0 associé à votre fournisseur Git. Pour plus d'informations, consultez Configurer un registre d’application OAuth 2.0 pour le ServiceNow IDE.
    • Pour configurer des informations d’identification pour un référentiel plutôt qu’un domaine Git, créez un référentiel Git dédié pour l’application.

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > ServiceNow IDE.
    2. Utilisez l’un des raccourcis clavier suivants pour ouvrir la palette de commandes :
      • Windows : Ctrl-Maj-P
      • Mac : cmd-shift-p
    3. Entrer Git : définissez les informations d’identification Git de l’IDE et appuyez sur Entrée.
    4. Dans le formulaire Informations d’identification New Git, sélectionnez OAuth.
    5. Renseignez les champs du formulaire.
      Tableau 2. Nouveau formulaire d’informations d’identification Git
      Champ Description
      URL du référentiel Git Un nom de domaine de fournisseur Git ou une URL de référentiel.

      Si vous spécifiez un nom de domaine de fournisseur Git, ces informations d’identification sont utilisées pour tous les référentiels du domaine.
      Nom d’utilisateur Git Votre nom d’utilisateur Git.
      Sélectionner un profil OAuth Informations d’identification OAuth 2.0 de votre fournisseur Git.

      Le profil OAuth est créé avec le registre d’application, qui doit être configuré par un administrateur.
    6. Sélectionnez Soumettre.

    Résultats

    La première fois que vous utilisez une commande Git, vous êtes invité à autoriser votre utilisateur à partir du fournisseur Git.

    Que faire ensuite

    Après avoir initialisé ou cloné un référentiel, vous pouvez commencer à utiliser le contrôle de source. Pour plus d'informations, consultez L’utilisation du contrôle de source dans le ServiceNow IDE.

    Pour gérer les informations d’identification Git existantes, utilisez la commande Git : Gérer les informations d’identification Git dans la palette de commandes.