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

# ServiceNow Change Requests

> ServiceNow-Änderungsanforderungen nutzen, um Endgeräte-Detektionen, die mit geplanten Änderungen zusammenhängen, automatisch zu schließen.

## Funktionen dieser Integration

Wirespeed prüft bei der Triage von Endgeräten aktuelle ServiceNow-Änderungsanforderungen. Wenn eine eskalierende Endgeräte-Detektion mit einem verwalteten Administratorbenutzer und einem passenden Endgeräte-Hostnamen verknüpft ist, kann Wirespeed sie als `ENDPOINT__PLANNED_CHANGE` neu kategorisieren und automatisch schließen.

## Voraussetzungen

Stellen Sie vor dem Verbinden von ServiceNow sicher, dass Sie über Folgendes verfügen:

1. Eine Basis-URL, über die die ServiceNow Table API erreichbar ist
2. Einen API-Schlüssel, der im Request-Header `apikey` akzeptiert wird
3. Zugriff auf die Änderungstabelle, die Wirespeed abfragen soll (Standard ist `change_request`)
4. Änderungsanforderungen, bei denen:
   * `cmdb_ci.name` dem Endgeräte-Hostnamen in der Detektion entspricht
   * `assigned_to.email` der E-Mail-Adresse des verwalteten Administratorbenutzers in Wirespeed entspricht

## Wirespeed mit ServiceNow verbinden

1. Melden Sie sich bei Wirespeed an und navigieren Sie zu Integrationen > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Wählen Sie **ServiceNow** und klicken Sie auf **Integrieren**
3. Füllen Sie die folgenden Felder aus:
   * **Domain** – die vollständige Basis-URL Ihrer ServiceNow-Instanz, einschließlich eines ggf. erforderlichen Unterpfads (zum Beispiel `https://instance.service-now.com` oder `https://api.example.com/servicenow`)
   * **API-Schlüssel** – der Schlüssel, den Wirespeed im Header `apikey` sendet
   * **Tabellenname** – optional; Standard ist `change_request`
4. Klicken Sie auf **Speichern**

> [!NOTE]
>
> Benutzerdefinierte Tabellennamen dürfen nur Buchstaben, Ziffern und Unterstriche enthalten.

## So funktioniert der Abgleich

* Wirespeed führt die Suche nach geplanten Änderungen nur für eskalierende Endgerätebewertungen durch
* Die Detektion muss mindestens einen verwalteten Administratorbenutzer mit einem abfragbaren Bezeichner enthalten
* Wirespeed fragt ServiceNow mit Paaren aus `(hostname, admin email)` ab
* Es wird nach aktuellen Änderungsanforderungen der letzten 7 Tage gesucht
* Ist `start_date` leer, verwendet Wirespeed ersatzweise `sys_created_on`
* Die erste passende Änderungsanforderung wird verwendet, um die Detektion als geplante Änderung zu markieren

## Fehlerbehebung

* Wenn die Validierung fehlschlägt, prüfen Sie, ob die Basis-URL einen ggf. erforderlichen Unterpfad enthält und der Tabellenname gültig ist
* Wenn keine geplanten Änderungen gefunden werden, prüfen Sie, ob Endgeräte-Hostname und Administrator-E-Mail-Adresse mit den in der ServiceNow-Änderungsanforderung gespeicherten Werten übereinstimmen


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.