> ## 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: Übersicht

> Synchronisieren Sie das Apple-Geräteinventar in Echtzeit über OAuth 2.0 von Iru Endpoint zu ServiceNow, mit optionaler nächtlicher Synchronisierung von App-Daten für SAM Pro-Tenants.

### Über die ServiceNow-Integration

Die ServiceNow-Integration überträgt das Apple-Geräteinventar in Echtzeit von Iru Endpoint zu ServiceNow, damit Ihre ServiceNow-Datensätze stets aktuell bleiben.

Wenn Ihr ServiceNow-Tenant für Software Asset Management Professional (SAM Pro) lizenziert ist, können Sie außerdem nächtlich Daten zur Installation und Nutzung von Anwendungen senden.

### Funktionsweise

Die Integration verbindet Iru Endpoint über OAuth 2.0 mit einem dedizierten Dienstkonto mit Ihrer ServiceNow-Instanz.

**Authentifizierung**: OAuth 2.0 mit einem Dienstkonto in ServiceNow.

**Datensynchronisierung**: Iru Endpoint erkennt verwaltete Apple-Geräte und synchronisiert Felder wie Seriennummer, Modell, OS-Version und zugewiesenen Benutzer mit ServiceNow. Mit SAM Pro können Sie außerdem nächtlich Anwendungsinventar- und Nutzungsdaten senden.

### Einrichtung im Überblick

Befolgen Sie diese Schritte im Überblick.

<Steps>
  <Step title="ServiceNow-App installieren">
    Installieren Sie die [Kandji ServiceNow-App](https://store.servicenow.com/sn_appstore_store.do#!/store/application/e330778897bfe150f89bf7021153af52/1.0.0?referer=%2Fstore%2Fsearch%3Flistingtype%3Dallintegrations%25253Bancillary_app%25253Bcertified_apps%25253Bcontent%25253Bindustry_solution%25253Boem%25253Butility%25253Btemplate%25253Bgenerative_ai%25253Bsnow_solution%26q%3Dkandji\&sl=sh) im ServiceNow Integration Hub.
  </Step>

  <Step title="OAuth-Client konfigurieren">
    Konfigurieren Sie eine OAuth-Client-App, damit Iru Endpoint die ServiceNow Import Set API aufrufen kann.
  </Step>

  <Step title="ServiceNow-Benutzer erstellen">
    Erstellen Sie ein ServiceNow-Benutzerkonto, das auf die ServiceNow API zugreifen kann.
  </Step>

  <Step title="Integration in Iru Endpoint einrichten">
    Schließen Sie in Iru Endpoint die ServiceNow-Integration mit der erstellten OAuth-App und dem Dienstkonto ab.
  </Step>
</Steps>

Nach Abschluss der Einrichtung beginnt Iru Endpoint, Geräte-Asset-Daten an ServiceNow zu übertragen.

<Warning>
  Der zugewiesene Benutzer aus Iru Endpoint muss bereits in ServiceNow vorhanden sein, damit dieser Benutzer im Computer-Datensatz angezeigt wird.
</Warning>

### Datenfluss im Überblick

Wenn sich ein Gerät in Iru Endpoint registriert oder sich sein Datensatz ändert, führt die Integration Folgendes aus:

<Steps>
  <Step title="Änderungen erkennen">
    Iru Endpoint erkennt Änderungen am Geräteinventar. Wenn Sie die SAM Pro-App-Synchronisierung in Iru Endpoint aktiviert haben, werden App-Inventar und -Nutzung nächtlich vorbereitet.
  </Step>

  <Step title="An Staging-Tabellen übertragen">
    Iru Endpoint überträgt diese Änderungen über die ServiceNow Import Set API an ServiceNow-Staging-Tabellen.
  </Step>

  <Step title="Daten transformieren">
    Für Gerätedaten führt ServiceNow eine [Transform Map](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/c_CreatingNewTransformMaps.html) aus, um Staging-Spalten Zieltabellen zuzuordnen. Anwendungsdaten verwenden eine [ETL-Definition](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/etl-definition-overview.html) mit der [Robust Transform Engine](https://www.servicenow.com/docs/r/zurich/integrate-applications/system-import-sets/define-rte-operations.html).
  </Step>

  <Step title="Datensätze aktualisieren">
    ServiceNow erstellt oder aktualisiert dann Geräte- und MDM-Datensätze und kann außerdem Software-Installations- und Nutzungsdatensätze aktualisieren, wenn die SAM Pro-Datensynchronisierung aktiviert ist.
  </Step>
</Steps>

```mermaid actions={false} theme={null}
%%{init: {'theme': 'base', 'themeVariables': { 'lineColor': '#8b93a6', 'primaryTextColor': '#1f2937', 'fontSize': '13px'}}}%%
flowchart TD
    A["Iru Endpoint (extern)<br/>API / Export / Integration"] --> B["ServiceNow - Staging<br/>Import Set: MDM"]
    A --> C["ServiceNow - Staging<br/>Import Set: Computer"]
    A --> D["ServiceNow - Staging<br/>Import Set: Apps"]

    B --> E["MDM-Pfad<br/>Transform: Iru Endpoint MDM Transformer"]
    E --> F["x_kandj_kandji_mdm"]

    C --> G["Computer-Pfad<br/>Transform: Iru Endpoint CI Transformer"]
    G --> H["CMDB IRE<br/>discovery_source = Kandji"]
    H --> I["cmdb_ci_computer"]

    D --> J["Apps-Pfad: RTE dann ETL<br/>Iru Endpoint Apps RTE"]
    J --> K["Iru Endpoint Apps ETL"]
    K --> L["ETL: Import"]
    L --> M["ETL: Temp"]
    M --> N["cmdb_sam_sw_install"]

    N --> O["SAM-Nutzung<br/>Geplant: Software Usage Publisher"]
    O --> P["samp_sw_usage"]

    I -. "CI-Auflösung für Installationen" .-> J

    classDef source fill:#eef6ff,stroke:#3b82f6,stroke-width:1.5px,color:#1f2937;
    classDef mdm fill:#f5f3ff,stroke:#8b5cf6,stroke-width:1.5px,color:#1f2937;
    classDef computer fill:#ecfdf5,stroke:#10b981,stroke-width:1.5px,color:#1f2937;
    classDef apps fill:#fff7ed,stroke:#f97316,stroke-width:1.5px,color:#1f2937;
    classDef usage fill:#fef9c3,stroke:#ca8a04,stroke-width:1.5px,color:#1f2937;

    class A source;
    class B,E,F mdm;
    class C,G,H,I computer;
    class D,J,K,L,M,N apps;
    class O,P usage;
```

### ServiceNow-Tabellen

Die folgenden Tabellen werden in der Iru Endpoint-Integration mit ServiceNow verwendet.

| <Icon icon="list-check" size={14} /> **Tabelle** | <Icon icon="circle-info" size={14} /> **Beschreibung** |
| - | - |
| `cmdb_ci_computer` | Integrierte ServiceNow-Tabelle mit Hardwaredetails für Mac-, iPhone-, iPad- und tvOS-Geräte. |
| `cmdb_sam_sw_install` | ServiceNow SAM Pro-Tabelle zur Erfassung von Software-Installationen, wenn die Synchronisierung von App-Inventar und -Nutzung in Iru Endpoint aktiviert ist. |
| `samp_sw_usage` | ServiceNow SAM Pro-Nutzungstabelle, die von einem nächtlichen Usage-Publisher-Job in ServiceNow befüllt wird. |
| `x_kandj_kandji_mdm` | Von Iru Endpoint erstellte benutzerdefinierte Tabelle zum Speichern zusätzlicher MDM-bezogener Daten zu Geräte-Assets. |
| `x_kandj_kandji_kandji_import_set_computer` | Import-Set-Staging-Tabelle, in der Geräte-Asset-Informationen bereitgestellt werden, bevor sie in die Tabelle `cmdb_ci_computer` übertragen werden. |
| `x_kandj_kandji_kandji_import_set_mdm` | Import-Set-Staging-Tabelle, in der MDM-bezogene Geräte-Asset-Informationen bereitgestellt werden, bevor sie in die Tabelle `x_kandj_kandji_mdm` übertragen werden. |
| `x_kandj_kandji_kandji_import_set_apps` | Import-Set-Staging-Tabelle, in der Anwendungsinventar- und Nutzungsinformationen vor der RTE/ETL-Verarbeitung bereitgestellt werden. |

### Geräteattribute in Iru Endpoint

Iru Endpoint sendet die unten aufgeführten Geräte-Asset-Felder. Im Laufe der Zeit können weitere Felder hinzukommen.

#### Tabelle: `cmdb_ci_computer`

| <Icon icon="tag" size={14} /> **Iru Endpoint** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Beschreibung** |
| - | - | - |
| `assigned_user` | `assigned_to` | Dem Geräte-Asset zugewiesener Benutzer |
| `device_capacity` | `disk_space` | Gesamte Speicherkapazität |
| `device_name` | `name` | Name des Geräts |
| `Discovery source` (in Iru nicht angezeigt) | `discovery_source` | Konstanter Wert "Kandji" |
| `model_name` | `model` | Modellname des Geräts |
| `os_type` | `os` | Name des Betriebssystems (zum Beispiel macOS, iOS, iPadOS oder tvOS) |
| `os_version` | `os_version` | Version des Betriebssystems |
| `serial_number` | `serial_number` | Seriennummer des Geräts; dient außerdem als Coalesce-Feld für den Datensatz in der Computer-Tabelle in ServiceNow |
| `manufacturer` | `manufacturer` | Konstanter Wert "Apple" |

#### Tabelle: `x_kandj_kandji_mdm`

| <Icon icon="tag" size={14} /> **Iru Endpoint** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Beschreibung** |
| - | - | - |
| `device_id` | `kandji_device_id` | Geräte-ID in Iru Endpoint |
| `blueprint_id` | `kandji_blueprint_id` | Blueprint-ID in Iru Endpoint; dient außerdem als Coalesce-Feld für den Datensatz in der MDM-Tabelle in ServiceNow. |
| `serial_number` | `computer` | Verweist auf den CI-Computer-Datensatz in ServiceNow. |
| `Discovery source` (in Iru nicht angezeigt) | `discovery_source` | Konstanter Wert "Kandji" |

#### Tabelle: `cmdb_sam_sw_install`

| <Icon icon="tag" size={14} /> **Iru Endpoint (Prism)** | <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Beschreibung** |
| - | - | - |
| `App ID` (in Iru nicht angezeigt) | `instance_key` | Ein eindeutiger Schlüssel zur Identifizierung einer Software auf einem bestimmten Gerät |
| `name` | `name` | Der Name der App |
| `developer_name` | `publisher` | Der Entwickler der Software |
| `version` | `version` | Version der Software |
| `path` | `install_location` | Installationspfad auf dem Gerät |
| `serial_number` | `installed_on` | Verweis auf den Computer-CI-Datensatz |
| `last_opened` | `last_used` | Das Datum, an dem die Software zuletzt verwendet wurde |
| `is_removed` (entfernte Apps werden in Iru nicht angezeigt) | `active` | **Aktive Installation** in `cmdb_sam_sw_install`: `true`, solange sich die App auf dem Gerät befindet; `false`, wenn Iru die Entfernung meldet. Entfernte Apps werden weiterhin mit `active` = `false` synchronisiert, sodass ServiceNow die Installationszeile für den Verlauf behält (siehe [Anwendungsinventar](#application-inventory)). |
| `Discovery source` (in Iru nicht angezeigt) | `discovery_source` | Konstanter Wert "Kandji" |

#### Tabelle: `samp_sw_usage`

| <Icon icon="list-check" size={14} /> **ServiceNow** | <Icon icon="circle-info" size={14} /> **Beschreibung** |
| - | - |
| `configuration_item` | Verweis auf den Computer-CI-Datensatz |
| `norm_product` | Der normalisierte Datensatz der App aus ServiceNow |
| `reclamation_type` | `'last_used'`. Iru befüllt `last_used`-Einträge. |
| `last_used_time` | Datum und Uhrzeit der letzten Verwendung der Software. Iru sendet hier nur Datumsangaben, um zusätzliche benutzerdefinierte Tabellen in ServiceNow zu vermeiden. |

### Anwendungsinventar

<Note>
  Wenn das Anwendungsinventar aktiviert ist, sendet Iru Endpoint entfernte Apps weiterhin mit `active` auf `false` gesetzt an ServiceNow. ServiceNow behält diese Installationszeilen für den Verlauf, anstatt sie zu löschen, wenn die App vom Gerät entfernt wird.
</Note>

## Überlegungen

<CardGroup cols={2}>
  <Card title="Zugewiesene Benutzer in ServiceNow" icon="user">
    Damit der Computer-Datensatz in ServiceNow den in Iru Endpoint zugewiesenen Benutzer anzeigt, muss diese Person bereits in ServiceNow vorhanden sein.
  </Card>

  <Card title="Synchronisierung des Geräteinventars" icon="arrows-rotate">
    Das Geräteinventar wird in Echtzeit synchronisiert. App-Inventar- und Nutzungsdaten werden nächtlich synchronisiert, wenn diese Option aktiviert ist.
  </Card>

  <Card title="Anwendungsinventar" icon="layer-group">
    SAM Pro muss in ServiceNow lizenziert sein, und Sie müssen die Option in den Einstellungen der Iru Endpoint-Integration aktivieren. Entfernte Apps werden weiterhin mit `active` = `false` synchronisiert, sodass ServiceNow historische Installationszeilen behält, anstatt sie zu löschen.
  </Card>

  <Card title="Ablauf von Anmeldedaten und erneute Authentifizierung" icon="bell">
    Wenn die OAuth-Anmeldedaten für ServiceNow bald ablaufen, zeigt Iru Endpoint ab 30 Tagen vor Ablauf ein Banner im Tenant an und sendet E-Mail-Erinnerungen an Team Members mit Admin- oder Account Owner-Berechtigungen. Authentifizieren Sie sich erneut über die [Detailseite der ServiceNow-Integration](/de/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration#reauthentication) in Iru Endpoint.
  </Card>

  <Card title="Tabellen in ServiceNow" icon="table">
    Die Integration schreibt in integrierte ServiceNow-Tabellen und benutzerdefinierte Kandji-Tabellen, damit CMDB- und MDM-Ansichten vollständig bleiben.
  </Card>

  <Card title="Import Set API" icon="plug">
    Daten werden über die Import Set API und Transform-Abläufe von ServiceNow übertragen.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="ServiceNow-Integration: ServiceNow-Konfiguration" icon="wrench" href="/de/endpoint/integrations/servicenow/servicenow-integration-servicenow-configuration">
    Installieren Sie die Kandji ServiceNow-App, erstellen Sie einen OAuth-Client und ein Dienstkonto, und überprüfen Sie die Discovery Source in ServiceNow.
  </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 Ihrem Tenant, geben Sie OAuth- und Dienstkonto-Anmeldedaten ein, und aktivieren Sie optional das nächtliche App-Inventar und die Nutzung für SAM Pro.
  </Card>
</CardGroup>