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

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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.

    Configurez 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 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 comme URL de rappel d’autorisation. GitHub, GitLab, Bitbucketet Azure les référentiels sont pris en charge par défaut.

    Important :
    Pour Azure les référentiels, la longueur maximale du champ Secret client doit être mise à jour sur 2048 avant d’ajouter le secret.
    1. Accédez à la Tout > Définition du système > Tables.
    2. Filtrez la table en saisissant des oauth_entity pour le champ Nom .
    3. Sélectionnez la table Registres d’application [oauth_entity].
    4. Dans la liste connexe Colonnes, localisez la colonne Secret client et entrez 2048 comme valeur de son attribut Longueur maximale .
    5. Sélectionnez Mettre à jour.

    Rôle requis : admin

    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 section Connect to a third-party OAuth provider.

      Tableau 1. Formulaire des registres d'application
      Champ Description
      Nom Nom unique pour la connexion OAuth tierce.
      ID client L’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
      • Azure Référentiels : OAuthAPIScriptForAzureRepos
      Remarque :
      Pour utiliser d’autres fournisseurs Git, vous pouvez utiliser ces scripts comme exemples 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 Le 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 de validité du jeton d’actualisation, en secondes.
      Demande Le périmètre de l’application qui contient cet enregistrement.
      Accessible depuis 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 Une 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
      • Azure Dépôts : https://app.vssps.visualstudio.com/oauth2/authorize
      URL de jeton Le point de terminaison du 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
      • Azure Référentiels : https://app.vssps.visualstudio.com/oauth2/token
      URL de redirection Point de terminaison de rappel OAuth. Si ce champ est vide, l’instance génère automatiquement une valeur 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 façon dont le client OAuth renseigne les informations d’identification du client dans la demande.
      • Pour GitHub, GitLabou Bitbucket, sélectionnez En tant qu’en-tête d’autorisation de base.
      • Pour Azure Référentiels, sélectionnez Dans le corps de la demande (codage URL de formulaire).
    4. Sélectionnez Soumettre.

    Que faire ensuite

    Les développeurs utilisant le ServiceNow IDE doivent configurer leurs propres informations d’identification OAuth 2.0.

    Configurer les informations d’identification OAuth 2.0 pour se connecter à un fournisseur Git avec le 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 de .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 Configurez un registre d’application OAuth 2.0 pour le ServiceNow IDE.
    • Créez un référentiel Git dédié pour une application dans un fournisseur Git tel que GitHub, GitLab, Bitbucketou Azure Repos.

    Rôle requis : sn_glider.ide_git_user ou admin

    Procédure

    1. Accédez à la Tout > Développement d’applications > 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. C’est là qu’intervient Git : définissez les informations d’identification Git de l’IDE , puis appuyez sur Entrée.
    4. Dans le formulaire Nouvelles informations d’identification 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 URL d’un référentiel Git associée aux informations d’identification de votre fournisseur Git.
      Nom d’utilisateur Git Votre nom d’utilisateur Git.
      Sélectionner un profil OAuth Les informations d’identification OAuth 2.0 pour votre fournisseur Git.

      Le profil OAuth est créé avec le registre d’application, qui doit être configuré par un administrateur.
      Utilisez ces informations d’identification pour tous les référentiels Option permettant d’utiliser les informations d’identification pour tous les référentiels du domaine Git associé à l’URL du référentiel Git.
    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 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.