Configurer une instance ServiceNow pour la CDC

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez utiliser Datastream pour répliquer des données d'une instance ServiceNow vers une destination compatible, telle que BigQuery ou Cloud Storage. Avant de créer un profil de connexion, vous devez configurer un utilisateur d'intégration dédié, configurer l'authentification de base ou OAuth 2.0, et ajouter les adresses IP Datastream à la liste d'autorisation si nécessaire.

Avant de commencer

Avant de commencer à configurer ServiceNow pour l'utiliser avec Datastream, assurez-vous de disposer des éléments suivants :

• Une instance ServiceNow active, par exemple company.service-now.com.
• Droits d'administrateur sur l'instance ServiceNow pour créer des utilisateurs, attribuer des rôles et gérer le registre d'applications OAuth.
• Connaissance de la version de votre instance ServiceNow.

Configurer un utilisateur d'intégration

Dans ServiceNow, vous pouvez créer un nouvel utilisateur ou ajuster les paramètres d'un compte existant pour autoriser l'accès à Datastream. Pour des raisons de sécurité et d'audit, nous vous recommandons vivement de créer un utilisateur d'intégration dédié.

1. Dans ServiceNow, accédez à User Administration > Users (Administration des utilisateurs > Utilisateurs).
2. Pour créer un nouvel utilisateur, cliquez sur New (Nouveau). Pour modifier un utilisateur existant, recherchez son ID utilisateur dans la liste des utilisateurs, puis cliquez dessus pour ouvrir l'enregistrement.

3. Configurez les détails de l'utilisateur :

   • Saisissez un nom unique dans le champ ID utilisateur, par exemple datastream_integration. Vous ne définissez l'identifiant utilisateur que pour les nouveaux utilisateurs.
   • Si vous sélectionnez l'authentification OAuth pour le connecteur, nous vous recommandons de saisir des valeurs dans les champs Prénom et Nom pour mieux identifier l'enregistrement utilisateur.

   • Configuration de l'identité : en fonction de la version de votre plate-forme ServiceNow :

     • Xanadu et versions ultérieures : sélectionnez Machine dans le menu déroulant Identity type (Type d'identité). Cela active automatiquement l'option Web service access only (Accès au service Web uniquement).
     • Avant Xanadu : cochez la case Web service access only (Accès au service Web uniquement).

4. Enregistrez l'enregistrement :

   • Pour les nouveaux utilisateurs, cliquez sur Envoyer.
   • Pour les utilisateurs existants, cliquez sur Mettre à jour.

5. Si vous avez créé un nouvel utilisateur, rouvrez l'enregistrement. Recherchez l'utilisateur dans la liste, puis cliquez sur son ID utilisateur pour accéder aux options d'enregistrement.

6. Définir le mot de passe :

   1. Cliquez sur Définir un mot de passe dans l'en-tête du formulaire.
   2. Saisissez un mot de passe sécurisé, puis cliquez sur Enregistrer le mot de passe.
   3. Si vous utilisez l'authentification de base pour le connecteur, notez le mot de passe, car il est requis lors de la configuration du profil de connexion.

7. Attribuez des autorisations. Vous devez accorder à l'utilisateur d'intégration un accès en lecture à toutes les tables que vous souhaitez répliquer. De plus, le connecteur nécessite des autorisations de lecture explicites pour les tables de métadonnées système sys_db_object, sys_table_rotation et sys_dictionary.

En raison de la nature précise des rôles ServiceNow et du système de liste de contrôle d'accès (LCA), la configuration spécifique requise pour accorder ces autorisations est propre au client.

• Nous vous recommandons vivement d'attribuer le rôle snc_read_only à votre utilisateur, car cela garantit que la session utilisateur est strictement limitée à un accès en lecture seule sur l'ensemble de la plate-forme.
• Le rôle admin accorde un accès complet à toutes les tables de l'instance. Si vos règles de sécurité le permettent, l'attribution du rôle admin est la méthode la plus simple pour garantir un accès complet au connecteur.

Facultatif : Configurer les identifiants client OAuth 2.0

OAuth 2.0 est la méthode d'authentification la plus sécurisée et recommandée pour utiliser le connecteur ServiceNow avec Datastream. Il utilise un ID client et un code secret du client au lieu d'un mot de passe permanent.

1. Activez le plug-in OAuth 2.0 pour votre instance. Pour en savoir plus, consultez la documentation ServiceNow.
2. Assurez-vous que la propriété système com.snc.platform.security.oauth.is.active est définie sur true. Pour en savoir plus, consultez la documentation ServiceNow.
3. Assurez-vous que la propriété système glide.oauth.inbound.client.credential.grant_type.enabled est définie sur true. Pour en savoir plus, consultez la documentation ServiceNow.

4. Configurez la configuration OAuth entrante. En fonction des exigences de sécurité de votre instance, vous pouvez sélectionner l'un des champs d'application de configuration OAuth suivants :

   • Champ d'application étendu : lorsque vous utilisez OAuth avec un champ d'application étendu, le porteur du jeton hérite des rôles utilisateur et des listes de contrôle des accès (LCA) associés.
   • Authentification de l'API REST précise : ce type de configuration OAuth limite l'accès à des API REST et des méthodes spécifiques autorisées par le champ d'application, en plus des rôles utilisateur et des LCA associés.

5. Créez l'enregistrement d'intégration OAuth. Pour en savoir plus, consultez la documentation ServiceNow :

   • Pour la version de la plate-forme Zurich et les versions ultérieures
   • Pour les versions de la plate-forme antérieures à Zurich

6. Une fois l'enregistrement d'intégration OAuth créé, la configuration dépend de la version de la plate-forme et du champ d'application OAuth :

   • Configuration à champ d'application étendu :

     • Zurich et versions ultérieures : dans la section Champ d'application de l'authentification de votre enregistrement d'intégration, assurez-vous qu'il n'y a aucune entrée dans les champs Champ d'application de l'authentification ou Limiter l'autorisation aux API suivantes, et que la case Autoriser l'accès uniquement aux API du champ d'application sélectionné n'est pas cochée.
     • Avant Zurich : dans le menu déroulant Restriction du champ d'application, sélectionnez Champ d'application étendu et laissez la liste Champs d'application d'authentification vide.

   • Configuration de l'authentification de l'API REST à l'aide de champs d'application précis : vous pouvez éventuellement utiliser des champs d'application d'authentification pour limiter davantage le porteur du jeton à des API REST et des méthodes spécifiques autorisées par le champ d'application. Le connecteur Datastream ne nécessite qu'un accès GET à l'API Table. Selon la version de la plate-forme, procédez comme suit :

     • Zurich et versions ultérieures : dans la section Champ d'application de l'authentification de votre enregistrement d'intégration, sélectionnez un champ d'application d'autorisation et limitez son accès à l'API Table.

       Remarque : Si vous créez le champ d'application d'autorisation lors de la modification de votre enregistrement d'intégration, le champ d'application a accès à toutes les méthodes de l'API Table par défaut. Pour limiter davantage l'accès à la méthode GET uniquement, vous devez modifier manuellement l'enregistrement que vous venez de créer en accédant à Services Web du système > Niveaux d'accès à l'API > Niveau d'accès à l'API REST.

     • Avant Zurich :

       1. Limitez l'accès à l'API Table pour le niveau d'accès sélectionné. Pour en savoir plus, consultez la documentation ServiceNow.
       2. Ajoutez le champ d'application sous la section Champs d'application d'authentification.
       3. Sélectionnez Champ d'application sécurisé dans le champ Restriction du champ d'application.

Facultatif : Configurer le contrôle des accès par adresse IP

Si votre instance ServiceNow utilise le contrôle des accès par adresse IP, vous devez explicitement ajouter les adresses IP Datastream à la liste d'autorisation.

Les étapes suivantes ne sont requises que si vous disposez d'une règle de contrôle des accès par adresse IP DENY qui couvre les adresses IP Datastream. Par défaut, aucune restriction d'adresse IP n'est appliquée à l'accès à l'instance.

1. Dans ServiceNow, accédez à System Security > IP Address Access Control (Sécurité système > Contrôle des accès par adresse IP).
2. Cliquez sur New (Nouveau).
3. Dans le formulaire de création d'enregistrement, appliquez les paramètres suivants :
   1. Dans le menu déroulant Type, sélectionnez Autoriser.
   2. Dans le menu déroulant Direction, sélectionnez Entrant.
   3. Dans les champs Début de la plage et Fin de la plage, saisissez l'adresse IP ou la plage d'adresses spécifique de la liste des adresses IP Datastream.
   4. Assurez-vous que la case Active (Actif) est cochée.
4. Cliquez sur Envoyer.
5. Répétez les étapes précédentes pour chaque adresse IP de la liste des adresses Datastream.

Étapes suivantes

• En savoir plus sur la source ServiceNow