Installation et configuration du connecteur avec Snowsight¶

Installation du connecteur Snowflake pour ServiceNow¶

Les procédures suivantes décrivent comment installer le connecteur et établir une connexion avec ServiceNow :

1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

2. Dans la navigation de gauche, sélectionnez Marketplace.

3. Recherchez le connecteur Snowflake pour ServiceNow, puis sélectionnez la vignette pour le connecteur.

4. Dans la page Snowflake Connector for ServiceNow, sélectionnez Get.

   Une boîte de dialogue s’affiche pour lancer la partie initiale du processus d’installation.

   Dans la boîte de dialogue, configurez les éléments suivants :

   1. Dans le champ Database name sélectionnez la base de données à utiliser comme base de données pour l’instance de connecteur. Cette base de données est créée automatiquement pour vous.

   2. Dans le champ Warehouse used for installation sélectionnez l’entrepôt que vous souhaitez utiliser pour installer le connecteur.

      Note

      Il ne s’agit pas du même entrepôt que celui utilisé par le connecteur pour synchroniser les données depuis ServiceNow. Dans une étape ultérieure, vous créerez un entrepôt distinct à cette fin.

   3. Dans le champ Which roles, in addition to ACCOUNTADMIN, can access this database? ajoutez les autres rôles que vous souhaitez voir accéder à la base de données.

   4. Sélectionnez Get.

5. Sélectionnez Manage.

   La boîte de dialogue se ferme et la page Snowflake Connector for ServiceNow affiche les UI de configuration et de gestion du connecteur.

6. Dans la section Connections sélectionnez Connect pour configurer les paramètres de connexion à l’instance ServiceNow.

   La boîte de dialogue Connect to ServiceNow s’affiche.

7. Dans le champ ServiceNow Instance saisissez le nom de l’instance ServiceNow.

   Il s’agit de la première partie du nom d’hôte de votre instance ServiceNow. Par exemple, si l’URL de votre instance ServiceNow est :

   https://myinstance.service-now.com
   

   Copy

   Le nom de votre instance serait myinstance.

8. Dans le champ Authentication Method sélectionnez la méthode d’authentification que vous souhaitez utiliser pour permettre au connecteur de se connecter à l’instance ServiceNow.

   Vous pouvez sélectionner l’authentification de base (nom d’utilisateur et mot de passe) ou OAuth.

9. Si vous avez sélectionné Basic authentication, saisissez les identifiants de connexion de votre compte ServiceNow dans les champs ServiceNow username et ServiceNow password.

10. Si vous avez sélectionné OAuth, créez un registre d’application dans ServiceNow et utilisez-le pour configurer le connecteur.

    Pour créer le registre d’application, procédez comme suit :

    1. Connectez-vous à votre instance ServiceNow, puis sélectionnez Homepage.

    2. Recherchez OAuth, puis sélectionnez Application Registry.

    3. Sélectionnez New, puis sélectionnez Create an OAuth API endpoint for external clients.

       Une page de configuration du registre d’applications s’affiche, comme le montre l’image suivante :

       

    4. Dans ServiceNow, entrez un nom pour le registre d’applications OAuth dans le champ Name.

    5. Dans l’UI du connecteur, copiez la valeur dans le champ Redirect URL.

       Cette valeur a été générée par le connecteur.

    6. Dans ServiceNow, collez cette valeur dans le champ Redirect URL.

    7. Si nécessaire, dans ServiceNow, mettez à jour les valeurs des champs Refresh Token Lifespan et Access Token Lifespan.

       • Snowflake recommande de fixer la durée de vie du jeton d’accès à au moins 600 secondes.

       • Pour la durée de vie du jeton d’actualisation, indiquez une valeur de 7776000 (90 jours).

    8. Dans ServiceNow, sélectionnez Submit.

       Le registre d’applications OAuth apparaît dans la liste des registres d’applications.

    9. Dans ServiceNow, sélectionnez le registre d’applications que vous venez de créer.

       Notez que ServiceNow a créé des valeurs pour les champs Client ID et Client Secret.

    10. Dans ServiceNow, copiez la valeur de Client ID.

    11. Collez cette valeur dans le champ Client ID de l’UI du connecteur.

    12. Dans ServiceNow, copiez la valeur de Client Secret.

    13. Collez cette valeur dans le champ Client Secret de l’UI du connecteur.

        Le connecteur utilise un secret (un type d’objet de niveau schéma) pour stocker les jetons d’accès utilisés pour s’authentifier auprès de l’instance ServiceNow. Le connecteur utilise cet objet secret avec une intégration de sécurité et une intégration API pour se connecter à l’instance ServiceNow.

        Le secret, l’intégration de sécurité et l’intégration API sont créés automatiquement lors de l’installation du connecteur.

    14. Pour spécifier la configuration de l’objet secret, de l’intégration de sécurité et de l’intégration API, sélectionnez Advanced Settings, et remplissez les champs suivants :

        Champ	Description
        Secret Name	Nom du secret. Le connecteur génère cette valeur. Vous ne pouvez pas modifier cette valeur.
        Authorization URL	URL pour s’authentifier auprès de l’instance ServiceNow. Cette URL doit avoir le format suivant : https://<instance_name>.service-now.com/oauth_token.do Copy Où instance_name est le nom de votre instance ServiceNow.
        Token URL	URL pour demander un jeton d’actualisation pour l’instance ServiceNow. Cette URL doit avoir le format suivant : https://<instance_name>.service-now.com/oauth_token.do Copy Où instance_name est le nom de votre instance ServiceNow.
        Allowed Prefix	URL de votre instance ServiceNow. Cela limite l’utilisation de ces paramètres de connexion. Les paramètres ne peuvent être utilisés que pour se connecter à des URLs avec les préfixes spécifiés.

11. Dans l’UI du connecteur, sélectionnez Connect.

    Une boîte de dialogue apparaît pour vous demander de confirmer que vous souhaitez autoriser le connecteur à se connecter à votre compte ServiceNow.

    Note

    Assurez-vous d’être connecté à ServiceNow avec le même utilisateur que celui que vous voulez que le connecteur utilise. Vous pouvez vérifier l’utilisateur actuellement connecté dans le coin supérieur droit de la boîte de dialogue.

12. Sélectionnez Allow.

    La nouvelle connexion ServiceNow apparaît dans la zone Connection.

Configuration du connecteur Snowflake pour ServiceNow¶

1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

2. Dans la navigation de gauche, sélectionnez Marketplace.

3. Recherchez le connecteur Snowflake pour ServiceNow, puis sélectionnez-le.

4. Sous le statut du connecteur, sélectionnez Configure.

   La boîte de dialogue Configure Connector s’affiche.

   Note

   Par défaut, les champs sont définis sur les noms des objets créés lors de la configuration du connecteur. Snowflake recommande d’utiliser de nouveaux objets pour ces champs. Cependant, vous pouvez spécifier les noms des objets existants, si nécessaire (par exemple, si vous réinstallez le connecteur).

   Dans cette boîte de dialogue, remplissez les champs suivants :

   Champ	Description
   Warehouse	Identificateur d’un nouvel entrepôt virtuel dédié au connecteur. Indiquez un nom unique pour votre compte. Le nom de l’entrepôt doit être un identificateur d’objet valide. Note Ne spécifiez pas le même entrepôt que celui que vous avez sélectionné au début de l’installation du connecteur. Le processus de configuration crée un nouvel entrepôt Large avec le nom spécifié.
   Destination Database	Identificateur d’une nouvelle base de données qui contiendra le schéma avec les tables pour les données ServiceNow dans Snowflake. Indiquez un nom unique pour votre compte. Le nom de la base de données doit être un identificateur d’objet valide. Le processus de configuration crée une nouvelle base de données avec le nom spécifié.
   Destination Schema	Identificateur d’un nouveau schéma qui contiendra les données ServiceNow dans Snowflake. Le connecteur Snowflake pour ServiceNow ingère les données ServiceNow dans les tables de ce schéma. Indiquez un nom unique pour votre compte. Le nom du schéma doit être un identificateur d’objet valide. Le processus de configuration crée un nouveau schéma avec le nom spécifié.
   Role	Identificateur d’un nouveau rôle personnalisé pour le connecteur. Ce rôle permet au connecteur d’effectuer les opérations suivantes : Créer et gérer des tâches pour l’ingestion des données. Utiliser l’entrepôt dédié. Accéder au secret et à l’intégration d’API pour vous connecter à l’instance ServiceNow. Le rôle est également le propriétaire des tables et des vues contenant les données ServiceNow ingérées par le connecteur. Indiquez un nom unique pour votre compte. Le nom du rôle doit être un identificateur d’objet valide. Le processus de configuration crée un nouveau rôle avec le nom spécifié.
   Journal table	(Facultatif) Pour activer la propagation des enregistrements supprimés, définissez ce paramètre sur la table qui sert de source d’informations sur les enregistrements supprimés. Vous pouvez utiliser la table sys_audit_delete ou une table de journal personnalisée comme source d’informations sur les enregistrements supprimés. Si vous ne souhaitez pas ingérer les enregistrements supprimés de ServiceNow dans Snowflake, laissez ce champ vide. Note Assurez-vous que l’utilisateur ServiceNow du connecteur a accès à la table de journal spécifiée.

5. Sélectionnez Configure.

La boîte de dialogue se ferme et le statut du connecteur devient Provisioning. Le processus de configuration peut prendre quelques minutes.

La section Connector Objects affiche les objets qui ont été créés automatiquement lors de l’installation et de la configuration. Le connecteur utilise ces objets pour ingérer les données de l’instance ServiceNow. Pour afficher les détails d’un objet, sélectionnez-le.

Si le processus de configuration se termine avec succès, le statut affiché devient Inactive.

Dépannage des erreurs de configuration¶

Si une erreur survient au cours du processus de configuration, le statut du connecteur devient Incomplete. Pour identifier et corriger les erreurs :

1. Sélectionnez Retry Setup pour afficher à nouveau la boîte de dialogue de configuration.

2. Vérifiez s’il y a des messages d’erreur dans l’un ou l’autre des champs.

3. Corrigez les problèmes dans les champs et sélectionnez Configure pour recommencer le processus de configuration.

Configuration de l’ingestion de données¶

Après avoir installé et configuré le connecteur, effectuez les étapes décrites dans Configuration de l’ingestion de données pour vos données ServiceNow.