Integrationseinstellungen für werden konfiguriert ServiceNow Services und Komponenten in AEM

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 Definieren Sie eine ursprungsübergreifende Ressourcenfreigaberegel (CORS) für den Zugriff ServiceNow API-Endpunkte von AEM.

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 > Konfigurationan.
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.

Definieren Sie eine ursprungsübergreifende Ressourcenfreigaberegel (CORS) für den Zugriff ServiceNow API-Endpunkte von AEM

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-Regelnan.
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.