Configurez le First Advantage Spoke

Rversion finale: Australia

Mis à jour 12 mars 2026

7 minutes de lecture

Intégrez l’instance ServiceNow à votre compte à l’aide First Advantage d’une clé API pour authentifier les demandes ServiceNow .

Avant de commencer

Demandez un Centre d'intégration abonnement.
Activez le First Advantage Spoke fichier .
Rôle requis : admin.

Créer un enregistrement de connexion pour le First Advantage Spoke

Créez un enregistrement de connexion pour intégrer votre ServiceNow instance et le serveur First Advantage. Votre ServiceNow instance utilise cet enregistrement de connexion pour effectuer les actions de spoke First Advantage.

Avant de commencer

Rôle requis : admin.

Obtenez la clé API à partir du serveur First Advantage.

Procédure

Accédez à la Tous > Automatisation des processus > Studio de workflow.
Sélectionnez Intégrations.
Sélectionnez l’onglet Connexions .
Dans le champ Rechercher toutes les connexions, saisissez Premier avantage.
Confirmez que l’onglet Sortant est sélectionné.
Dans la vignette FirstAdvantage, sélectionnez Afficher les détails.
Sélectionnez Configurer.

Remplissez le formulaire.

Tableau 1. Formulaire de connexion de spokes First Advantage
Champ	Description
Nom de la connexion	Nom de la connexion. Le nom par défaut et en lecture seule du premier enregistrement est le même que celui de l’alias de connexion. Vous pouvez fournir un nom différent lorsque vous créez un enregistrement de connexion en cliquant sur Ajouter une connexion.
URL de connexion	Option permettant de fournir l’URL de connexion au serveur First Advantage. L’URL est https://rest-ua.fadv.com.
E-mail de distribution	Option permettant de fournir un ID d’e-mail de distribution.
Version	Option permettant de fournir la version de l’API.
Clé API	Option permettant d’entrer la clé API que le serveur First Advantage utilise pour authentifier les demandes d’accès.

Formulaire de connexion First Advantage.

Sélectionnez Configurer la connexion.
L’enregistrement de connexion est configuré.

Créer First Advantage des états dans votre ServiceNow instance

Créez des First Advantage états à afficher dans la liste État de votre ServiceNow instance.

Avant de commencer

Rôle requis : admin

Créer les états Brouillon, Prêt et En cours

Créez les états Brouillon, Prêt et En cours dans la table Tâche [task].

Avant de commencer

Rôle requis : admin.

Procédure

Dans le Navigateur de filtre, saisissez sys_choice.list.
Les enregistrements de la table Choice (Choix) [sys_choice] s’affichent.
Cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire et créez trois enregistrements pour l’état Brouillon.

Tableau 2. Enregistrement 1 : état Brouillon
Champ	Valeur
Table	Tâche [task]
Élément	État
Étiquette	Brouillon
Valeur	137

Remarque :

Assurez-vous de fournir les chiffres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
Assurez-vous que l’enregistrement est créé dans l’application Global .

Cliquez sur Envoyer.

De même, créez des enregistrements pour les états Prêt et En cours.

Tableau 3. Enregistrement 2 : état Prêt
Champ	Valeur
Table	Tâche [task]
Élément	État
Étiquette	Prêt
Valeur	173

Tableau 4. Enregistrement 3 : état en cours
Champ	Valeur
Table	Tâche [task]
Élément	État
Étiquette	En cours
Valeur	181

Remarque :

Assurez-vous de fournir les chiffres exacts dans le champ Valeur , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
Assurez-vous que l’enregistrement est créé dans l’application Global .

Résultats

Les états Brouillon, Prêt et En cours sont créés dans la table Tâche [task]

Créer les états Terminé et Annulé

Créez les états Terminé et Annulé dans la table Tâche First Advantage [sn_fadv_spoke_first_advantage_task].

Avant de commencer

Rôle requis : admin.

Procédure

Accédez à la Tous > First Advantage Spoke > Tâches de commande.
Cliquez sur Nouveau.

Remarque :
Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
Cliquez avec le bouton droit sur État , puis sur Configurer les choix.
Procédez comme suit pour créer l’état Annulé :
1. Entrez Annulé dans le texte du nouvel élément.
2. Entrez 149 en valeur numérique.
  
  Remarque :
  Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.
Procédez comme suit pour créer l’état Terminé :
1. Entrer Terminé dans le texte Nouvel élément.
2. Entrez 127 en valeur numérique.
  
  Remarque :
  Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.

Résultats

Les états Terminé et Annulé sont créés dans la table Tâche First Advantage [sn_fadv_spoke_first_advantage_task].

Créer les états Terminer – Succès et Terminer – Accord rompu

Créez les états Terminer - Succès et Terminer - Accord rompu dans la table Tâche de l’employé First Advantage [sn_fadv_spoke_first_advantage_employee_task_table].

Avant de commencer

Rôle requis : admin.

Procédure

Accédez à la Tous > First Advantage Spoke > Tâche de l’employé.
Cliquez sur Nouveau.

Remarque :
Assurez-vous que l’enregistrement est créé dans l’application First Advantage .
Cliquez avec le bouton droit sur État , puis sur Configurer les choix.
Procédez comme suit pour créer l’état Annulé :
1. Entrez Terminé : réussite dans le texte Nouvel élément.
2. Entrez 161 en valeur numérique.
  
  Remarque :
  Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.
Procédez comme suit pour créer l’état Terminé :
1. Saisir Terminé : accord rompu dans le texte du nouvel élément.
2. Entrez 117 en valeur numérique.
  
  Remarque :
  Assurez-vous de fournir les nombres exacts dans le champ Valeur numérique , comme indiqué ici. Les flux de spoke ne sont pas déclenchés en cas de changement de ces nombres.
3. Cliquez sur Ajouter.
4. Cliquez sur Enregistrer.

Résultats

Les états Terminé - Succès et Terminé - Accord rompu sont créés dans la table Tâche d’employé First Advantage [sn_fadv_spoke_first_advantage_employee_task_table].

First Advantage Configurer des webhooks

Recevez des mises à jour d’événements d’invitation et de commande sur votre ServiceNow instance en configurant les webhooks.

Avant de commencer

Rôle requis : admin

Créer une clé d’autorisation pour le spoke First Advantage

Créez une clé d’autorisation pour autoriser les demandes provenant de Jenkins.

Avant de commencer

Rôle requis : admin

Procédure

Accédez à la Tous > Définition du système > Scripts - Arrière-plan.
Entrez cette commande dans le champ de texte Exécuter le script (JavaScript exécuté sur le serveur) :
gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
Cliquez sur Exécuter le script.
Copiez et enregistrez la valeur générée pour une utilisation ultérieure.

Fournir une clé dans votre ServiceNow instance

Configurez le webhook en fournissant une First Advantage clé pour le First Advantage client webhook.

Avant de commencer

Créer une clé d’autorisation pour le spoke First Advantage et enregistrez la valeur.
Rôle requis : admin

Procédure

Accédez à la Tous > First Advantage Spoke > Détails du client Webhook FADV.
Cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique.
Clé d'autorisation	Clé d’autorisation que vous avez générée. Pour plus d'informations, consultez Créer une clé d’autorisation pour le spoke First Advantage.

Cliquez sur Envoyer.

Points de terminaison de l’API d’accès

Accédez au point de terminaison de l’API pour les événements d’invitation et de commande et partagez les détails requis avec pour First Advantage configurer les webhooks.

Avant de commencer

Rôle requis : admin

Procédure

Accédez à la Tous > Services web système > API REST basées sur un script.
Ouvrez l’enregistrement pour le First Advantage Spoke , par exemple, le webhook First Advantage.
Dans l’onglet Ressources :
1. Ouvrez l’enregistrement de l’événement d’invitation, par exemple, État de l’invitation.
2. Copiez et enregistrez le chemin d’accès fourni dans le chemin d’accès de la ressource, par exemple, /api/sn_fadv_spoke/fadv/invite_status.
3. Ouvrez l’enregistrement de l’événement de commande, par exemple, État de la commande.
4. Copiez et enregistrez le chemin d’accès fourni dans le chemin d’accès de la ressource, par exemple, /api/sn_fadv_spoke/fadv/order_status.

Que faire ensuite

Contact First Advantage pour configurer des webhooks pour votre ServiceNow instance. Pour cela, partagez ces détails avec First Advantage:

En-tête personnalisé au format suivant : fadvKey <authorization-key>.
Remarque :
- Assurez-vous que l’en-tête personnalisé est uniquement à ce format. Les flux de spoke ne seront pas déclenchés en cas de changement.
- Fournissez la même clé que celle que vous aviez fournie précédemment dans First Advantage Spoke > Détails du client Webhook FADV.
- Utilisez le même cas que mentionné ici : fadvKey.
Point de terminaison d’API pour les événements d’invitation au format suivant : <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/invite_status
Point de terminaison d’API pour les événements de commande au format suivant : <ServiceNow-instance-URL>/api/sn_fadv_spoke/fadv/order_status

Synchroniser les comptes et les First Advantage packages avec ServiceNow

Stockez les détails des comptes et des First Advantage packages en synchronisant First Advantage les comptes et les packages avec ServiceNow.

Avant de commencer

Rôle requis : administrateur First Advantage

Procédure

Accédez à la Tous > First Advantage Spoke > Comptes.
Cliquez sur Nouveau.

Renseignez les valeurs du formulaire.

Tableau 5. Formulaire de compte
Champ	Description
Compte principal	Option permettant de spécifier que le compte est un compte primaire. Cochez la case.
ID de compte	ID du compte principal.
Nom du compte	Nom du compte principal.

Cliquez sur Envoyer.
Le compte principal est créé et l’enregistrement s’affiche.
Accédez à la First Advantage Spoke > Comptes.
Cliquez sur la liste connexe Obtenir des comptes .
Accédez à la First Advantage Spoke > Packages.
Cliquez sur le lien connexe Obtenir des packages .

Résultats

Les First Advantage détails du compte et du package sont récupérés.

Remarque :

Seuls les utilisateurs ayant le rôle administrateur FADV peuvent synchroniser les détails du compte et du package. Les utilisateurs disposant du rôle d’utilisateur FADV ne peuvent afficher que les détails récupérés.