Configurer le GitLab spoke

Intégrez votre ServiceNow instance et le GitLab en créant une application OAuth personnalisée dans le GitLab.

Avant de commencer

• Demandez un Hub d'intégration abonnement.
• Activez le spoke GitLab.
• Créez un compte avec GitLab au https://gitlab.com/users/sign_in.
• Rôle requis : admin.

Ajouter un jeton GitLab

Ajoutez GitLab un jeton pour authentifier les demandes de votre ServiceNow instance.

Avant de commencer

Rôle requis : admin.

Procédure

1. Accédez à la Tout > Gestion des jetons GitLab > Gestions des jetons GitLab.
2. Cliquez sur Nouveau.
3. Renseignez ces valeurs sur le formulaire.

   Tableau 1. Formulaire Gestion des jetons GitLab

   Champ	Description
   Clé secrète	Clé secrète créée lors de la configuration de l’application GitLab .
   Nom	Nom permettant d'identifier l'enregistrement.
   Profil de l'entité OAuth	Laissez le champ vide. Le système affecte automatiquement le profil d’entité par défaut une fois la connexion configurée.

4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
5. Cliquez sur Générer un jeton de sécurité.
   La valeur du jeton sécurisé généré s’affiche.
6. Copiez et enregistrez la valeur du jeton de sécurité pour une utilisation ultérieure.
7. Cliquez sur Mettre à jour.

Créer une application OAuth dans le GitLab compte

Créez une application OAuth personnalisée à partir de votre GitLab compte pour activer l’authentification OAuth 2.0 avec le GitLabSpoke .

Avant de commencer

• GitLab compte
• Rôle requis : admin GitLab.

Pourquoi et quand exécuter cette tâche

Suivez ces étapes à partir de votre GitLab compte. Voir le GitLab documentation contenant des instructions sur la création et la configuration des applications.

Procédure

1. À partir de votre GitLab compte, créez une application.
2. Saisissez l’URL d’instance ServiceNow dans l’URI de redirection.
   Le format de l’URL de redirection est le suivant : https://<nom-instance>.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=<Secure-Token>.

   Remplacez <Nom d’instance> par le nom de votre ServiceNow instance et remplacez < Jeton sécurisé > par le jeton sécurisé que vous aviez généré dans l’instance ServiceNow.

3. Copiez et enregistrez l’ID et le secret de l’application pour une utilisation ultérieure.
   Ces détails sont nécessaires pour enregistrer l’application en tant que fournisseur OAuth tiers sur votre ServiceNow instance.

Résultats

L’application OAuth personnalisée de votre GitLab compte est créée et peut être intégrée à l’instance ServiceNow .

Configurer une connexion pour le spoke GitLab

Ajoutez et configurez une connexion GitLab pour authentifier les demandes ServiceNow dans le spoke GitLab.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Automatisation des processus > Concepteur de flux.
2. Cliquez sur l’onglet Connexions .
3. Localisez l’alias de connexion GitLab et cliquez sur Afficher les détails.
4. Cliquez sur Modifier ou, si vous configurez le spoke pour la première fois, cliquez sur Configurer.
5. Renseignez les champs du formulaire Connexion .

   Champ	Description
   Nom de la connexion	Nom permettant d’identifier la connexion de façon unique.
   URL de connexion	Entrez https://gitlab.com/api. Remarque : Si vous avez installé GitLab sur un serveur sur site, saisissez l’URL au format suivant : https://<gitlab-hosted-instance>.com/api
   Nom de l’entité OAuth	Nom permettant d’identifier l’enregistrement d’entité OAuth.
   ID client OAuth	ID d’application créé lors de la configuration de l’application GitLab .
   Secret client OAuth	Clé secrète créée lors de la configuration de l’application GitLab .
   URL de redirection OAuth	Point de terminaison de rappel OAuth. Le format de l’URL de redirection est le suivant : https://<nom-instance>.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=<Secure-Token>. Remplacez <Nom d’instance> par le nom de votre ServiceNow instance et remplacez < Jeton sécurisé > par le jeton sécurisé que vous aviez généré dans l’instance ServiceNow.

6. Cliquez sur Configurer et obtenir le jeton OAuth.