> 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-nl/preventietools/ad-scan/setup-errors.md).

# Installatiefouten

Los de meest voorkomende fouten op die door het Active Directory-scan-script worden weergegeven wanneer het mislukt.

## De scriptuitvoer lezen

De meeste fouten komen van een endpoint (werkstation of server) dat niet voldoet aan de [vereisten](/help/help-nl/preventietools/ad-scan/setup.md#prerequisites). De scriptuitvoer geeft aan welke:

* Het script voert 10 genummerde controles uit en geeft `OK` of `NOK` voor elk, daarna een `Verplichte problemen` samenvatting. De `NOK` regel zegt meestal wat er moet worden opgelost.
* Als het venster is gesloten, open het logbestand `C:\Temp\Stoik\Stoik_ADScan_<date>.log`. Het wordt bewaard wanneer de uitvoering mislukt.

## Probleemoplossing

<details>

<summary>"Script download age: NOK", "Token expired" of "400 Bad Request"</summary>

Het script is ouder dan 24 uur (controle 5 toont de leeftijd in uren). Download een nieuwe van Stoïk Protect.

</details>

<details>

<summary>"Domain-joined: NOK"</summary>

De machine maakt geen deel uit van het domein (een server in een werkgroep, een persoonlijke laptop). Gebruik een machine die aan het domein is gekoppeld.

Als je helemaal geen on-premises Active Directory hebt (alleen Entra ID), is de AD-scan niet van toepassing: gebruik de [Cloudscan](/help/help-nl/preventietools/cloud-scan.md).

</details>

<details>

<summary>"Could not create SSL/TLS secure channel"</summary>

De Stoïk-API accepteert alleen TLS 1.2 en 1.3 met recente cipher suites. Twee veelvoorkomende oorzaken:

* **Oude Windows:** Windows Server 2012 en veel Windows Server 2016-machines bieden deze cipher suites niet aan. De eenvoudigste oplossing is om het script uit te voeren vanaf een recentere machine die aan het domein is gekoppeld. Dat hoeft niet de domeincontroller te zijn.
* **SSL-inspectie** op je proxy of firewall: zie [PingCastle kan niet worden gedownload of het rapport kan niet worden geüpload](#pingcastle-cannot-be-downloaded-or-the-report-cannot-be-uploaded).

Op Windows Server 2016 kun je de cipher suites ook inschakelen vanuit PowerShell dat als beheerder is geopend, en daarna het script opnieuw uitvoeren:

```powershell
"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256" | ForEach-Object { Enable-TlsCipherSuite -Name $_ }
```

</details>

<details>

<summary>Het script sluit automatisch na uitvoering</summary>

Dit betekent dat het uitvoeren van scripts beperkt is in de terminal. Hier is een oplossing in drie stappen:

1. Download het script en ga naar `Downloads`, en typ vervolgens `powershell -ep bypass` in de zoekbalk:

   <figure><img src="https://2067006134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FeQr2oHMVVuuNE3wGWQmA%2Fadscan-powershell-ep-bypass.png?alt=media&amp;token=acd7b9c4-f9e0-4b13-a1ce-d86c228bdff3" alt=""><figcaption></figcaption></figure>
2. De PowerShell-console zou automatisch moeten openen. Zodra die is geopend, typ `& '.\` druk vervolgens op Tab totdat het juiste scriptbestand zichtbaar is:

   <figure><img src="https://2067006134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2F5YiH2kagFiINDZVXSxnR%2FCapture%20d%E2%80%99e%CC%81cran%202026-07-03%20a%CC%80%2014.46.44.png?alt=media&amp;token=f7205bb2-f424-46c9-bec7-1088ab7906d1" alt=""><figcaption></figcaption></figure>
3. Druk op Enter.

</details>

<details>

<summary>PingCastle kan niet worden gedownload of het rapport kan niet worden geüpload</summary>

De machine moet de drie hosts kunnen bereiken die in de [vereisten](/help/help-nl/preventietools/ad-scan/setup.md#prerequisites) via HTTPS, zonder SSL-inspectie. Een proxy die HTTPS-verkeer naar de S3-buckets inspecteert, verbreekt de downloadlink, zelfs als DNS- en TCP-connectiviteit in orde lijken. Als dat al is gebeurd:

* **De `PingCastle.exe` de download blijft hangen en mislukt vervolgens met 403** (of het configuratiebestand wordt gedownload maar niet de `.exe`): een webfilter blokkeert uitvoerbare bestanden. `PingCastle.exe` is ongeveer 230 MB.
* **"Upload failed for ad\_hc\_….xml"** (403 of "Unable to connect"): de firewall blokkeert uploads naar de rapporthost. Als alleen de `.html` upload is mislukt, worden de resultaten wel weergegeven maar kan het rapport niet worden gedownload.
* **Downloaden in een browser werkt, het script niet:** de proxy behandelt PowerShell-verkeer anders, meestal vanwege SSL-inspectie.
* **Je gebruikt een proxy:** het script gebruikt de proxy-instellingen van Windows. Om er een af te dwingen, voer je het uit met `-Proxy "http://proxy:8080"`.

Om vanaf dezelfde machine te testen, moet dit commando antwoorden met `{"status":"ok"}`:

```powershell
Invoke-WebRequest https://api.prod.ad-scan.cyber.stoik.io/v1/public/health
```

</details>

<details>

<summary>"PingCastle has stopped working" of "No report files found"</summary>

PingCastle is een Active Directory-audittool, dus antivirussen markeren het vaak (bijvoorbeeld als `Riskware.PingCastle`). Andere signalen: PingCastle stopt met een exitcode, of een controle vermeldt dat de antivirus mogelijk een bestand heeft verwijderd.

* Sluit het script uit, `PingCastle.exe` en de `C:\Temp\Stoik` map uit, of pauzeer de EDR tijdens de scan.
* Als je EDR wordt beheerd door Stoïk MDR, neem contact op met <protect@stoik.io>.
* Om Stoïk te helpen onderzoeken, voer je het script opnieuw uit met `-PCDebug -KeepLog -NoDelete` en stuur de logs naar <protect@stoik.io>.

</details>


---

# 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-nl/preventietools/ad-scan/setup-errors.md?ask=<question>&goal=<user_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.