Configurer un GitLab spoke

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

Avant de commencer

• Demander Hub d'intégration un abonnement
• Activer le module d’extension de GitLab spoke
• Créer un compte avec GitLab at 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 de 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	Profil OAuth créé lors de GitLabSpoke l’inscription en tant que fournisseur OAuth. Par exemple, sélectionnez Profil GitLab OAuth.

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 sécurisé.
   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 fichier .

Avant de commencer

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

Pourquoi et quand exécuter cette tâche

Effectuez ces étapes à partir de votre GitLab compte. Voir le GitLab Documentation pour obtenir des instructions sur la création et la configuration d’applications.

Procédure

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

   Remplacez <Instance-Name> par le nom de votre ServiceNow instance et remplacez <Secure-Token> par le jeton de sécurité que vous avez généré dans l’instance ServiceNow.

3. Copiez et enregistrez l’ID d’application et le secret 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 Edit (Modifier ) ou, si vous configurez le spoke pour la première fois, cliquez sur Configure (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	Saisissez https://gitlab.com/api. Remarque : Si vous l’avez installé GitLab sur un serveur sur site, entrez l’URL au format suivant : https://<gitlab-hosted-instance>.com/api
   Nom de l’entité OAuth	Nom permettant d’identifier l’enregistrement de l’entité OAuth.
   ID client OAuth	ID d’application créé pendant 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://<instance-name>.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=<Secure-Token>. Remplacez <Instance-Name> par le nom de votre ServiceNow instance et remplacez <Secure-Token> par le jeton de sécurité que vous avez généré dans l’instance ServiceNow.

6. Cliquez sur Configurer et obtenir le jeton OAuth.