Prérequis
Une instance ServiceNow fonctionnelle est requise, avec les éléments suivants :- URL de l’instance
- Identifiants
- nom d’utilisateur
- mot de passe
- ID client
- secret client
Guide de Configuration
Le connecteur ServiceNow supporte l’authentification de base (non recommandée en production) et l’authentification OAuth. Le nom d’utilisateur et le mot de passe sont donnés lors de la création de l’instance, et ils permettent seulement l’authentification de base. Pour configurer et activer l’authentification OAuth, un ID client et un secret client sont nécessaires.Générer les Identifiants pour OAuth dans ServiceNow
- Dans l’instance ServiceNow, naviguez vers System OAuth > Application Registry
- Créez une nouvelle entrée en sélectionnant “Create an OAuth API endpoint for external clients”
- Nommez-la et sauvegardez-la
- Cliquez sur l’application OAuth nouvellement créée pour récupérer l’ID client et le secret client
Créer une Nouvelle Source de Données dans l’Admin Paradigm
- Naviguez vers la section DATASOURCES dans votre interface d’administration Paradigm
- Créez une nouvelle Source de Données avec Type de source de données = ServiceNow
- Sélectionnez l’Entreprise à laquelle vous souhaitez associer la Source de Données
-
Remplissez le champ URL de l’instance (ex.
https://dev280517.service-now.com
) -
Ajoutez vos identifiants :
- nom d’utilisateur : votre nom d’utilisateur de tenant ServiceNow
- mot de passe : votre mot de passe de tenant ServiceNow
- id client : votre ID client d’application OAuth (recommandé)
- secret client : votre secret client d’application OAuth (recommandé)
- Sauvegardez la Source de Données
- Désormais, vous pouvez cliquer sur le bouton “Test connection” en haut à droite de la page de détail de la Source de Données pour vérifier si ServiceNow est accessible
- En cas d’échec du contrôle de santé, veuillez réviser vos identifiants. Si le problème persiste, n’hésitez pas à contacter l’équipe de développement
Créer une Nouvelle Configuration d’Import
- Sur la Source de Données nouvellement créée, vous pouvez ajouter un nouvel Import dans la section “IMPORTS”
- Ajoutez un nouveau filtre dans le champ Critères de filtre, en complétant les entrées clé/valeur. Par exemple, pour récupérer des articles de connaissance, remplissez doc_type comme clé et knowledge comme valeur
💡 Au moins un filtre est requis → doc_type Il est nécessaire d’identifier quel type d’enregistrements doit être synchronisé dans cet import
- D’autres filtres peuvent être sélectionnés pour l’import, pour affiner la sélection des documents
- Sélectionnez l’Espace de Travail où les documents seront synchronisés dans votre application Paradigm
- Sélectionnez la fréquence de synchronisation entre votre instance ServiceNow et Paradigm
- Ajustez la priorité d’import si nécessaire, relativement aux autres imports
- Sauvegardez la Source de Données
- Désormais, vous pouvez cliquer sur le bouton “Trigger import” à droite de l’Import nouvellement créé, sur la page de détail de la Source de Données, pour lancer une première synchronisation !
- Les synchronisations suivantes se poursuivront, en respectant la fréquence
Méthodes d’Authentification
Authentification de Base
- Utilise directement le nom d’utilisateur et le mot de passe
- Non recommandée pour les environnements de production
- Plus simple à configurer mais moins sécurisée
Authentification OAuth (Recommandée)
- Utilise l’ID client et le secret client
- Plus sécurisée pour les environnements de production
- Nécessite une configuration supplémentaire dans ServiceNow mais offre une meilleure sécurité
Dépannage
Problèmes de Connexion
- Vérifiez que votre URL d’instance ServiceNow est correcte et accessible
- Vérifiez que vos identifiants sont valides et ont les permissions appropriées
- Assurez-vous que l’instance ServiceNow fonctionne et est accessible depuis Paradigm
Problèmes d’Import
- Vérifiez que le filtre doc_type est correctement configuré
- Vérifiez que l’espace de travail sélectionné existe et est accessible
- Révisez les journaux d’import pour des messages d’erreur spécifiques