Integrationseinstellungen für ServiceNow -Services und -Komponenten in AEM konfigurieren

Sie müssen Ihre ServiceNow-Dienste und -Komponenten so einrichten, dass sie sich in Ihre Adobe Experience Manager (AEM)-Instanz integrieren lassen.

Einstellungen zum Aktivieren der Verwendung von ServiceNow-Services in AEM

Sie können die folgenden Arten von Konfigurationseinstellungen für ServiceNow-Services in AEM definieren:

• Authentifizierungseinstellungen mit einem Drittpartei-OIDC-Provider (siehe OIDC-Provider-Details in Adobe Experience Manager konfigurieren).
• Spezifische Einstellungen für ServiceNow-Services (siehe OSGi-Konfigurationseinstellungen für ServiceNow-Services definieren).
• Protokolldatei-Einstellungen für ServiceNow-Services (siehe Protokolldateieinstellungen für die ServiceNow-Services in Adobe Experience Manager (AEM) konfigurieren).

Einstellungen für die Verwendung von ServiceNow-Komponenten in AEM

Um den Knowledge API-Endpunkt in Ihrer AEM-Instanz zu verwenden, müssen Sie die CORS-Regel (Cross-Origin Resource Sharing) für Ihre ServiceNow-Instanz definieren. Weitere Informationen finden Sie unter Cross Origin Ressource Sharing-Regeln für den Zugriff auf die ServiceNow-API-Endpunkte von AEM definieren.

OSGi-Konfigurationseinstellungen für ServiceNow-Services definieren

Definieren Sie OSGi-Konfigurationseinstellungen für ServiceNow-Services, die von ServiceNow-Komponenten in Adobe Experience Manager (AEM) verwendet werden.

Vorbereitungen

Erforderliche Rolle: AEM-Administrator

Prozedur

1. Greifen Sie auf die Webkonsole in AEM zu, indem Sie eine URL im folgenden Format verwenden: https://<AEM_Hostname>:<AEM_Port>/system/console/configMgr.
2. Suchen Sie nach ServiceNow-Konfiguration.
3. Klicken Sie in der Spalte Name auf den Link ServiceNow-Konfiguration.
4. Geben Sie Werte für die Konfigurationseinstellungen an.

   Tabelle : 1. ServiceNow-Konfigurationseinstellungen

   Feld	Beschreibung
   Basisinstanz-URL	Vollständige URL Ihrer ServiceNow-Instanz.
   Knowledge Bases	Systembezeichner (sys_id) einer Knowledge Base, die zugehörige Wissensartikel enthält. Trennen Sie bei mehreren Einträgen die Knowledge Bases durch Kommata. Hinweis: Ein leerer Wert gibt an, dass Artikel aus allen Knowledge Bases in Ihrer ServiceNow-Instanz für einen Benutzer mit den entsprechenden Berechtigungen zugänglich sind.
   Artikel in allen Sprachen anzeigen	Option zum Anzeigen von Wissensartikeln in allen Sprachen für ServiceNow-Komponenten.

5. Klicken Sie auf Speichern.

Protokolldateieinstellungen für die ServiceNow-Services in Adobe Experience Manager (AEM) konfigurieren

Konfigurieren Sie Protokolldateieinstellungen für ServiceNow-Services in Adobe Experience Manager (AEM), um Debug-Protokolle zu generieren, die bei der Erkennung von Problemen im Authentifizierungsprozess helfen.

Vorbereitungen

Erforderliche Rolle: AEM-Administrator

Prozedur

1. Greifen Sie auf die Webkonsole in AEM zu, indem Sie eine URL im folgenden Format verwenden: https://<AEM_Hostname>:<AEM_Port>/system/console/configMgr.
2. Navigieren zu OSGi > Konfiguration.
3. Suchen Sie logs/project-servicenow-components.log: info, und wählen Sie die Option aus.
4. Überprüfen Sie die Standardfeldwerte, oder tragen Sie für eine benutzerdefinierte Konfiguration eigene Werte ein.

   Tabelle : 2. Protokollierung-Konfigurationseinstellungen

   Feld	Wert
   Protokollebene	Debuggen
   Protokolldatei	Pfad der ServiceNow-Protokolldatei.
   Nachrichtenmuster	Nachrichtenformat-Muster zum Formatieren von Protokollnachrichten.
   Protokollierung	Protokollierungsname für ServiceNow-Anmelde-Services.
   Additivität	Option zum Deaktivieren des Sendens von Protokollen an einen weiter oben in der Hierarchie angehängten Appender.

5. Klicken Sie auf Speichern.

Cross Origin Ressource Sharing-Regeln für den Zugriff auf die ServiceNow-API-Endpunkte von AEM definieren

Definieren Sie eine CORS-Regel (Cross-Origin Resource Sharing) auf Ihrer ServiceNow-Instanz, um von Ihrer AEM-Instanz (Adobe Experience Manager) aus auf Endpunkte der Knowledge Management-REST-API, Fall-API oder CSM-Anhang-API zuzugreifen.

Vorbereitungen

Vergewissern Sie sich, dass Sie die API konfiguriert haben, für die Sie die CORS-Regel definieren.

• Aktivieren Sie das Knowledge API-Plugin (sn_km_api), um die Knowledge Management-REST-API-Endpunkte für Wissensartikel zu verwenden. Weitere Informationen finden Sie unter Knowledge Management REST-API.
• Aktivieren Sie das Plugin „Customer Service“ (com.sn_customerservice), um die Fall-API-Endpunkte für Kundenservicefälle zu verwenden. Weitere Informationen finden Sie unter Fall-API.
• Konfigurieren Sie die Systemeigenschaft glide.rest.attachment_csm_api.allowed_tables, und schließen Sie die Falltabelle [sn_customerservice_case] ein, um die CSM-Anhang-API-Endpunkte für Fallanlagen zu verwenden. Weitere Informationen finden Sie unter CSM-Anhang-API.

Erforderliche Rolle: web_service_admin

Warum und wann dieser Vorgang ausgeführt wird

Prozedur

1. Navigieren zu Alle > System-Webservices > CORS-Regeln.
2. Klicken Sie auf Neu.
3. Füllen Sie die Felder im Formular „CORS-Regel“ aus.

   Tabelle : 3. CORS-Regelformular

   Feld	Beschreibung
   Name	Name zum Identifizieren Ihrer CORS-Regel.
   REST-API	REST API, für die diese CORS-Regel gilt. Für Wissensartikel wählen Sie Knowledge Management-REST-API [sn_km_api/knowledge] aus. Für Kundenservicefälle wählen Sie Fall [sn_customerservice/case] aus. Für Fallanlagen wählen Sie die CSM-Anhang-API aus [now attachment_csm] aus.
   Domäne	AEM-Instanz, für die diese CORS-Regel gilt.
   Max. Alter	Anzahl von Sekunden, um die Clientsitzung im Cache zu speichern.

4. Wählen Sie in der zugehörigen Liste „HTTP-Methoden“ HTTP-Methoden aus, um eine Anforderung an einen Webservice-Provider zu senden.
   • Für Wissensartikel wählen Sie GET.
   • Für Kundenservicefälle wählen Sie GET, PUT, POST.
   • Für Fallanlagen wählen Sie GET, POST, DELETE.
5. Geben Sie im Feld Zugängliche Header der zugehörigen Liste „HTTP-Header“ für Fall-API X-Gesamtzahl ein.
6. Klicken Sie auf Absenden.