> For the complete documentation index, see [llms.txt](https://docs.stoik.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoik.io/help/help-center-fr/outils-de-prevention/ad-scan/setup.md).
# Configuration
Téléchargez le script d’analyse AD depuis Stoïk Protect et exécutez-le dans PowerShell sur une machine jointe à votre domaine.
## Prérequis
* Version de Windows :
* Windows 10 ou version ultérieure sur un poste de travail
* Windows Server 2016 ou version ultérieure sur un serveur (les derniers correctifs de sécurité doivent être installés)
* Accès Internet : HTTPS sortant (port 443), sans inspection SSL, vers :
* `api.prod.ad-scan.cyber.stoik.io`
* `ad-scan-prod-pingcastle-zip.s3.eu-west-1.amazonaws.com`
* `ad-scan-prod-reports.s3.eu-west-1.amazonaws.com`
* Inscrit dans Active Directory et connecté au contrôleur de domaine
* Connecté à un compte administrateur de domaine
* Exécution de script non signé autorisée :
* Option A : `Set-ExecutionPolicy Unrestricted -Scope LocalMachine`
* Option B : ajoutez le fichier binaire à la liste d’exclusion dans Defender ou une solution similaire, puis exécutez `Set-ExecutionPolicy Bypass -Scope Process` et exécutez le script.
* Script téléchargé au cours des dernières 24 heures
* Dernière version de PowerShell installée, vérifiez avec : `$PSVersionTable.PSVersion`
## Exécution de l’analyse
{% stepper %}
{% step %}
### Ouvrez AD Scan
Cliquez sur `AD Scan`.
{% endstep %}
{% step %}
### Télécharger le script
Cliquez sur `Télécharger le script`.
{% hint style="info" %}
Si le script d’analyse AD ne se télécharge pas, vos paramètres de sécurité peuvent le bloquer. Vérifiez si le fichier apparaît dans l’onglet `Téléchargements` de votre explorateur de fichiers. Si le problème persiste, modifiez vos paramètres de sécurité pour autoriser les téléchargements.
{% endhint %}
{% endstep %}
{% step %}
### Exécutez le script
Exécutez le script dans une console PowerShell depuis un point de terminaison qui répond aux prérequis ci-dessus.
{% endstep %}
{% endstepper %}
## Nouvelle exécution de l’analyse
La mise à jour de l’analyse AD est manuelle : chaque nouvelle exécution doit être lancée manuellement. Le script téléchargé n’est valable que pendant 24 heures : passé ce délai, vous devez le télécharger à nouveau.
L’analyse peut être relancée autant de fois que nécessaire :
* En fonctionnement normal, nous recommandons de l’exécuter tous les mois.
* Pendant les phases de durcissement de la sécurité de l’infrastructure, elle peut être exécutée plus fréquemment afin de vérifier que les mauvaises configurations ont été corrigées.
Un script peut être exécuté sur plusieurs machines pendant ses 24 heures de validité, et en télécharger un nouveau n’annule pas le précédent. Chaque exécution remplace les résultats précédents pour le domaine analysé. Les nouveaux résultats apparaissent quelques secondes après la fin du script.
### Analyse automatique avec Stoïk MDR
Pour les clients Stoïk MDR sur CrowdStrike, Stoïk exécute le script une fois par mois via CrowdStrike, sur une machine que CrowdStrike identifie comme un contrôleur de domaine. La machine et la date ne peuvent pas être choisies. Le script s’exécute avec le compte propre du contrôleur de domaine, donc il voit tout ce qu’un Domain Admin voit. Pour les clients SentinelOne et Microsoft Defender, le script doit être exécuté manuellement.
`AD Scan` > `Paramètres` répertorie les exécutions automatiques et leur état. Une exécution échouée n’est pas retentée avant le mois suivant, mais vous pouvez exécuter le script manuellement à tout moment. La cause d’échec la plus fréquente est un contrôleur de domaine sous Windows Server 2016 ou plus ancien, voir ["Could not create SSL/TLS secure channel"](/help/help-center-fr/outils-de-prevention/ad-scan/setup-errors.md#could-not-create-ssl-tls-secure-channel). Pour arrêter les exécutions automatiques, contactez .
## Suppression des fichiers restants
Le script supprime ses fichiers lorsqu’il se termine. Si des fichiers sont laissés sur place (par exemple après une exécution avec `-KeepLog` ou `-NoDelete`), exécutez cette commande dans une fenêtre PowerShell ouverte en tant qu’administrateur, depuis le dossier où vous avez exécuté le script :
```powershell
Remove-Item -Recurse -Force -ErrorAction SilentlyContinue "C:\Temp\Stoik", ".\ad_hc_*"
```
## Dépannage
Si le script échoue, consultez [Erreurs de configuration](/help/help-center-fr/outils-de-prevention/ad-scan/setup-errors.md). Pour savoir ce que le script envoie à Stoïk et pourquoi il n’est pas signé, consultez [Questions fréquentes](/help/help-center-fr/outils-de-prevention/ad-scan/common-questions.md).
---
# 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.stoik.io/help/help-center-fr/outils-de-prevention/ad-scan/setup.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.
