Zum Hauptinhalt springen
Dieser Artikel bietet IT-Administratoren eine technische Anleitung, um eine ServiceNow Knowledge Base für die sichere Wissensabfrage mit der Genow-Plattform zu verbinden. Die Integration nutzt OAuth 2.0 Client Credentials, damit Genow Inhalte sicher indexieren kann, während die nativen Sicherheits- und Zugriffskontrollen deiner Instanz berücksichtigt werden.
1

OAuth Client Credential Grants aktivieren

Um die Machine-to-Machine-Authentifizierung zu unterstützen, musst du sicherstellen, dass die ServiceNow-Instanz den Grant-Typ Client Credential zulässt.
  1. Öffne das All-Menü und gib sys_properties.list in den Filter Navigator ein.
  2. Suche die folgende Eigenschaft in der Spalte Name: glide.oauth.inbound.client.credential.grant_type.enabled
  3. Wenn der Datensatz existiert: Öffne den Datensatz und überprüfe, ob der Value auf true gesetzt ist. Klicke auf Update, um Änderungen zu speichern.
  4. Wenn der Datensatz nicht existiert: Klicke auf New und konfiguriere die Eigenschaft mit den folgenden Details:
    • Name: glide.oauth.inbound.client.credential.grant_type.enabled
    • Type: true | false
    • Value: true
    • Klicke auf Submit
2

Den Machine User konfigurieren

  1. Navigiere zu User Administration > Users.
  2. Klicke auf New, um einen Service Account zu erstellen.
  3. Vergib eine User ID (z. B. genow_sync_user).
  4. Setze den Identity Type auf Machine.
  5. Aktiviere das Kontrollkästchen Internal Integration User.
  6. Klicke auf Submit.
  7. Suche den Datensatz genow_sync_user in der Liste und öffne ihn erneut.
  8. Navigiere zur Related List Roles am unteren Ende und klicke auf Edit
  9. Weise die folgenden Pflichtrollen zu:
    • knowledge: Gewährt grundlegenden Lesezugriff auf die Knowledge Management Application.
    • snc_platform_rest_api_access: Erlaubt dem Konto, mit den eingehenden REST-APIs von ServiceNow zu interagieren.
  10. Verschiebe die Rollen in die rechte Spalte und klicke auf Save.
3

Knowledge Base-Sicherheit (User Criteria)

Genow hält sich an deine bestehenden Sicherheitskonfigurationen. Wenn du eingeschränkte Knowledge Bases synchronisieren möchtest, müssen dem Machine User explizite Leseberechtigungen erteilt werden.
  1. Navigiere zu Knowledge > Administration > Knowledge Bases.
  2. Öffne die spezifische Knowledge Base, die für die Synchronisierung vorgesehen ist.
  3. Scrolle zur Related List Can Read am unteren Ende der Seite.
  4. Wenn deine Instanz standardmäßig verborgenen oder eingeschränkten Zugriff verwendet, klicke auf New (oder bearbeite bestehende Kriterien), um deinen genow_sync_user zur Liste hinzuzufügen. So wird sichergestellt, dass die Integration den notwendigen Lesezugriff hat, um die Inhalte zu indexieren.
4

Die OAuth-Anwendung registrieren

  1. Navigiere zu System OAuth > Application Registry.
  2. Klicke auf New und wähle die Option: Create an OAuth API endpoint for external clients.
  3. Gib einen Name für die Registrierung an (z. B. Genow Sync).
  4. Setze den Client Type auf Integration as a Service.
  5. Um die Pflichtfelder einzublenden, klicke mit der rechten Maustaste auf die graue Kopfzeile, wähle Configure > Form Design und ziehe die Felder Default Grant Type und OAuth Application User auf das Formular. Speichere deine Formularänderungen.
  6. Aktualisiere die Seite Application Registry in deinem Browser.
  7. Setze den Default Grant Type auf Client Credentials.
  8. Setze den OAuth Application User auf den in Phase 2 erstellten genow_sync_user.
  9. Lasse die folgenden Felder leer: Client Secret, Redirect URL und Login URL.
  10. Suche das Feld Scope Restriction auf der rechten Seite und ändere es von Securely scoped zu Broadly scoped. Das ist notwendig, damit das Token auf globale Tabellen wie die Knowledge Base zugreifen kann.
  11. Klicke auf Submit (oder klicke mit der rechten Maustaste auf die Kopfzeile und klicke auf Save, um auf dem Datensatz zu bleiben).
5

Credentials abrufen und abschließen

Rufe die automatisch generierten Schlüssel ab, um die Verbindung innerhalb der Genow-Plattform abzuschließen.
  1. Öffne den Datensatz Genow Sync, den du in der Application Registry erstellt hast.
  2. Kopiere den String der Client ID.
  3. Klicke auf das Schloss-Symbol neben dem Feld Client Secret, um das automatisch generierte Passwort anzuzeigen, und kopiere es.
  4. Gib die Client ID und das Client Secret in die Genow-Plattform ein, um ein “Credential”-Objekt zu erstellen.
Sicherheitshinweis: Das Client Secret wird als sensible Daten behandelt und verschlüsselt und sicher im Google Cloud Secret Manager gespeichert.