Bevor Sie die Integration in Kandji abschließen, müssen Sie die Kandji ServiceNow-Anwendung im ServiceNow Integration Hub installieren, eine OAuth-API-Anwendung erstellen und einen service account user in Ihrer ServiceNow-Konsole hinzufügen.
Installieren der Kandji ServiceNow-App
Falls noch nicht geschehen, müssen Sie die Kandji ServiceNow Integration Hub-App in Ihrer ServiceNow-Instanz installieren. Durch die Installation der App werden einige der erforderlichen Abhängigkeiten in Ihrem ServiceNow-Mandanten eingerichtet.
Wechseln Sie zum ServiceNow Store.
Suchen Sie Kandji.
Installieren Sie die Kandji Integrationsanwendung, indem Sie auf Get klicken. Möglicherweise müssen Sie sich beim ServiceNow Store authentifizieren, bevor Sie die App installieren können. Die verwendeten Anmeldeinformationen sollten in der Lage sein, Integration Hub Store-Apps zu installieren.
Erstellen einer OAuth-App
Kandji verwendet einen ServiceNow OAuth-API-Client, der den Grant-Typ "Resource Owner Password Credentials (ROPC)" nutzt, um Zugriffs- und Aktualisierungstoken für die Interaktion mit der ServiceNow-Instanz anzufordern.
Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Mandanten ({yourtenant}.service-now.com) an.
Suchen Sie im Filter-Navigator nach System OAuth.
Klicken Sie auf Anwendungsregistrierung.
Klicken Sie auf OAuth-API-Endpunkt für externe Clients erstellen.
Geben Sie der OAuth-App einen Namen. (Beispiel: kandji_oauth_api)
Geben Sie im Feld Umleitungs-URL https://kandji.io ein.
Klicken Sie auf Senden.
Kehren Sie zu der OAuth-App zurück, die Sie gerade erstellt haben.
Markieren Sie die Client-ID, und kopieren Sie diese.
Zeigen Sie den geheimen Clientschlüssel an, indem Sie auf das Vorhängeschloss klicken.
Markieren und kopieren Sie den geheimen Clientschlüssel, oder klicken Sie optional: Wenn Sie Ihren eigenen geheimen Clientschlüssel eingeben, klicken Sie auf Aktualisieren , um die Änderung zu speichern.
Hinzufügen eines Dienstkontos
Die Benutzeranmeldeinformationen des Dienstkontos werden verwendet, um die ServiceNow-Integration in Kandji zu konfigurieren.
Jedes ServiceNow-Benutzerkonto kann verwendet werden, solange es Zugriff auf Webdienste hat und die folgenden Rollen zugewiesen sind: cmdb_read, import_transformer und rest_api_explorer. Im Allgemeinen empfiehlt es sich jedoch, für jede Integration separate Dienstkonten zu erstellen.
Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Mandanten ({yourtenant}.service-now.com) an.
Suchen Sie im Filter-Navigator nach Benutzern.
Klicken Sie unter Benutzerverwaltung auf Benutzer.
Klicken Sie auf Neu , um einen neuen Benutzer hinzuzufügen.
Geben Sie einen aussagekräftigen Namen für den Benutzer ein. (Beispiel:
kandji_rest_api_user). Kopieren Sie den Benutzernamen an einen sicheren Ort. Sie verwenden diese Anmeldeinformationen, wenn Sie die Integration in Kandjieinrichten.Geben Sie optional alle zusätzlichen Informationen ein, die für Ihre Organisation erforderlich sind.
Achten Sie darauf, dass Sie Nur Webdienstzugriff auswählen.
Klicken Sie auf Senden.
Klicken Sie auf den neuen Benutzer, der gerade erstellt wurde, und klicken Sie auf Kennwort festlegen.
Klicken Sie auf Generieren , um das neue Passwort zu erstellen.
Kopieren Sie das neue Kennwort.
Klicken Sie auf Passwort speichern. Bewahren Sie dieses Passwort an einem sicheren Ort auf. Dieses Kennwort wird in Kandji bei der Konfiguration der ServiceNow-Integration verwendet.
Klicken Sie auf Schließen , um zur Seite Benutzer zurückzukehren.
Wechseln Sie noch auf der Benutzerseite zu Rollen.
Klicken Sie auf Bearbeiten.
Fügen Sie dem Dienstkontobenutzer die folgenden Rollen hinzu.
cmdb_read
import_transformer
rest_api_explorer
Es sollten insgesamt sechs neue Rollen zugewiesen werden. Drei zugewiesen und drei geerbt.
Um die Benutzererstellung abzuschließen, klicken Sie auf Speichern.
Fehlerbehebung
Stellen Sie sicher, dass Kandji eine Ermittlungsquelle ist.
Geben Sie in ServiceNow im Filter-Navigator Dictionary ein.
Klicken Sie unter Systemdefinition auf Wörterbuch.
Stellen Sie in der Suche Dicionary Entires sicher, dass Spaltenname ausgewählt ist, und geben Sie dann den Spaltennamen dicovery_source ein.
Klicken Sie auf die cmdb_ci Tabelle.
Scrollen Sie nach unten und wählen Sie die Registerkarte Auswahlmöglichkeiten aus.
Stellen Sie sicher, dass Kandji aufgeführt ist. Wenn Sie Kandji nicht sofort sehen, können Sie nach dem LabelKandjisuchen.
Wenn Kandji nicht als Discovery-Quelle angezeigt wird
In diesem Abschnitt wird beschrieben, wie Sie die kandji_fix_script manuell ausführen, falls Kandji nach der Installation der Kandji Integration Hub-Anwendung nicht automatisch als Discovery-Quelle angezeigt wird.
Geben Sie in ServiceNow im Filter-Navigator den Namen Fix Script ein.
Klicken Sie unter Systemdefinition auf Skripts korrigieren.
Stellen Sie in der Suche nach Fix Scripts sicher, dass Name ausgewählt ist, und geben Sie dann den Namen des Fix Script kandji_fix_script ein.
Klicken Sie auf die kandji_fix_script Tabelle.
Klicken Sie auf "Fix Script ausführen".
Klicken Sie im Modal Run Fix Script auf Proceed in Background.
Jetzt sollte Kandji als Discovery-Quelle in ServiceNow aufgeführt sein.
Als nächstes
Kandji Konfiguration für die Kandji ServiceNow-Integration.