> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow-Integration: ServiceNow-Konfiguration

> Installieren Sie die Kandji ServiceNow-App, erstellen Sie OAuth-Anmeldedaten und ein Dienstkonto, und überprüfen Sie die Discovery-Source-Einstellungen für die Iru Endpoint-Integration.

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

<Steps>
  <Step title="ServiceNow Store öffnen">
    Rufen Sie den [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) auf.
  </Step>

  <Step title="Kandji ServiceNow-App suchen">
    Suchen Sie im Store nach **Kandji**, um die **Kandji ServiceNow app** zu finden.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Note>
  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](https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB2731346).
</Note>

<Steps>
  <Step title="ServiceNow öffnen">
    Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Tenant ({yourtenant}.service-now\.com) an.
  </Step>

  <Step title="Zu System OAuth navigieren">
    Suchen Sie im **Filter navigator** nach **System OAuth**.
  </Step>

  <Step title="Application Registry öffnen">
    Wählen Sie **Application Registry** aus.
  </Step>

  <Step title="OAuth-Endpunkt erstellen">
    Wählen Sie **Create an OAuth API endpoint for external clients** aus.
  </Step>

  <Step title="OAuth-App konfigurieren">
    Geben Sie der OAuth-App einen Namen (zum Beispiel `kandji_oauth_api`).
  </Step>

  <Step title="Redirect-URL festlegen">
    Geben Sie im Feld **Redirect URL** [**https://kandji.io**](https://kandji.io) ein.
  </Step>

  <Step title="Konfiguration absenden">
    Wählen Sie **Senden** aus.
  </Step>

  <Step title="OAuth-App öffnen">
    Kehren Sie zu der soeben erstellten OAuth-App zurück.
  </Step>

  <Step title="Client-ID kopieren">
    Markieren und kopieren Sie die **Client ID**.
  </Step>

  <Step title="Client Secret anzeigen">
    Zeigen Sie das **Client Secret** an, indem Sie das Vorhängeschloss auswählen.
  </Step>

  <Step title="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.
  </Step>
</Steps>

### Hinzufügen eines Dienstkontos

Die Benutzeranmeldedaten des Dienstkontos werden zur Konfiguration der ServiceNow-Integration in Iru Endpoint verwendet.

<Note>
  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.
</Note>

<Steps>
  <Step title="ServiceNow öffnen">
    Melden Sie sich mit einem ServiceNow-Administratorkonto bei Ihrem ServiceNow-Tenant ({yourtenant}.service-now\.com) an.
  </Step>

  <Step title="Zu Users navigieren">
    Suchen Sie im **Filter navigator** nach **Benutzer**.
  </Step>

  <Step title="User Administration öffnen">
    Wählen Sie unter User Administration **Benutzer** aus.
  </Step>

  <Step title="Neuen Benutzer erstellen">
    Wählen Sie **New** aus, um einen neuen Benutzer hinzuzufügen.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Webdienstzugriff festlegen">
    Wählen Sie **Web service access only** aus.
  </Step>

  <Step title="Benutzererstellung absenden">
    Wählen Sie **Senden** aus.
  </Step>

  <Step title="Benutzerpasswort festlegen">
    Öffnen Sie den soeben erstellten Benutzer und wählen Sie dann **Set Password** aus.
  </Step>

  <Step title="Passwort generieren">
    Wählen Sie **Generieren** aus, um das neue Passwort zu erstellen.
  </Step>

  <Step title="Passwort kopieren">
    Kopieren Sie das neue Passwort.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Passwortdialog schließen">
    Wählen Sie **Schließen** aus, um zur Seite Users zurückzukehren.
  </Step>

  <Step title="Benutzerrollen öffnen">
    Wechseln Sie auf der Benutzerseite zu **Roles**.
  </Step>

  <Step title="Rollen bearbeiten">
    Wählen Sie **Bearbeiten** aus.
  </Step>

  <Step title="Erforderliche Rollen hinzufügen">
    Fügen Sie dem Dienstkontobenutzer die folgenden Rollen hinzu:

    * cmdb\_read
    * import\_transformer
    * rest\_api\_explorer
  </Step>

  <Step title="Rollenzuweisung überprüfen">
    Es sollten insgesamt sechs Rollen angezeigt werden: drei, die Sie direkt hinzugefügt haben, und drei geerbte.
  </Step>

  <Step title="Benutzerkonfiguration speichern">
    Wählen Sie **Speichern** aus, um die Benutzererstellung abzuschließen.
  </Step>
</Steps>

### Fehlerbehebung

#### Überprüfen, ob Kandji eine Discovery Source ist

<Steps>
  <Step title="Dictionary öffnen">
    Geben Sie in ServiceNow **Dictionary** in den **Filter navigator** ein.
  </Step>

  <Step title="Dictionary auswählen">
    Wählen Sie unter System Definition **Dictionary** aus.
  </Step>

  <Step title="Nach Discovery Source suchen">
    Wählen Sie in Dictionary Entries **Column name** aus und geben Sie dann **discovery\_source** ein.
  </Step>

  <Step title="CMDB-Tabelle auswählen">
    Wählen Sie die Tabelle **cmdb\_ci** aus.
  </Step>

  <Step title="Registerkarte Choices öffnen">
    Scrollen Sie nach unten und wählen Sie die Registerkarte **Choices** aus.
  </Step>

  <Step title="Kandji überprüfen">
    Vergewissern Sie sich, dass **Kandji** aufgeführt ist. Falls es nicht angezeigt wird, suchen Sie nach der Bezeichnung **Kandji**.
  </Step>
</Steps>

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

<Steps>
  <Step title="Fix Scripts öffnen">
    Geben Sie in ServiceNow **Fix Script** in den **Filter navigator** ein.
  </Step>

  <Step title="Fix Scripts auswählen">
    Wählen Sie unter System Definition **Fix Scripts** aus.
  </Step>

  <Step title="Nach Fix Script suchen">
    Wählen Sie in Fix Scripts **Name** aus und geben Sie dann **kandji\_fix\_script** ein.
  </Step>

  <Step title="Fix Script auswählen">
    Öffnen Sie den Datensatz **kandji\_fix\_script**.
  </Step>

  <Step title="Fix Script ausführen">
    Wählen Sie **Run Fix Script** aus.
  </Step>

  <Step title="Im Hintergrund ausführen">
    Wählen Sie im Dialog Run Fix Script **Proceed in Background** aus.
  </Step>
</Steps>

Kandji sollte nun als Discovery-Source-Auswahl in ServiceNow angezeigt werden.

## Überlegungen

<CardGroup cols={2}>
  <Card title="Dienstkonten" icon="user">
    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.
  </Card>

  <Card title="OAuth" icon="key">
    Setzen Sie unter **Zurich** und neueren Versionen die **Scope Restriction** auf **Broadly scoped**, wenn Sie die OAuth-App erstellen (siehe [Erstellen einer OAuth-App](#creating-an-oauth-app)). Legen Sie die Redirect-URL auf `https://kandji.io` fest und bewahren Sie die Client-Anmeldedaten sicher auf.
  </Card>

  <Card title="Rollen" icon="shield">
    Das Dienstkonto benötigt **cmdb\_read**, **import\_transformer** und **rest\_api\_explorer**.
  </Card>

  <Card title="Discovery Source" icon="magnifying-glass">
    Vergewissern Sie sich nach der Installation, dass **Kandji** im Dictionary unter den Discovery-Source-Auswahlmöglichkeiten für **cmdb\_ci** angezeigt wird.
  </Card>

  <Card title="Fehlerbehebung" icon="wrench">
    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.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="ServiceNow-Integration: Übersicht" icon="book-open" href="/de/endpoint/integrations/servicenow/servicenow-integration-overview">
    Wie Inventardaten von Iru Endpoint in ServiceNow-Tabellen und -Transformationen fließen und wie SAM Pro-Daten bei Aktivierung übertragen werden.
  </Card>

  <Card title="ServiceNow-Integration: Iru Endpoint-Konfiguration" icon="plug" href="/de/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration">
    Verbinden Sie Iru Endpoint mit Ihrer OAuth-App und Ihrem Dienstkonto, und verwalten Sie die Integration, sobald ServiceNow bereit ist.
  </Card>
</CardGroup>