View a markdown version of this page

ServiceNow connecteur V1.0 - Amazon Kendra
Fonctionnalités prises en chargeConditions préalablesInstructions de connexionEn savoir plus

Amazon Kendra n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires à Amazon Kendra, explorez les bases de connaissances Amazon Bedrock. En savoir plus.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ServiceNow connecteur V1.0

ServiceNow fournit un système de gestion des services basé sur le cloud pour créer et gérer des flux de travail au niveau de l'organisation, tels que les services informatiques, les systèmes de billetterie et le support. Vous pouvez l'utiliser Amazon Kendra pour indexer vos ServiceNow catalogues, vos articles de connaissances et leurs pièces jointes.

Note

ServiceNow connecteur V1.0 / ServiceNowConfiguration API a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser un ServiceNow V2.0 TemplateConfiguration connecteur/API.

Pour résoudre les problèmes liés à votre connecteur de source de Amazon Kendra ServiceNow données, consultezDépannage des sources de données.

Fonctionnalités prises en charge

Amazon Kendra ServiceNow le connecteur de source de données prend en charge les fonctionnalités suivantes :

  • ServiceNow versions d'instance : Londres, Autres

  • Inclusion/exclusion modèles : catalogues de services, articles de connaissances et leurs pièces jointes

Conditions préalables

Avant de pouvoir l'utiliser Amazon Kendra pour indexer votre source de ServiceNow données, apportez ces modifications à vos AWS comptes ServiceNow et.

Dans ServiceNow, assurez-vous d'avoir :

  • J'ai créé un compte ServiceNow administrateur et créé une ServiceNow instance.

  • J'ai copié l'URL de l'hôte de votre ServiceNow instance. Par exemple, si l'URL de l'instance esthttps://your-domain.service-now.com, le format de l'URL de l'hôte que vous entrez estyour-domain.service-now.com.

  • Vous avez pris note de vos informations d'authentification de base contenant un nom d'utilisateur et un mot de passe Amazon Kendra pour vous permettre de vous connecter à votre ServiceNow instance.

    Note

    Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).

  • Facultatif : configuration d'un jeton d'identification OAuth 2.0 qui peut identifier Amazon Kendra et générer un nom d'utilisateur, un mot de passe, un ID client et un secret client. Le nom d'utilisateur et le mot de passe doivent permettre d'accéder à la base de ServiceNow connaissances et au catalogue de services. Consultez ServiceNow la documentation sur l'authentification OAuth 2.0 pour plus d'informations.

  • Les autorisations suivantes ont été ajoutées :

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • catégorie_sc

    • sc_cat_item

    • sys_attachment

    • sys_attachment_doc

    • rôle_utilisateur_sys

  • Coché : chaque document est unique dans ServiceNow et entre les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. Les ID de document sont globaux pour un index et doivent être uniques par index.

Dans votre Compte AWS, assurez-vous d'avoir :

  • A créé un Amazon Kendra index et, si vous utilisez l'API, en avez noté l'ID.

  • Vous avez créé un IAM rôle pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.

    Note

    Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder à l'ID AWS Secrets Manager secret correct.

  • Vous avez enregistré vos informations d' ServiceNow authentification dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.

    Note

    Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).

Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de ServiceNow données à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un ID d'index.

Instructions de connexion

Pour vous connecter Amazon Kendra à votre source de ServiceNow données, vous devez fournir les informations nécessaires sur votre source de ServiceNow données afin que celle-ci Amazon Kendra puisse accéder à vos données. Si vous n'avez pas encore configuré ServiceNow pour Amazon Kendra voirConditions préalables.

Console

Pour vous connecter Amazon Kendra à ServiceNow

  1. Connectez-vous à la console AWS de gestion et ouvrez la Amazon Kendra console.

  2. Dans le volet de navigation de gauche, choisissez Index, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.

    Note

    Vous pouvez choisir de configurer ou de modifier vos paramètres de contrôle d'accès utilisateur dans Paramètres d'index.

  3. Sur la page Démarrage, choisissez Ajouter une source de données.

  4. Sur la page Ajouter une source de données, choisissez ServiceNow connecteur V1.0, puis choisissez Ajouter une source de données.

  5. Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :

    1. Dans Nom et description, pour Nom de la source de données —Entrez un nom pour votre source de données. Vous pouvez inclure des traits d'union mais pas des espaces.

    2. (Facultatif) Description —Entrez une description facultative pour votre source de données.

    3. Dans la langue par défaut  : choisissez une langue pour filtrer vos documents en vue de l'index. Sauf indication contraire de votre part, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.

    4. Dans Tags, pour Ajouter une nouvelle étiquette  : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.

    5. Choisissez Suivant.

  6. Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :

    1. ServiceNow host —Entrez l'URL de l' ServiceNowhôte.

    2. ServiceNow version  : sélectionnez votre ServiceNow version.

    3. Choisissez entre l'authentification de base et l'authentification Oauth 2.0 en fonction de votre cas d'utilisation.

    4. AWS Secrets Manager secret —Choisissez un secret existant ou créez-en un nouveau Secrets Manager pour stocker vos informations ServiceNow d'authentification. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.

      1. Nom du secret : nom de votre secret. Le préfixe « AmazonKendra-ServiceNow - » est automatiquement ajouté à votre nom secret.

      2. Si vous utilisez l'authentification de base, entrez le nom secret, le nom d'utilisateur et le mot de passe de votre compte. ServiceNow

        Si vous utilisez l'authentification OAuth2 : entrez le nom secret, le nom d'utilisateur, le mot de passe , l'ID client et le secret client que vous avez créés dans votre compte. ServiceNow

      3. Choisissez Enregistrer et ajouter un secret.

    5. IAM rôle  : choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.

      Note

      IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez Créer un nouveau rôle pour éviter les erreurs.

    6. Choisissez Suivant.

  7. Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :

    1. Inclure des articles de connaissances  : choisissez d'indexer les articles de connaissances.

    2. Type d'articles de connaissance  : choisissez entre Inclure uniquement les articles publics et Inclure les articles en fonction d'une requête de ServiceNow filtre basée sur votre cas d'utilisation. Si vous sélectionnez Inclure les articles en fonction d'une requête de ServiceNow filtre, vous devez saisir une requête de filtre copiée depuis votre ServiceNow compte.

    3. Inclure les pièces jointes aux articles de connaissances  : choisissez d'indexer les pièces jointes aux articles de connaissances. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.

    4. Inclure les éléments du catalogue  : choisissez d'indexer les éléments du catalogue.

    5. Inclure les pièces jointes des éléments du catalogue  : choisissez d'indexer les pièces jointes des éléments du catalogue. Vous pouvez également sélectionner des types de fichiers spécifiques à indexer.

    6. Fréquence  : fréquence Amazon Kendra de synchronisation avec votre source de données.

    7. Choisissez Suivant.

  8. Sur la page Définir les mappages de champs, entrez les informations suivantes :

    1. Articles de connaissances et catalogue de services  : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés et les mappages de champs suggérés supplémentaires que vous souhaitez mapper à votre index.

    2. Ajouter un champ —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.

    3. Choisissez Suivant.

  9. Sur la page Réviser et créer, vérifiez que les informations que vous avez saisies sont correctes, puis sélectionnez Ajouter une source de données. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page Sources de données une fois que la source de données aura été ajoutée avec succès.

API

Pour vous connecter Amazon Kendra à ServiceNow

Vous devez spécifier les éléments suivants à l'aide de l'ServiceNowConfiguration API  :

  • URL de la source de données  : spécifiez l' ServiceNow URL. Le point de terminaison hôte doit ressembler à ce qui suit :your-domain.service-now.com.

  • Instance hôte de la source de données  : spécifiez la version de l'instance ServiceNow hôte comme suit : LONDON ouOTHERS.

  • Nom de ressource Amazon secret (ARN)  : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification que vous avez créées dans votre ServiceNow compte.

    Si vous utilisez l'authentification de base, le secret est stocké dans une structure JSON avec les clés suivantes :

    {
    "username": "user name",
    "password": "password"
}

    Si vous utilisez l'authentification OAuth2, le secret est stocké dans une structure JSON avec les clés suivantes :

    {
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}

  • IAM role  : spécifiez RoleArn quand vous appelez CreateDataSource pour fournir un IAM rôle autorisé à accéder à votre Secrets Manager secret et à appeler les API publiques requises pour le ServiceNow connecteur et Amazon Kendra. Pour plus d'informations, consultez la section IAM Rôles pour les sources de ServiceNow données.

Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :

  • Mappages de champs  : choisissez de mapper vos champs de source de ServiceNow données à vos champs d' Amazon Kendra index. Pour plus d’informations, consultez Mappage des champs de source de données.

    Note

    Le champ du corps du document ou l'équivalent du corps du document pour vos documents est obligatoire pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps de votre document dans votre source de données au nom du champ d'index_document_body. Tous les autres champs sont facultatifs.

  • Filtres d'inclusion et d'exclusion  : spécifiez si vous souhaitez inclure ou exclure certaines pièces jointes de catalogues et d'articles de connaissances.

    Note

    La plupart des sources de données utilisent des modèles d’expressions régulières, qui sont des modèles d’inclusion ou d’exclusion appelés filtres. Si vous spécifiez un filtre d’inclusion, seul le contenu correspondant au filtre d’inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents qui correspondent au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.

  • Paramètres d'indexation  : vous pouvez également choisir de spécifier si vous souhaitez :

    • Indexez les articles de connaissances et les catalogues de services, ou les deux. Si vous choisissez d'indexer les articles de connaissances et les éléments du catalogue de services, vous devez fournir le nom du ServiceNow champ qui est mappé au champ de contenu du document d'index dans l' Amazon Kendra index.

    • Indexez les pièces jointes aux articles de connaissances et aux éléments du catalogue.

    • Utilisez une ServiceNow requête qui sélectionne des documents dans une ou plusieurs bases de connaissances. Les bases de connaissances peuvent être publiques ou privées. Pour plus d'informations, veuillez consulter la rubrique Spécification des documents à indexer avec une requête.

En savoir plus

Pour en savoir plus sur l'intégration Amazon Kendra à votre source de ServiceNow données, consultez :