Bereitstellen des ServiceNow-Katalog-Microsoft 365 Copilot-Connectors

Der ServiceNow-Katalog-Microsoft 365 Copilot-Connector ermöglicht es Ihrem organization, Katalogelemente aus ServiceNow zu indizieren und in Microsoft 365-Umgebungen, einschließlich Copilot und Microsoft Search, auffindbar zu machen. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des Connectors beschrieben.

Allgemeine Informationen zur Bereitstellung des Copilot-Connectors finden Sie unter Einrichten von Copilot-Connectors im Microsoft 365 Admin Center.

Informationen zur erweiterten ServiceNow-Konfiguration finden Sie unter Einrichten des ServiceNow-Katalogdiensts für die Connectorerfassung.

Voraussetzungen

Stellen Sie vor der Bereitstellung des ServiceNow Catalog-Connectors sicher, dass Ihre ServiceNow-Umgebung ordnungsgemäß konfiguriert ist. In der folgenden Tabelle sind die Schritte zum Konfigurieren der ServiceNow-Katalogumgebung und zum Bereitstellen des Connectors zusammengefasst.

Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Sie sind ein Microsoft 365-Administrator.
• Sie verfügen über die ServiceNow-instance-URL.
• Sie haben ein ServiceNow-Dienstkonto mit Lesezugriff auf erforderliche Tabellen erstellt.
• Die Netzwerkfirewall ermöglicht den Zugriff auf Microsoft-Connector-IP-Adressbereiche.
• Sie haben ggf. OAuth- oder OpenID Connect-Anmeldeinformationen bereitgestellt.
• Sie haben die Felder beschreibung und kurze Beschreibung für Katalogelemente ausgefüllt.

Bereitstellen des Connectors

So fügen Sie den ServiceNow-Katalogconnector für Ihre organization hinzu:

1. Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
2. Wechseln Sie zur Registerkarte Connectors , und wählen Sie im linken Bereich Katalog aus.
3. Wählen Sie in der Liste der verfügbaren Connectors ServiceNow Catalog aus.

Festlegen des Anzeigenamens

Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, vertrauenswürdige Inhalte zu erkennen. Sie können den Standardanzeigenamen von ServiceNow akzeptieren oder an die Terminologie Ihres organization anpassen.

Weitere Informationen finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.

Auswählen des Flows basierend auf Benutzerkriterien

Der ServiceNow Catalog-Connector unterstützt zwei Flows für Benutzerkriterienberechtigungen: Einfach und Erweitert.

Der Standardwert ist Einfach. In diesem Flow werden erweiterte skriptbasierte Benutzerkriterien beim Auswerten von Katalogelementberechtigungen nicht berücksichtigt.

Wenn Ihr ServiceNow-instance erweiterte Skripts in Ihren Katalogkategorie- oder Katalogelementbenutzerkriterien verwendet, verwenden Sie den Erweiterten Flow. Dieser Flow stellt eine genaue Verarbeitung von Berechtigungen sicher, wenn Inhalte in Microsoft Graph erfasst werden. Weitere Informationen finden Sie unter Suchen nach erweiterten Skripts.

Festlegen instance URL

Um eine Verbindung mit Ihrer ServiceNow-Website herzustellen, verwenden Sie die instance URL Ihres organization, die in der Regel die folgende URL ist:

https://<your-organization-name>.service-now.com

Wenn Ihr organization ein benutzerdefiniertes Portal (z. B. ESC oder SP) verwendet, geben Sie während des Setups die richtige URL an. Wenn Sie Hilfe beim Identifizieren Ihrer instance URL benötigen, wenden Sie sich an Ihren ServiceNow-Administrator, oder überprüfen Sie ihre Portalkonfiguration.

Auswählen des Authentifizierungstyps

Wählen Sie eine der folgenden Authentifizierungsmethoden aus:

• Standardauthentifizierung: Verwenden Sie ein ServiceNow-Konto mit der catalog Rolle. Geben Sie den Benutzernamen und das Kennwort direkt in die Connectoreinrichtung ein.
• OAuth 2.0 (empfohlen): Konfigurieren Sie einen OAuth-Endpunkt in ServiceNow, und geben Sie die Client-ID und den geheimen Schlüssel an. Weitere Informationen finden Sie unter OAuth 2.0.
• Microsoft Entra ID OpenID Connect: Verwenden Sie registrierte Anwendungsanmeldeinformationen aus Microsoft Entra ID. Weitere Informationen finden Sie unter Microsoft Entra ID OpenID Connect.

OAuth 2.0

So verwenden Sie ServiceNow OAuth für die Authentifizierung:

• Ein ServiceNow-Administrator muss einen OAuth-Endpunkt in Ihrem ServiceNow-instance bereitstellen. Weitere Informationen finden Sie unter Erstellen eines Endpunkts für Clients für den Zugriff auf die instance.

• Geben Sie im Formular zur Endpunkterstellung die folgenden Werte an.

  Feld	Beschreibung	Empfohlener Wert
  Name	Eindeutiger Wert, der die Anwendung identifiziert, für die Sie OAuth-Zugriff benötigen.	Microsoft Search
  Client-ID	Eine schreibgeschützte, automatisch generierte eindeutige ID für die Anwendung. Die instance verwendet die Client-ID, wenn sie ein Zugriffstoken anfordert.	Automatisch generiert
  Geheimer Clientschlüssel	Mit dieser gemeinsam genutzten geheimnisigen Zeichenfolge autorisieren die ServiceNow-instance und Microsoft Search die Kommunikation miteinander.	Als Kennwort behandeln
  Umleitungs-URL	Eine erforderliche Rückruf-URL, an die der Autorisierungsserver umleitet.	Für Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback Für Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  Logo-URL	Eine URL, die das Bild für das Anwendungslogo enthält.	–
  Aktiv	Aktivieren Sie das Kontrollkästchen, um die Anwendungsregistrierung zu aktivieren.	Checked
  Lebensdauer des Aktualisierungstokens	Die Anzahl der Sekunden, für die ein Aktualisierungstoken gültig ist. Aktualisierungstoken laufen standardmäßig in 100 Tagen (8.640.000 Sekunden) ab.	31.536.000 Sekunden (ein Jahr)
  Lebensdauer des Zugriffstokens	Die Anzahl der Sekunden, für die ein Zugriffstoken gültig ist.	43.200 Sekunden (12 Stunden)

• Geben Sie die Client-ID und den geheimen Clientschlüssel in die Connectoreinrichtung ein.

• Verwenden Sie Anmeldeinformationen eines ServiceNow-Kontos mit mindestens der catalog Rolle, um Durchforstungsberechtigungen zu authentifizieren.

Microsoft Entra ID OpenID Connect

So verwenden Sie Microsoft Entra ID OpenID Connect:

1. Registrieren Sie eine neue Anwendung in Microsoft Entra ID. Weitere Informationen finden Sie unter Registrieren einer Anwendung.

   • Wählen Sie organisationsverzeichnis mit nur einem Mandanten aus.
   • Notieren Sie sich die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant).

2. Erstellen Sie einen geheimen Clientschlüssel , und speichern Sie ihn sicher. Weitere Informationen finden Sie unter Erstellen eines geheimen Clientschlüssels.

   • Wechseln SiezuZertifikate und Geheimnisse verwalten>.
   • Wählen Sie einen neuen geheimen Clientschlüssel aus.
   • Geben Sie einen Namen an, und wählen Sie Speichern aus.

3. Rufen Sie den Dienstprinzipalobjektbezeichner mithilfe von PowerShell ab.

   Install-Module -Name Az -AllowClobber -Scope CurrentUser
   Connect-AzAccount
   Get-AzADServicePrincipal -ApplicationId "<Application-ID>"
   

   Ersetzen Sie "Application-ID" durch die Anwendungs-ID (Client) der Anwendung, die Sie in Schritt 2 registriert haben. Notieren Sie sich den Wert des ID-Objekts aus der PowerShell-Ausgabe. Dieser Wert ist die Dienstprinzipalobjekt-ID.

   Alternativ können Sie die Informationen aus dem Microsoft Entra Admin Center abrufen: a. Navigieren Sie in der App-Registrierung zu Übersicht. b. Wählen Sie verwaltete Anwendung im lokalen Verzeichnis aus. c. Wählen Sie die URL aus, und kopieren Sie die Objekt-ID. Dies ist die Dienstprinzipalobjekt-ID.

4. Registrieren Sie in Ihrem ServiceNow-instance die ServiceNow-Anwendung. Weitere Informationen finden Sie unter Erstellen eines OAuth-OIDC-Anbieters. Verwenden Sie die werte, die in der folgenden Tabelle im Registrierungsformular aufgeführt sind. Übernehmen Sie die Standardwerte für die anderen Felder.

   Feld	Beschreibung	Wert
   Name	Ein eindeutiger Name für die OAuth-OIDC-Entität.	Microsoft Entra-ID
   Client-ID	Ab Microsoft Entra ID Registrierung	Anwendungs-ID (Client-ID)
   Geheimer Clientschlüssel	Ab Microsoft Entra ID Registrierung	Geheimer Clientschlüssel

   Hinweis

   Nachdem Sie die OAuth-OIDC-Entität erstellt haben, wird der geheime Clientschlüssel automatisch in ServiceNow generiert. Ersetzen Sie diesen geheimen Clientschlüssel durch den geheimen Clientschlüssel, der im Microsoft Entra Admin Center generiert wurde.

5. Wählen Sie im Feld OAuth OIDC Provider Configuration (OAuth-OIDC-Anbieterkonfiguration ) das Suchsymbol und dann Neu aus. Füllen Sie das Formular für die Konfiguration des OIDC-Anbieters wie folgt aus.

   Feld	Wert
   OIDC-Anbieter	Microsoft Entra-ID
   OIDC-Metadaten-URL	https://login.microsoftonline.com/<tenantId>/.well-known/openid-configuration
   OIDC OIDC Configuration Cache Life Span Application	Global
   Benutzeranspruch	Sub
   Benutzerfeld	Benutzer-ID
   Aktivieren der JTI-Anspruchsüberprüfung	Deaktiviert

6. Wählen Sie Senden aus, um die Konfiguration zu speichern.

7. Erstellen Sie ein ServiceNow-Konto. Weitere Informationen finden Sie unter Erstellen eines Benutzers in ServiceNow. Verwenden Sie die folgenden Werte: Übernehmen Sie die Standardeinstellung für andere Felder.

   Feld	Empfohlener Wert
   Benutzer-ID	Dienstprinzipal-ID
   Nur Webdienstzugriff	Checked

8. Weisen Sie dem ServiceNow-Konto die Katalogrolle zu. Weitere Informationen finden Sie unter Zuweisen einer Rolle zu einem Benutzer. Verwenden Sie die Anwendungs-ID als Client-ID und geheimer Clientschlüssel im Admin Center-Konfigurations-Assistenten, um sich mit Microsoft Entra ID OpenID Connect zu authentifizieren.

Hinzufügen eines API-Namespaces

Wenn Sie den Erweiterten Flow verwenden, geben Sie den API-Namespace ein, den Sie in Ihrem ServiceNow-instance erstellt haben. Weitere Informationen finden Sie unter Einrichten der REST-API.

Rollout

Um den Connector vor einer vollständigen Bereitstellung zu überprüfen, führen Sie ihn für eine begrenzte Zielgruppe aus:

1. Wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus.
2. Geben Sie die Benutzer oder Gruppen für den Pilotrollout an.

Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der ServiceNow Catalog-Connector beginnt sofort mit der Indizierung von Inhalten.

Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status (einschließlich der Anzahl der indizierten Benutzer und Elemente) im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.

Wenn die Verbindung status bereit ist, können Sie das indizierte Inhaltselement mithilfe des Indexbrowsers überprüfen, indem Sie die des sys_id Katalogelements angeben, auf das Sie testen möchten, und dessen Berechtigungen für Benutzer überprüfen. Weitere Informationen finden Sie unter Suchen und Überprüfen von indizierten Inhalten.

In den folgenden Abschnitten sind die Standardwerte aufgeführt, die festgelegt sind. Um diese Werte anzupassen, wählen Sie Benutzerdefiniertes Setup aus. Weitere Informationen finden Sie unter Anpassen von Einstellungen.

Benutzer

• Zugriffsberechtigungen: Nur Personen mit Zugriff auf Inhalte in der Datenquelle.
• Identitätszuordnung: Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden.

Inhalt

• Abfragefilter:* Indizierte Inhalte werden basierend auf der folgenden Standardabfrage gefiltert: active=true^workflow_state=published
• Indizierte Eigenschaften: Eine Liste der Standardeigenschaften und des Standardschemas finden Sie unter Verwalten von indizierten Eigenschaften.

Synchronisieren

• Inkrementelle Durchforstung: Alle 15 Minuten.
• Vollständige Durchforstung: Jeden Tag.

Anpassen von Einstellungen (optional)

Sie können die Standardwerte für die ServiceNow Catalog-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.

Anpassen von Benutzereinstellungen

Zugriffsberechtigungen

Der ServiceNow Catalog-Connector unterstützt die folgenden Berechtigungen für die Benutzersuche:

• Jeder
• Nur Personen mit Zugriff auf diese Datenquelle (Standard)

Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die gemäß den Benutzerkriterien Zugriff darauf haben.

Zuordnen von Identitäten

Standardmäßig ordnet ServiceNow die E-Mail-IDs der Benutzer in ServiceNow den entsprechenden Microsoft Entra ID (UPN oder Mail) zu. Sie können eine benutzerdefinierte Zuordnungsformel bereitstellen, wenn Ihr organization unterschiedliche Identitätsattribute verwendet. Weitere Informationen finden Sie unter Zuordnen von nicht Microsoft Entra ID Identitäten.

Anpassen von Inhaltseinstellungen

Um den Inhalt anzupassen, können Sie auf der Registerkarte Inhalt :

• Ändern Sie die Abfragezeichenfolge, um Katalogelemente zu filtern.
• Wählen und verwalten Sie indizierte Eigenschaften, und legen Sie sie als durchsuchbar, abrufbar und verfeinernd fest.
• Passen Sie die AccessUrl-Eigenschaft an das Portalformat Ihres organization an. Beispiel: https://instancedomain.service-now.com/sp?id=sc_cat_item&sys_id=${SysId}.
• Definieren Sie Regeln, um URLs basierend auf der Katalogkategorie anzupassen.
• Zeigen Sie eine Vorschau von Beispieldaten an, um Eigenschaftswerte und Filter zu überprüfen.

Abfragezeichenfolge

ServiceNow verwendet den folgenden Standardfilter: active=true^workflow_state=published.

Sie können diesen Filter so ändern, dass nur bestimmte Katalogelemente basierend auf den Anforderungen Ihrer Organisation indiziert werden. Verwenden Sie den Codierten Abfragezeichenfolgen-Generator von ServiceNow, um benutzerdefinierte Filter zu erstellen. Weitere Informationen finden Sie unter Generieren einer codierten Abfragezeichenfolge über einen Filter.

Verwalten von indizierten Eigenschaften

Die folgenden Eigenschaften sind standardmäßig indiziert. Diese Eigenschaften wirken sich darauf aus, wie Benutzer Katalogelemente in Microsoft 365 Copilot suchen, filtern und anzeigen können.

Festlegen eines Standardausdrucks für AccessURL

So definieren Sie einen benutzerdefinierten Ausdruck für die AccessURL-Eigenschaft :

1. Wechseln Sie auf der Registerkarte Inhalt zu Eigenschaften verwalten.
2. Wählen Sie in der Tabelle Eigenschaften die Eigenschaft aus AccessURL .
3. Geben Sie im Seitenbereich unter Standardausdruck ihren benutzerdefinierten Ausdruck in das Feld Neuer Standardausdruck ein. Verwenden Sie ${PropertyName} die Syntax für dynamische Werte. Beispiel: https://instancedomain.service-now.com/sp?id=sc_cat_item&sys_id=${SysId}.
4. Wählen Sie Änderungen speichern aus.
5. Um eine Vorschau des Ergebnisses anzuzeigen, wählen Sie Datenvorschau aus, und scrollen Sie zur angepassten Eigenschaft.

Hinzufügen von Regeln für bedingte Ausdrücke

Sie können den Standardausdruck für bestimmte Katalogelemente mithilfe von Regeln überschreiben, die auf Eigenschaftenfiltern basieren. Zum Hinzufügen einer Regel:

1. Wählen Sie unter Zusätzliche Regeln zum Konfigurieren von Ausdrücken festlegen die Option Neue Regel hinzufügen aus.
2. Im Regelbereich:
   • Wählen Sie eine Filtereigenschaft aus (z. B. Kategorie).
   • Geben Sie mindestens einen Wert ein (kommagetrennt, Groß-/Kleinschreibung beachten).
   • Definieren Sie den benutzerdefinierten Ausdruck für diese Werte.
3. Wählen Sie Änderungen speichern aus.
4. Um eine Vorschau anzuzeigen, wählen Sie Datenvorschau aus, und scrollen Sie zur benutzerdefinierten Eigenschaft.

Weitere Informationen finden Sie unter Anpassen von Werten für bestimmte Schemaeigenschaften.

Anpassen von Synchronisierungsintervallen

Sie können die Häufigkeit von inkrementellen und vollständigen Durchforstungen definieren:

• Vollständige Durchforstung : Indiziert alle Inhalte neu, entfernt gelöschte Inhalte und aktualisiert alle Berechtigungen. Die Standardhäufigkeit ist täglich.
• Inkrementelle Durchforstung : Synchronisiert nur geänderte Inhalte, keine Aktualisierungen von Berechtigungen. Die Standardhäufigkeit ist alle 15 Minuten.

Weitere Informationen zu vollständigen und inkrementellen Durchforstungen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Verwandte Inhalte

• Übersicht über den ServiceNow-Katalogconnector
• Behandeln von Problemen mit dem ServiceNow Catalog-Connector
• Einrichten von Copilot-Connectors im Admin Center