Installation et configuration du connecteur avec Snowsight

Le connecteur Snowflake pour ServiceNow® est soumis aux conditions de connecteur.

Ce chapitre fournit des informations sur l’installation et la configuration du Snowflake Connector for ServiceNow® via Snowsight.

Dans ce chapitre :

Installation de l”Snowflake Connector for ServiceNow®

La procédure suivante décrit comment installer le connecteur :

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

  2. Dans le menu de navigation, sélectionnez Data Products » Marketplace.

  3. Recherchez le connecteur Snowflake pour ServiceNow®, puis sélectionnez la vignette du 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 saisissez le nom de 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. Une boîte de dialogue apparaît avec la notification : <Nom de votre base de données> is now ready to use in your account. Pour poursuivre la configuration, sélectionnez Manage.

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

Établir la connexion avec ServiceNow

La procédure suivante décrit comment établir une connexion à ServiceNow :

  1. 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.

  2. 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.

  3. 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.

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

  5. 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 :

      Affiche la page du registre d'applications dans ServiceNow à gauche.

    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.

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

    Une boîte de dialogue apparaît, vous demandant de vous connecter à votre instance ServiceNow avec votre nom d’utilisateur et votre mot de passe. Indiquez les identifiants de connexion de l’utilisateur avec lequel vous souhaitez que le connecteur s’authentifie. Il doit disposer des privilèges énumérés dans Préparation de votre instance ServiceNow®.

  7. Une de dialogue apparaît pour vous demander de confirmer que vous souhaitez autoriser le connecteur à se connecter à votre compte ServiceNow. Sélectionnez Allow.

    Note

    Si vous avez été redirigé directement vers cette boîte de dialogue sans avoir à fournir d’identifiants de connexion, c’est que vous êtes déjà connecté à votre instance ServiceNow. Assurez-vous que vous êtes connecté en tant qu’utilisateur du connecteur et que cet utilisateur dispose des privilèges nécessaires. Remarque : l’utilisateur actuellement connecté est indiqué dans le coin supérieur droit de la boîte de dialogue.

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

À la suite de ces étapes, l’assistant crée les objets suivants qui résident en dehors de la base de données du connecteur et qui sont nécessaires au fonctionnement de ce dernier :

  • Base de données CONNECTORS_UI avec le schéma SERVICENOW_GZSTZTP0KHD utilisé pour stocker l’objet secret,

  • Objet secret dans CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD nommé SECRET avec des identifiants de connexion ServiceNow,

  • Intégration de sécurité nommée SERVICENOW_GZSTZTP0KHD_INTEGRATION, qui est utilisée pour effectuer l’intégration entre Snowflake et un service OAuth 2.0 tiers si l’authentification OAuth a été sélectionnée comme méthode d’autorisation,

  • L’intégration API SERVICENOW_GZSTZTP0KHD_API est utilisée pour la communication avec ServiceNow.

Les noms de ces objets ne doivent pas être modifiés. Le connecteur les référence par leur nom. Le fait de modifier leur nom ou de les supprimer casse les références et le connecteur.

Configuration du Snowflake Connector for ServiceNow®

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

  2. Dans le menu de navigation, sélectionnez Data Products » Marketplace.

  3. Recherchez le Snowflake Connector for 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 Snowflake Connector for 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é.

    Bien qu’il soit recommandé de créer des rôles distincts et plus affinés pour accéder aux données ingérées après le début de l’ingestion, vous pouvez utiliser ce rôle pour interroger les données ingérées et vous pouvez l’étendre avec des privilèges supplémentaires. Inversement, la révocation des privilèges des rôles pour les objets requis par le connecteur ou la modification de la propriété des rôles sur les tables et les vues contenant des données ingérées n’est pas autorisée et entraînera l’interruption du connecteur.

    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.

Le connecteur référence l’entrepôt, la base de données de destination, le schéma de destination et le rôle par leur nom. La modification des noms de ces objets ou leur suppression entraînera la rupture des références et, par conséquent, la rupture du connecteur. Au lieu de renommer l’entrepôt, utilisez la procédure stockée CONFIGURE_WAREHOUSE pour modifier l’entrepôt utilisé par le connecteur.

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.

Prochaines étapes

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®.

Langage: Français