View a markdown version of this page

ServiceNow Konnektor V1.0 - Amazon Kendra
Unterstützte FeaturesVoraussetzungenAnweisungen zur VerbindungWeitere Informationen

Amazon Kendra ist nicht mehr offen für neue Kunden. In den Amazon Bedrock Knowledge Bases finden Sie ähnliche Funktionen wie. Amazon KendraWeitere Informationen.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

ServiceNow Konnektor V1.0

ServiceNow bietet ein cloudbasiertes Servicemanagementsystem zur Erstellung und Verwaltung von Workflows auf Unternehmensebene, z. B. für IT-Services, Ticketsysteme und Support. Sie können Amazon Kendra es verwenden, um Ihre ServiceNow Kataloge, Wissensartikel und deren Anlagen zu indizieren.

Anmerkung

ServiceNow Connector V1.0 / ServiceNowConfiguration API endete 2023. Wir empfehlen, zu ServiceNow Connector V2.0 / TemplateConfiguration API zu migrieren oder ihn zu verwenden.

Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra ServiceNow Datenquellen-Connector finden Sie unterProblembehandlung bei Datenquellen.

Unterstützte Features

Amazon Kendra ServiceNow Der Datenquellen-Connector unterstützt die folgenden Funktionen:

  • ServiceNow Instanzversionen: London, Andere

  • Inclusion/exclusion Muster: Servicekataloge, Wissensartikel und ihre Anlagen

Voraussetzungen

Bevor Sie Ihre ServiceNow Datenquelle Amazon Kendra zur Indizierung verwenden können, nehmen Sie diese Änderungen in Ihren AWS Konten ServiceNow und vor.

Stellen Sie sicher ServiceNow, dass Sie Folgendes haben:

  • Sie haben ein ServiceNow Administratorkonto erstellt und eine ServiceNow Instanz erstellt.

  • Der Host Ihrer ServiceNow Instanz-URL wurde kopiert. Wenn die URL der Instanz beispielsweise lautethttps://your-domain.service-now.com, lautet das Format für die Host-URL, die Sie eingebenyour-domain.service-now.com.

  • Haben Sie Ihre grundlegenden Authentifizierungsdaten notiert, die einen Benutzernamen und ein Passwort enthalten, Amazon Kendra um eine Verbindung zu Ihrer ServiceNow Instance herzustellen.

    Anmerkung

    Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen nicht, Anmeldeinformationen und Geheimnisse für alle Datenquellen und die Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

  • Optional: Es wurde ein OAuth 2.0-Anmeldeinformationstoken konfiguriert, das einen Benutzernamen, ein Passwort, eine Client-ID Amazon Kendra und ein Client-Geheimnis identifizieren und generieren kann. Der Benutzername und das Passwort müssen den Zugriff auf die ServiceNow Wissensdatenbank und den Servicekatalog ermöglichen. Weitere Informationen finden Sie in der ServiceNow Dokumentation zur OAuth 2.0-Authentifizierung.

  • Die folgenden Berechtigungen wurden hinzugefügt:

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_kann_mtom lesen_

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_anhang_doc

    • sys_user_role

  • Aktiviert, jedes Dokument ist in ServiceNow und zwischen anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht in allen Datenquellen dasselbe Dokument enthalten. Dokument-IDs gelten global für einen Index und müssen pro Index eindeutig sein.

Stellen Sie in Ihrem sicher AWS-Konto, dass Sie:

  • Hat einen Amazon Kendra Index erstellt und bei Verwendung der API die Index-ID notiert.

  • Hat eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die API verwenden, den ARN der IAM Rolle notiert.

    Anmerkung

    Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zuzugreifen.

  • Ihre Anmeldeinformationen für die ServiceNow Authentifizierung wurden in einem AWS Secrets Manager Geheimnis gespeichert und, falls Sie die API verwenden, die ARN des Geheimnisses notiert.

    Anmerkung

    Wir empfehlen, die Anmeldeinformationen und Secrets regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die unbedingt erforderliche Zugriffsebene bereit. Wir empfehlen nicht, Anmeldeinformationen und Geheimnisse für alle Datenquellen und die Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

Wenn Sie noch keine IAM Rolle oder kein Geheimnis haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre ServiceNow Datenquelle mit verbinden. Amazon Kendra Wenn Sie die API verwenden, müssen Sie den ARN einer vorhandenen IAM Rolle und eines vorhandenen Secrets Manager Geheimnisses sowie eine Index-ID angeben.

Anweisungen zur Verbindung

Um eine Verbindung Amazon Kendra zu Ihrer ServiceNow Datenquelle herzustellen, müssen Sie die erforderlichen Angaben zu Ihrer ServiceNow Datenquelle machen, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Wenn Sie es noch nicht konfiguriert ServiceNow haben, Amazon Kendra sieheVoraussetzungen.

Console

Um eine Verbindung herzustellen Amazon Kendra zu ServiceNow

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Kendra Konsole.

  2. Wählen Sie im linken Navigationsbereich Indizes aus und wählen Sie dann den Index, den Sie verwenden möchten, aus der Liste der Indizes aus.

    Anmerkung

    Sie können Ihre Einstellungen für die Benutzerzugriffskontrolle unter Indexeinstellungen konfigurieren oder bearbeiten.

  3. Wählen Sie auf der Seite Erste Schritte die Option Datenquelle hinzufügen aus.

  4. Wählen Sie auf der Seite Datenquelle hinzufügen die Option ServiceNow Connector V1.0 und dann Datenquelle hinzufügen aus.

  5. Geben Sie auf der Seite „Datenquellendetails angeben“ die folgenden Informationen ein:

    1. Im Feld Name und Beschreibung für Datenquellenname — Geben Sie einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.

    2. (Optional) Beschreibung — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.

    3. In der Standardsprache — Wählen Sie eine Sprache aus, um Ihre Dokumente für den Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Dokumentmetadaten angegebene Sprache überschreibt die ausgewählte Sprache.

    4. Im Feld Schlagworte für Neues Tag hinzufügen — Fügen Sie optionale Stichwörter hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten zu verfolgen. AWS

    5. Wählen Sie Weiter aus.

  6. Geben Sie auf der Seite Zugriff und Sicherheit definieren die folgenden Informationen ein:

    1. ServiceNow host — Geben Sie die ServiceNow Host-URL ein.

    2. ServiceNow Version — Wählen Sie Ihre ServiceNow Version aus.

    3. Wählen Sie je nach Anwendungsfall zwischen Standardauthentifizierung und OAuth 2.0-Authentifizierung.

    4. AWS Secrets Manager geheim — Wählen Sie ein vorhandenes Geheimnis oder erstellen Sie ein neues Secrets Manager Geheimnis, um Ihre ServiceNow Authentifizierungsdaten zu speichern. Wenn Sie ein neues Geheimnis erstellen möchten, wird ein AWS Secrets Manager geheimes Fenster geöffnet.

      1. Secret-Name – Ein Name für Ihr Secret. Das Präfix 'AmazonKendra-ServiceNow-' wird automatisch zu deinem geheimen Namen hinzugefügt.

      2. Wenn Sie die Standardauthentifizierung verwenden — Geben Sie den geheimen Namen, den Benutzernamen und das Passwort für Ihr Konto ein. ServiceNow

        Wenn Sie die OAuth2-Authentifizierung verwenden — Geben Sie den geheimen Namen, den Benutzernamen, das Passwort, die Client-ID und den geheimen Client-Schlüssel ein , die Sie in Ihrem Konto erstellt haben. ServiceNow

      3. Wählen Sie Speichern und Secret hinzufügen aus.

    5. IAM Rolle — Wählen Sie eine vorhandene Rolle aus oder erstellen Sie eine neue IAM IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.

      Anmerkung

      IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index oder häufig gestellte Fragen verwendet wird, wählen Sie Neue Rolle erstellen, um Fehler zu vermeiden.

    6. Wählen Sie Weiter aus.

  7. Geben Sie auf der Seite Synchronisierungseinstellungen konfigurieren die folgenden Informationen ein:

    1. Wissensartikel einbeziehen — Wählen Sie diese Option, um Wissensartikel zu indizieren.

    2. Art der Wissensartikel — Wählen Sie zwischen Nur öffentliche Artikel einbeziehen und Artikel anhand einer ServiceNow Filterabfrage einbeziehen, die auf Ihrem Anwendungsfall basiert. Wenn Sie Artikel anhand einer ServiceNow Filterabfrage einbeziehen auswählen, müssen Sie eine Filterabfrage eingeben, die aus Ihrem ServiceNow Konto kopiert wurde.

    3. Anhänge von Wissensartikeln einbeziehen — Wählen Sie diese Option, um Anhänge von Wissensartikeln zu indizieren. Sie können auch bestimmte Dateitypen für die Indizierung auswählen.

    4. Katalogelemente einbeziehen — Wählen Sie diese Option, um Katalogelemente zu indizieren.

    5. Anhänge von Katalogelementen einbeziehen — Wählen Sie diese Option, um Anhänge von Katalogelementen zu indizieren. Sie können auch bestimmte Dateitypen für die Indizierung auswählen.

    6. Häufigkeit — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert.

    7. Wählen Sie Weiter aus.

  8. Geben Sie auf der Seite Feldzuordnungen festlegen die folgenden Informationen ein:

    1. Knowledge-Artikel und Servicekatalog — Wählen Sie aus den Amazon Kendra generierten Standarddatenquellenfeldern und zusätzlichen vorgeschlagenen Feldzuordnungen aus, die Sie Ihrem Index zuordnen möchten.

    2. Feld hinzufügen — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.

    3. Wählen Sie Weiter aus.

  9. Überprüfen Sie auf der Seite Überprüfen und erstellen, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle hinzufügen aus. Sie können sich auch dafür entscheiden, Ihre Informationen auf dieser Seite zu bearbeiten. Ihre Datenquelle wird auf der Seite Datenquellen angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.

API

Um eine Verbindung Amazon Kendra herzustellen ServiceNow

Mithilfe der ServiceNowConfiguration API müssen Sie Folgendes angeben:

  • Datenquellen-URL — Geben Sie die ServiceNow URL an. Der Host-Endpunkt sollte wie folgt aussehen:your-domain.service-now.com.

  • Hostinstanz der Datenquelle — Geben Sie die Version der ServiceNow Hostinstanz entweder als LONDON oder OTHERS an.

  • Geheimer Amazon-Ressourcenname (ARN) — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Secrets an, das die Authentifizierungsdaten enthält, die Sie in Ihrem ServiceNow Konto erstellt haben.

    Wenn Sie die Standardauthentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:

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

    Wenn Sie die OAuth2-Authentifizierung verwenden, wird das Geheimnis in einer JSON-Struktur mit den folgenden Schlüsseln gespeichert:

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

  • IAM role — Geben Sie anRoleArn, wann Sie aufrufenCreateDataSource, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Secret zu gewähren und die erforderlichen öffentlichen APIs für den ServiceNow Connector und aufzurufen. Amazon Kendra Weitere Informationen finden Sie unter IAM Rollen für ServiceNow Datenquellen.

Sie können auch die folgenden optionalen Funktionen hinzufügen:

  • Feldzuordnungen — Wählen Sie, ob Ihre ServiceNow Datenquellenfelder Ihren Indexfeldern zugeordnet werden sollen. Amazon Kendra Weitere Informationen finden Sie unter Zuweisen von Datenquellenfeldern.

    Anmerkung

    Das Textfeld des Dokuments oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen für den Dokumenttext in Ihrer Datenquelle dem Indexfeldnamen zuordnen_document_body. Alle anderen Felder sind optional.

  • Aufnahme- und Ausschlussfilter — Geben Sie an, ob bestimmte Dateianhänge von Katalogen und Wissensartikeln ein- oder ausgeschlossen werden sollen.

    Anmerkung

    Die meisten Datenquellen verwenden Muster mit regulären Ausdrücken, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das dem Einschlussfilter nicht entspricht, wird nicht indexiert. Wenn Sie einen Aufnahme- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.

  • Indizierungsparameter — Sie können auch angeben, ob:

    • Indexieren Sie Wissensartikel und Servicekataloge oder beide. Wenn Sie Wissensartikel und Servicekatalogelemente indizieren möchten, müssen Sie den Namen des Felds angeben, das dem ServiceNow Feld für den Inhalt des Indexdokuments im Amazon Kendra Index zugeordnet ist.

    • Indexieren Sie Anlagen zu Wissensartikeln und Katalogelementen.

    • Verwenden Sie eine ServiceNow Abfrage, die Dokumente aus einer oder mehreren Wissensdatenbanken auswählt. Die Wissensdatenbanken können öffentlich oder privat sein. Weitere Informationen finden Sie unter Angeben von Dokumenten für die Indexierung mit einer Abfrage.

Weitere Informationen

Weitere Informationen zur Integration Amazon Kendra mit Ihrer ServiceNow Datenquelle finden Sie unter: