> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-fr/integrer-et-administrer/integrations/asset-discovery/armis.md).
# Armis
Connectez votre locataire Armis pour importer dans Dispel les actifs gérés et non gérés détectés, associer les sites Armis aux Wickets et synchroniser les données des appareils et les vulnérabilités détectées.
## Vue d’ensemble
L’intégration Armis permet à Dispel de récupérer les actifs qu’Armis a découverts dans votre environnement — qu’ils soient gérés ou non gérés — et de les intégrer en tant qu’appareils Dispel. Vous vous connectez une seule fois à votre locataire Armis, associez chaque site Armis à une installation Dispel et à un Wicket, puis Dispel importe les appareils correspondants et les tient à jour lors d’une synchronisation récurrente.
Armis est une **de découverte d’actifs** intégration cloud-native. Il n’y a pas d’appliance sur site — Dispel se connecte à votre locataire Armis dans le cloud et ne fait que lire à partir de celui-ci.
#### Ce que Dispel importe
* Actifs découverts (nom, adresse IP, adresse MAC, marque/modèle, système d’exploitation, type d’appareil) en tant qu’appareils Dispel.
* Protocoles et ports réseau observés pour chaque actif.
* Un lien de retour vers l’actif dans Armis, stocké sur l’appareil.
* **Résultats de vulnérabilités** pour chaque appareil importé, actualisés à chaque synchronisation.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez **Paramètres → Intégrations**. Armis apparaît dans le **section Découverte d’actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Armis pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants provenant de votre locataire Armis :
* Un **clé API** (clé secrète), créée dans votre console Armis dans vos paramètres API.
* Votre **URL du locataire Armis** — par exemple `https://acme.armis.com`.
{% hint style="warning" %}
**Ajoutez l’IP de Dispel à la liste d’autorisation.** Lorsque vous ouvrez le formulaire de connexion, Dispel affiche une **IP de la liste d’autorisation** valeur. Si votre locataire Armis restreint l’accès à l’API par adresse IP source, ajoutez cette adresse à la liste d’autorisation afin que Dispel puisse se connecter.
{% endhint %}
## Connexion à Armis
1. Accédez à **Paramètres → Intégrations** et cliquez sur **Connecter** sur la carte Armis.
2. Vous pouvez éventuellement définir un **nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plus d’un locataire Armis).
3. Renseignez les champs de connexion :
| Champ | Type | Notes |
| -------------------------- | ------------- | ----------------------------------------------------------------------------- |
| **URL du locataire Armis** | Configuration | L’URL de base de votre locataire Armis (p. ex. `https://acme.armis.com`). |
| **Clé API** | Identifiant | Votre clé API Armis (secrète). Stockée chiffrée et jamais affichée à nouveau. |
4. Cliquez sur **Tester la connexion** pour confirmer que Dispel peut s’authentifier auprès d’Armis. Corrigez toute erreur signalée avant d’enregistrer.
5. Cliquez sur **Enregistrer**. Dispel enregistre l’intégration et lance immédiatement la synchronisation initiale pour découvrir vos sites Armis.
{% hint style="info" %}
**Vos identifiants sont chiffrés.** La clé API est chiffrée au repos et n’est jamais réaffichée après l’enregistrement. Lors d’une modification ultérieure, laissez le champ d’identifiant vide pour conserver la valeur stockée.
{% endhint %}
## Association des sites aux Wickets
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **section Mappage des sites** section. Armis expose les sites configurés dans votre locataire, et c’est ici que vous décidez lesquels deviennent des appareils Dispel et où ils sont affectés.
> Associez chaque site du fournisseur à une installation Dispel et à un Wicket. Les appareils des sites mappés seront synchronisés dans Dispel.
Pour chaque site que vous souhaitez importer :
1. Choisissez un **site**.
2. Choisissez un **Wicket**. Si le site ne comporte qu’un seul Wicket, Dispel le sélectionne pour vous.
3. Cliquez sur **Enregistrer les mappages et importer**.
Dispel traite chaque site associé — vous verrez l’avancement de chaque site passer de en attente, à récupération, à synchronisation, puis à terminé — puis indique combien d’appareils ont été importés (par exemple, **« 12 appareils importés »** ou une répartition entre les appareils nouveaux et déjà importés). Les appareils importés apparaissent dans le Wicket mappé aux côtés de tous les appareils que vous avez ajoutés manuellement.
## Maintenir votre inventaire à jour
* Dispel **se resynchronise automatiquement** selon un calendrier récurrent, de sorte que les nouveaux actifs découverts et les détails modifiés soient pris en compte sans aucune action de votre part.
* Pour récupérer immédiatement le dernier inventaire, ouvrez l’intégration et choisissez **Actualiser**.
* Pour modifier les détails de connexion ou renouveler les identifiants, modifiez l’intégration et utilisez **Enregistrer et synchroniser**. Laissez le champ d’identifiant vide pour conserver la clé actuelle.
## Résultats de vulnérabilités
Armis signale les vulnérabilités connues pour les actifs qu’il surveille. Après chaque synchronisation réussie, Dispel récupère les résultats de vulnérabilités pour vos appareils importés et les associe à ces appareils, afin que vous puissiez voir les problèmes connus d’un appareil sans quitter Dispel. Les résultats sont actualisés à chaque synchronisation, et les résultats résolus disparaissent automatiquement.
## État de la connexion
Chaque intégration affiche un état afin que vous sachiez toujours où elle en est :
| État | Signification |
| ---------------------------- | --------------------------------------------------------------------------------------------------- |
| **Non initialisé** | Enregistré, mais la première synchronisation n’a pas encore été exécutée. |
| **Initialisation** | Exécution de la première synchronisation et découverte des sites. |
| **Prêt** | Connecté et synchronisé ; les associations sont appliquées. |
| **Doit être actualisé** | De nouvelles données du fournisseur sont disponibles ; lancez une actualisation pour les récupérer. |
| **Actualisation en cours** | Une synchronisation est en cours. |
| **Modifications en attente** | Les modifications de mappage sont enregistrées mais pas encore appliquées. |
| **Application en cours** | Importation des appareils pour vos associations enregistrées. |
| **Échec** | La dernière opération a échoué — consultez les indications d’erreur. |
Un **badge d’état** (Connecté, Dégradé, Injoignable) indique si Dispel peut actuellement joindre l’API Armis.
## Dépannage
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une solution :
| Erreur | Ce que cela signifie généralement et comment le corriger |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Échec de l’authentification** | La clé API a été rejetée. Elle a peut-être été renouvelée, expirée ou révoquée — générez-en une nouvelle et mettez à jour l’intégration. |
| **Point de terminaison inaccessible** | Dispel n’a pas pu atteindre l’API. Vérifiez l’URL du locataire et que l’adresse IP de Dispel figure dans la liste d’autorisation si votre locataire restreint l’accès à l’API. |
| **Délai de connexion dépassé** | Armis a mis trop de temps à répondre — généralement une latence réseau transitoire. |
| **Limitation de débit** | Armis a limité les requêtes. La prochaine synchronisation planifiée devrait réussir. |
| **Erreur de configuration** | L’URL du locataire semble incorrecte. Vérifiez qu’elle pointe bien vers votre locataire Armis. |
## Foire aux questions
Puis-je connecter plus d’un locataire Armis ?
Oui. Armis prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs locataires côte à côte. Donnez à chacun un **nom d’affichage** nom distinct pour les distinguer.
Existe-t-il une option sur site pour Armis ?
Non. Armis est une plateforme cloud, donc Dispel se connecte toujours à votre locataire Armis via Internet. Il n’y a aucun appliance vers lequel pointer.
La connexion à Armis change-t-elle quelque chose dans mon locataire Armis ?
Non. Dispel ne fait que lire depuis Armis. Il ne crée, ne modifie ni ne supprime jamais de données du côté d’Armis.
À quelle vitesse les nouveaux actifs apparaissent-ils ?
Les nouveaux actifs apparaissent lors de la prochaine synchronisation — automatiquement selon le calendrier récurrent, ou immédiatement si vous choisissez **Actualiser**.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-fr/integrer-et-administrer/integrations/asset-discovery/armis.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.