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

> Utilisez les demandes de changement ServiceNow pour clôturer automatiquement les détections de terminaux liées à des changements planifiés.

## Fonctionnalités de cette intégration

Wirespeed consulte les demandes de changement ServiceNow récentes lors du triage des terminaux. Lorsqu’une détection de terminal en cours d’escalade est liée à un utilisateur administrateur géré et à un nom d’hôte de terminal correspondant, Wirespeed peut la recatégoriser en `ENDPOINT__PLANNED_CHANGE` et la clôturer automatiquement.

## Prérequis

Avant de connecter ServiceNow, assurez-vous de disposer des éléments suivants :

1. Une URL de base qui expose la Table API de ServiceNow
2. Une clé API acceptée dans l’en-tête de requête `apikey`
3. Un accès à la table des changements que Wirespeed doit interroger (par défaut `change_request`)
4. Des demandes de changement dans lesquelles :
   * `cmdb_ci.name` correspond au nom d’hôte du terminal de la détection
   * `assigned_to.email` correspond à l’adresse e-mail de l’utilisateur administrateur géré dans Wirespeed

## Connecter Wirespeed à ServiceNow

1. Connectez-vous à Wirespeed et accédez à Intégrations > [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Sélectionnez **ServiceNow** et cliquez sur **Intégrer**
3. Renseignez les champs suivants :
   * **Domaine** - l’URL de base complète de votre instance ServiceNow, y compris tout sous-chemin requis (par exemple `https://instance.service-now.com` ou `https://api.example.com/servicenow`)
   * **Clé API** - la clé que Wirespeed envoie dans l’en-tête `apikey`
   * **Nom de la table** - facultatif ; `change_request` par défaut
4. Cliquez sur **Enregistrer**

> [!NOTE]
>
> Les noms de table personnalisés ne doivent contenir que des lettres, des chiffres et des traits de soulignement.

## Fonctionnement de la correspondance

* Wirespeed ne recherche les changements planifiés que pour les verdicts de terminaux en cours d’escalade
* La détection doit inclure au moins un utilisateur administrateur géré disposant d’un identifiant interrogeable
* Wirespeed interroge ServiceNow à l’aide de paires `(hostname, admin email)`
* Il recherche les demandes de changement récentes des 7 derniers jours
* Si `start_date` est vide, Wirespeed utilise `sys_created_on` à la place
* La première demande de changement correspondante est utilisée pour marquer la détection comme changement planifié

## Dépannage

* Si la validation échoue, vérifiez que l’URL de base inclut tout sous-chemin requis et que le nom de la table est valide
* Si aucun changement planifié n’est trouvé, vérifiez que le nom d’hôte du terminal et l’adresse e-mail de l’administrateur correspondent aux valeurs enregistrées dans la demande de changement ServiceNow


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