> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/integrations/servicenow.md). # ServiceNow Intégration ServiceNow pour synchroniser les actifs (assets) dans Dastra ### Qu'est ce que c'est ServiceNow ? L’intégration [ServiceNow](https://www.servicenow.com/) permet de **synchroniser automatiquement les applications métiers** issus du CMDB de ServiceNow directement dans Dastra. Elle permet : * d’éviter la double saisie ; * de centraliser les actifs techniques utilisés dans toute l’organisation; * d’utiliser ces actifs dans vos **registres de traitement**, **jeux de données**, **analyses d’impact**, **analyses de risques**, **audits**, etc. * de garantir que les informations issues de ServiceNow restent **à jour** dans Dastra. ### Prérequis * **Avoir une licence payante Dastra** incluant l’accès au module Intégrations / connecteurs. * **Avoir une instance ServiceNow** (ex. `https://votre-instance.service-now.com`) qui permet l’**appel API REST** depuis l’extérieur, et selon la méthode d’authentification : * **OAuth 2.0 (recommandé)** — la possibilité d’enregistrer une application OAuth dans votre instance, * **Basic** — un compte de service disposant des droits de lecture sur `cmdb_ci_business_app`. ### Installation Le processus de mise en place suit le parcours commun des intégrations (voir [Connexions, cas d'usage et mapping des champs](/features/integrations/connexions-et-mapping-des-champs.md)) : 1. Accédez à la page de l’intégration **ServiceNow** dans la marketplace d’intégrations Dastra.\ Exemple :\ `https://app.dastra.eu/workspace/0/settings/integrations/servicenow` 2. Sur le cas d’usage d’import des actifs, cliquez sur **Ajouter l'intégration**. 3. Ajoutez une connexion et choisissez la **Méthode d'authentification** (voir ci-dessous). 4. Complétez l’étape de **Configuration**. Elle est **obligatoire** pour finaliser l’installation.

Création de la connexion ServiceNow

### Méthodes d'authentification **OAuth 2.0 (recommandé)** — Dastra ne stocke jamais de mot de passe ; ServiceNow émet des jetons à durée de vie courte que Dastra renouvelle automatiquement. 1. Dans ServiceNow, créez une app OAuth pour Dastra : **All > Application Registry** (sur les versions récentes : *Inbound integrations > Authorization code grant*), type *OAuth API endpoint for external clients*. 2. Renseignez l’URL de redirection : `https://api.dastra.eu/v1/integrationaccounts/callback/servicenow` 3. Vérifiez que la restriction de scope de l’app est **Broadly scoped** (ou déclarez le scope `useraccount`) : une app *securely scoped* sans scopes refusera l’échange de jetons. 4. Dans Dastra, créez la connexion avec la méthode **OAuth**, saisissez l’**URL de l'instance**, le **Client ID OAuth** et le **Client secret OAuth**, puis cliquez sur **Enregistrer et se connecter** et autorisez Dastra dans ServiceNow. **Authentification Basic** — identifiant/mot de passe d’un compte ServiceNow, stockés chiffrés par Dastra. {% hint style="warning" %} Les instances ServiceNow récentes restreignent l’authentification Basic sur l’API REST au niveau du compte. Si vous utilisez Basic, créez un **compte de service dédié avec « Web service access only » coché** — jamais un compte nominatif ni un compte admin. Symptôme de la restriction : une réponse `401 User is not authenticated` malgré des identifiants valides. {% endhint %} ### Configuration * Sélectionnez les **utilisateurs à notifier en cas d'erreur** (obligatoire). Ils recevront un email de notification en cas d’échec de synchronisation, contenant les informations sur les actifs qui ont été mis à jour. * **Créer l'enregistrement Dastra s'il n'existe pas** — activé, un actif est créé s’il n’existe pas dans Dastra, en se basant sur la référence externe. * **Dédoublonner les éléments synchronisés** — fait correspondre les applications entrantes aux actifs existants via un **Champ de correspondance** (**Label** ou **Référence**) pour les mettre à jour au lieu de créer des doublons. * **Mapping des champs** — choisissez quel champ ServiceNow (de `cmdb_ci_business_app`) alimente chaque champ Dastra. Les listes de choix sont lues en direct depuis le dictionnaire de données de votre instance : leurs valeurs peuvent donc être transcodées en valeurs Dastra. Voir [Connexions, cas d'usage et mapping des champs](/features/integrations/connexions-et-mapping-des-champs.md). {% hint style="info" %} Attention : si vous activez l’option de création, un grand nombre d’actifs seront automatiquement créés dans votre espace de travail. Veillez à bien renseigner les références externes. {% endhint %}

La configuration ServiceNow : options et mapping des champs

### Comment sont synchronisées les données entre Dastra et ServiceNow ? La synchronisation s’exécute automatiquement **une fois par jour**, et peut être déclenchée à tout moment avec **Lancer la synchronisation** sur la carte du cas d’usage. Lors de chaque synchronisation, les champs issus de ServiceNow sont mappés dans votre référentiel d’actifs Dastra. Par défaut, les informations suivantes sont récupérées et mises à jour : * **Label** de l’actif * **Description** (Short Description ServiceNow) * **Type d’application** * **État / statut d’installation** * **Type d’actif** (systématiquement importé comme *Software*) * **Zone / domaine** associé (AreaId) * **Tags** associés * **Identifiant externe** ServiceNow (`sys_id`) * **Source externe** (`ServiceNow`) * **Date de dernière synchronisation** * **Propriétaire** de l’actif Chacun de ces comportements par défaut peut être remplacé champ par champ dans l’éditeur de **Mapping des champs**. Toutes ces données permettent de maintenir un lien fiable et à jour entre votre CMDB ServiceNow et votre référentiel Dastra. #### Gestion des actifs supprimés côté ServiceNow Lorsque Dastra détecte qu’un actif précédemment synchronisé **n’existe plus dans ServiceNow**, il **n’est pas supprimé automatiquement** dans Dastra.\ À la place, Dastra ajoute **un tag automatique** (`To-delete-servicenow`) sur l’actif indiquant qu’il est *supprimé dans ServiceNow*. Si l’application réapparaît plus tard dans ServiceNow, le tag est retiré automatiquement. Ce comportement permet : * de conserver l’historique dans Dastra, * d’éviter les suppressions involontaires, * de faciliter la revue manuelle des actifs obsolètes. Lorsque le dédoublonnage trouve **plusieurs** actifs correspondant à une même application entrante, les candidats sont marqués `To-merge-servicenow` pour une décision de fusion manuelle. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.dastra.eu/features/integrations/servicenow.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.