Installieren der Kandji ServiceNow-App
Falls die App noch nicht installiert ist, installieren Sie die Kandji ServiceNow-App in Ihrer ServiceNow-Instanz. Bei der Installation werden Abhängigkeiten hinzugefügt, die Ihr Tenant für die Integration benötigt.1
ServiceNow Store öffnen
Rufen Sie den ServiceNow Store auf.
2
Kandji ServiceNow-App suchen
Suchen Sie im Store nach Kandji, um die Kandji ServiceNow app zu finden.
3
Kandji ServiceNow-App installieren
Installieren Sie die Kandji ServiceNow-App, indem Sie Get auswählen. Melden Sie sich bei Aufforderung beim ServiceNow Store an. Das verwendete Konto muss berechtigt sein, Integration Hub-Store-Apps zu installieren.
Erstellen einer OAuth-App
Iru Endpoint verwendet einen ServiceNow OAuth API-Client mit dem Grant-Typ Resource Owner Password Credentials (ROPC), um Zugriffs- und Aktualisierungstoken für Ihre Instanz abzurufen.Setzen Sie unter ServiceNow Zurich und neueren Versionen die Scope Restriction auf Broadly scoped, wenn Sie den OAuth API-Endpunkt für externe Clients erstellen. Wenn dieses Feld auf einen engeren Geltungsbereich festgelegt ist, können eingehende API-Aufrufe von Iru Endpoint mit Fehlern wie OAuth client does not have unrestricted access to unscoped APIs is not allowed fehlschlagen. Weitere Informationen finden Sie im ServiceNow-Artikel KB2731346.
1
ServiceNow öffnen
Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Tenant (.service-now.com) an.
2
Zu System OAuth navigieren
Suchen Sie im Filter navigator nach System OAuth.
3
Application Registry öffnen
Wählen Sie Application Registry aus.
4
OAuth-Endpunkt erstellen
Wählen Sie Create an OAuth API endpoint for external clients aus.
5
OAuth-App konfigurieren
Geben Sie der OAuth-App einen Namen (zum Beispiel
kandji_oauth_api).6
Redirect-URL festlegen
Geben Sie im Feld Redirect URL https://kandji.io ein.
7
Konfiguration absenden
Wählen Sie Senden aus.
8
OAuth-App öffnen
Kehren Sie zu der soeben erstellten OAuth-App zurück.
9
Client-ID kopieren
Markieren und kopieren Sie die Client ID.
10
Client Secret anzeigen
Zeigen Sie das Client Secret an, indem Sie das Vorhängeschloss auswählen.
11
Client Secret kopieren
Kopieren Sie das Client Secret. Wenn Sie ein eigenes Client Secret festgelegt haben, wählen Sie Aktualisieren aus, um es zu speichern.
Hinzufügen eines Dienstkontos
Die Benutzeranmeldedaten des Dienstkontos werden zur Konfiguration der ServiceNow-Integration in Iru Endpoint verwendet.Es kann jedes ServiceNow-Benutzerkonto verwendet werden, sofern es Zugriff auf Webdienste hat und über die Rollen cmdb_read, import_transformer und rest_api_explorer verfügt. Erstellen Sie nach Möglichkeit ein dediziertes Dienstkonto für diese Integration.
1
ServiceNow öffnen
Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Tenant (.service-now.com) an.
2
Zu Users navigieren
Suchen Sie im Filter navigator nach Benutzer.
3
User Administration öffnen
Wählen Sie unter User Administration Benutzer aus.
4
Neuen Benutzer erstellen
Wählen Sie New aus, um einen neuen Benutzer hinzuzufügen.
5
Benutzerdetails konfigurieren
Geben Sie einen aussagekräftigen Namen für den Benutzer ein (zum Beispiel
kandji_rest_api_user). Kopieren Sie den Benutzernamen an einen sicheren Ort. Sie benötigen ihn bei der Konfiguration der Integration in Iru Endpoint.- Geben Sie optional weitere von Ihrer Organisation benötigte Informationen ein.
6
Webdienstzugriff festlegen
Wählen Sie Web service access only aus.
7
Benutzererstellung absenden
Wählen Sie Senden aus.
8
Benutzerpasswort festlegen
Öffnen Sie den soeben erstellten Benutzer und wählen Sie dann Set Password aus.
9
Passwort generieren
Wählen Sie Generieren aus, um das neue Passwort zu erstellen.
10
Passwort kopieren
Kopieren Sie das neue Passwort.
11
Passwort speichern
Wählen Sie Save Password aus. Bewahren Sie das Passwort an einem sicheren Ort auf. Sie geben es in Iru Endpoint ein, wenn Sie die ServiceNow-Integration konfigurieren.
12
Passwortdialog schließen
Wählen Sie Schließen aus, um zur Seite Users zurückzukehren.
13
Benutzerrollen öffnen
Wechseln Sie auf der Benutzerseite zu Roles.
14
Rollen bearbeiten
Wählen Sie Bearbeiten aus.
15
Erforderliche Rollen hinzufügen
Fügen Sie dem Dienstkontobenutzer die folgenden Rollen hinzu:
- cmdb_read
- import_transformer
- rest_api_explorer
16
Rollenzuweisung überprüfen
Es sollten insgesamt sechs Rollen angezeigt werden: drei, die Sie direkt hinzugefügt haben, und drei geerbte.
17
Benutzerkonfiguration speichern
Wählen Sie Speichern aus, um die Benutzererstellung abzuschließen.
Fehlerbehebung
Überprüfen, ob Kandji eine Discovery Source ist
1
Dictionary öffnen
Geben Sie in ServiceNow Dictionary in den Filter navigator ein.
2
Dictionary auswählen
Wählen Sie unter System Definition Dictionary aus.
3
Nach Discovery Source suchen
Wählen Sie in Dictionary Entries Column name aus und geben Sie dann discovery_source ein.
4
CMDB-Tabelle auswählen
Wählen Sie die Tabelle cmdb_ci aus.
5
Registerkarte Choices öffnen
Scrollen Sie nach unten und wählen Sie die Registerkarte Choices aus.
6
Kandji überprüfen
Vergewissern Sie sich, dass Kandji aufgeführt ist. Falls es nicht angezeigt wird, suchen Sie nach der Bezeichnung Kandji.
Wenn Kandji nicht als Discovery Source angezeigt wird
Führen Sie kandji_fix_script manuell aus, wenn Kandji nach der Installation der Kandji ServiceNow-App nicht als Discovery Source angezeigt wird.1
Fix Scripts öffnen
Geben Sie in ServiceNow Fix Script in den Filter navigator ein.
2
Fix Scripts auswählen
Wählen Sie unter System Definition Fix Scripts aus.
3
Nach Fix Script suchen
Wählen Sie in Fix Scripts Name aus und geben Sie dann kandji_fix_script ein.
4
Fix Script auswählen
Öffnen Sie den Datensatz kandji_fix_script.
5
Fix Script ausführen
Wählen Sie Run Fix Script aus.
6
Im Hintergrund ausführen
Wählen Sie im Dialog Run Fix Script Proceed in Background aus.
Überlegungen
Dienstkonten
Verwenden Sie für diese Integration vorzugsweise ein dediziertes Konto, anstatt einen interaktiven Benutzer wiederzuverwenden, damit Zugriffe und Änderungen leichter überprüft werden können.
OAuth
Setzen Sie unter Zurich und neueren Versionen die Scope Restriction auf Broadly scoped, wenn Sie die OAuth-App erstellen (siehe Erstellen einer OAuth-App). Legen Sie die Redirect-URL auf
https://kandji.io fest und bewahren Sie die Client-Anmeldedaten sicher auf.Rollen
Das Dienstkonto benötigt cmdb_read, import_transformer und rest_api_explorer.
Discovery Source
Vergewissern Sie sich nach der Installation, dass Kandji im Dictionary unter den Discovery-Source-Auswahlmöglichkeiten für cmdb_ci angezeigt wird.
Fehlerbehebung
Wenn die Discovery Source oder die Synchronisierung fehlerhaft erscheint, führen Sie das Fix Script kandji_fix_script aus und vergewissern Sie sich, dass das Dienstkonto über die drei oben genannten Rollen verfügt.
Verwandte Artikel
ServiceNow-Integration: Übersicht
Wie Inventardaten von Iru Endpoint in ServiceNow-Tabellen und -Transformationen fließen und wie SAM Pro-Daten bei Aktivierung übertragen werden.
ServiceNow-Integration: Iru Endpoint-Konfiguration
Verbinden Sie Iru Endpoint mit Ihrer OAuth-App und Ihrem Dienstkonto, und verwalten Sie die Integration, sobald ServiceNow bereit ist.