ServiceNow Konnektor V1.0 - Amazon Kendra
Unterstützte FeaturesVoraussetzungenAnweisungen zur VerbindungWeitere 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 Organisationsebene, 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 im Jahr 2023. Wir empfehlen, auf ServiceNow Connector V2.0/zu migrieren oder diesen zu verwenden. TemplateConfiguration API

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

Unterstützte Features

Amazon Kendra ServiceNow Ein Datenquellenconnector unterstützt die folgenden Funktionen:

  • ServiceNow Instanzversionen: London, Andere

  • Muster von Inklusionen/Ausschlüssen: Servicekataloge, Wissensartikel und deren Anlagen

Voraussetzungen

Bevor Sie Ihre ServiceNow Datenquelle Amazon Kendra zum Indizieren verwenden können, müssen Sie diese Änderungen in Ihren Konten und Konten vornehmen. ServiceNow AWS

Stellen Sie sicher ServiceNow, dass Sie Folgendes haben:

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

  • Der Host Ihrer ServiceNow Instanz wurde kopiertURL. Zum Beispiel, wenn die URL der Instanz https://your-domain.service-now.com, das Format für den Host, den URL Sie eingeben, ist your-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 Ihnen, Ihre Anmeldedaten und Ihr Secret regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und 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 einen geheimen Clientschlüssel 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_Wissen

    • kb_knowledge base

    • kb_uc_kann_mtom nicht_lesen

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_anhang_doc

    • sys_user_role

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

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

  • Hat einen Amazon Kendra Index erstellt und, falls Sie den verwendet habenAPI, die Index-ID notiert.

  • Sie haben eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die verwendenAPI, ARN die 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 zugreifen zu können.

  • Sie haben Ihre ServiceNow Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie den verwendenAPI, den ARN Geheimcode notiert.

    Anmerkung

    Wir empfehlen Ihnen, Ihre Anmeldeinformationen und Ihr Geheimnis regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

Wenn Sie noch keine IAM Rolle oder keinen Schlüssel 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 das verwendenAPI, müssen Sie die einer vorhandenen IAM Rolle und ARN eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.

Anweisungen zur Verbindung

Amazon Kendra Um eine Verbindung mit Ihrer ServiceNow Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer ServiceNow Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie das noch nicht konfiguriert ServiceNow haben, Amazon Kendra sieheVoraussetzungen.

Console

Um eine Verbindung Amazon Kendra herzustellen 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 und dann den Index, den Sie verwenden möchten, aus der Indexliste 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 ServiceNowConnector V1.0 und dann Datenquelle hinzufügen aus.

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

    1. Geben Sie im Feld Name und Beschreibung für Datenquellenname 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 Standardsprache — Wählen Sie eine Sprache aus, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten des Dokuments angegebene Sprache hat Vorrang vor der ausgewählten Sprache.

    4. Unter Tags für Neues Tag hinzufügen — Fügen Sie optionale Tags hinzu, um Ihre Ressourcen zu durchsuchen und zu filtern oder Ihre Kosten nachzuverfolgen. AWS

    5. Wählen Sie Weiter.

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

    1. ServiceNow host — Geben Sie den 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 sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.

      1. Geheimer Name — Ein Name für Ihr Geheimnis. Das Präfix 'AmazonKendra- ServiceNow -' wird Ihrem geheimen Namen automatisch 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 das geheime Kundengeheimnis ein, die Sie in Ihrem Konto erstellt haben. ServiceNow

      3. Wählen Sie Speichern und Geheimnis hinzufügen.

    5. IAM Rolle — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue 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 verwendet wirdFAQ, wählen Sie Neue Rolle erstellen, um Fehler zu vermeiden.

    6. Wählen Sie Weiter.

  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 je nach Anwendungsfall zwischen Nur öffentliche Artikel einbeziehen und Artikel anhand einer ServiceNow Filterabfrage einbeziehen. Wenn Sie Artikel basierend auf einer ServiceNow Filterabfrage einbeziehen auswählen, müssen Sie eine aus Ihrem ServiceNow Konto kopierte Filterabfrage eingeben.

    3. Anlagen zu Wissensartikeln einbeziehen — Wählen Sie diese Option, um Anlagen zu 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. Anlagen zu Katalogelementen einbeziehen — Wählen Sie diese Option, um die 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 die Synchronisierung mit Ihrer Datenquelle durchgeführt?

    7. Wählen Sie Weiter.

  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 Standard-Datenquellenfeldern und weiteren vorgeschlagenen Feldzuordnungen, 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.

  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 Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite Datenquellen angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.

API

Um eine Verbindung Amazon Kendra herzustellen ServiceNow

Sie müssen Folgendes angeben mit ServiceNowConfiguration API:

  • Datenquelle 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 Host-Instanz entweder als LONDON oder OTHERS an.

  • Geheimer Amazon-Ressourcenname (ARN) — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, 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 Rolle — Geben Sie anRoleArn, wann Sie anrufenCreateDataSource, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen öffentlichen Daten APIs für den ServiceNow Connector und Amazon Kendra zu erteilen. 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 diese Option, um Ihre ServiceNow Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter Zuweisen von Datenquellenfeldern.

    Anmerkung

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

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

    Anmerkung

    Die meisten Datenquellen verwenden Muster für reguläre Ausdrücke, 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 nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.

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

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

    • Indizieren 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: