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

# Einrichtungsfehler

Beheben Sie die häufigsten Fehler, die vom Active-Directory-Scan-Skript ausgegeben werden, wenn es fehlschlägt.

## Die Skriptausgabe lesen

Die meisten Fehler stammen von einem Endpunkt (Workstation oder Server), der die [Voraussetzungen](/help/help-de/praventionstools/ad-scan/setup.md#prerequisites). Die Skriptausgabe sagt, welche:

* Das Skript führt 10 nummerierte Prüfungen aus und gibt `OK` oder `NOK` für jede aus, dann eine `Pflichtprobleme` Zusammenfassung. Die `NOK` Zeile sagt normalerweise, was zu beheben ist.
* Wenn sich das Fenster geschlossen hat, öffnen Sie die Protokolldatei `C:\Temp\Stoik\Stoik_ADScan_<date>.log`. Sie bleibt erhalten, wenn der Lauf fehlschlägt.

## Fehlerbehebung

<details>

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

Das Skript ist älter als 24 Stunden (Prüfung 5 zeigt sein Alter in Stunden an). Laden Sie ein neues von Stoïk Protect herunter.

</details>

<details>

<summary>„Mit der Domäne verbunden: NOK“</summary>

Der Rechner ist kein Mitglied der Domäne (ein Server in einer Arbeitsgruppe, ein privater Laptop). Verwenden Sie einen Domänenrechner.

Wenn Sie überhaupt kein lokales Active Directory haben (nur Entra ID), gilt der AD-Scan nicht: Verwenden Sie den [Cloud-Scan](/help/help-de/praventionstools/cloud-scan.md).

</details>

<details>

<summary>Konnte keinen sicheren SSL/TLS-Kanal erstellen</summary>

Die Stoïk-API akzeptiert nur TLS 1.2 und 1.3 mit aktuellen Cipher-Suites. Zwei häufige Ursachen:

* **Altes Windows:** Windows Server 2012 und viele Windows Server 2016-Computer bieten diese Cipher-Suites nicht an. Die einfachste Lösung besteht darin, das Skript von einem neueren, domänenverbundenen Computer aus auszuführen. Es muss nicht der Domänencontroller sein.
* **SSL-Inspektion** auf Ihrem Proxy oder Ihrer Firewall: siehe [PingCastle kann nicht heruntergeladen werden oder der Bericht kann nicht hochgeladen werden](#pingcastle-cannot-be-downloaded-or-the-report-cannot-be-uploaded).

Auf Windows Server 2016 können Sie die Cipher-Suites auch über eine als Administrator geöffnete PowerShell aktivieren und dann das Skript erneut ausführen:

```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>Das Skript schließt sich nach der Ausführung automatisch</summary>

Das bedeutet, dass die Skriptausführung auf dem Terminal eingeschränkt ist. Hier ist eine dreistufige Lösung:

1. Laden Sie das Skript herunter und gehen Sie zu `Downloads`, dann geben Sie `powershell -ep bypass` in die Suchleiste ein:

   <figure><img src="https://243136008-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. Die PowerShell-Konsole sollte sich automatisch öffnen. Sobald sie geöffnet ist, geben Sie `& '.\\` drücken Sie dann Tab, bis die richtige Skriptdatei sichtbar ist:

   <figure><img src="https://243136008-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. Drücken Sie die Eingabetaste.

</details>

<details>

<summary>PingCastle kann nicht heruntergeladen werden oder der Bericht kann nicht hochgeladen werden</summary>

Der Rechner muss die drei Hosts erreichen, die in der [Voraussetzungen](/help/help-de/praventionstools/ad-scan/setup.md#prerequisites) über HTTPS ohne SSL-Inspektion aufgeführt sind. Ein Proxy, der den HTTPS-Datenverkehr zu den S3-Buckets untersucht, unterbricht den Download-Link, selbst wenn DNS- und TCP-Konnektivität in Ordnung aussehen. Wenn das bereits erledigt ist:

* **Die `PingCastle.exe` der Download hängen bleibt und dann mit 403 fehlschlägt** (oder die Konfigurationsdatei heruntergeladen wird, aber nicht die `.exe`): Ein Webfilter blockiert ausführbare Dateien. `PingCastle.exe` hat ungefähr 230 MB.
* **„Upload für ad\_hc\_….xml fehlgeschlagen“** (403 oder "Verbindung nicht möglich"): Die Firewall blockiert Uploads zum Berichts-Host. Wenn nur der `.html` der Upload fehlgeschlagen ist, werden die Ergebnisse angezeigt, aber der Bericht kann nicht heruntergeladen werden.
* **Das Herunterladen im Browser funktioniert, das Skript jedoch nicht:** Der Proxy behandelt PowerShell-Datenverkehr anders, meist wegen SSL-Inspektion.
* **Sie gehen über einen Proxy:** das Skript verwendet die Windows-Proxy-Einstellungen. Um einen Proxy zu erzwingen, führen Sie es mit `-Proxy "http://proxy:8080"`.

Um dies von demselben Rechner aus zu testen, muss dieser Befehl antworten `{"status":"ok"}`:

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

</details>

<details>

<summary>„PingCastle funktioniert nicht mehr“ oder „Keine Berichtsdateien gefunden“</summary>

PingCastle ist ein Active-Directory-Prüftool, daher stufen Antivirenprogramme es oft als verdächtig ein (zum Beispiel als `Riskware.PingCastle`). Weitere Anzeichen: PingCastle beendet sich mit einem Exit-Code, oder eine Prüfung erwähnt, dass das Antivirenprogramm möglicherweise eine Datei gelöscht hat.

* Schließen Sie das Skript aus, `PingCastle.exe` und den `C:\Temp\Stoik` Ordner aus oder pausieren Sie das EDR während des Scans.
* Wenn Ihr EDR von Stoïk MDR verwaltet wird, kontaktieren Sie <protect@stoik.io>.
* Um Stoïk bei der Untersuchung zu helfen, führen Sie das Skript erneut mit `-PCDebug -KeepLog -NoDelete` und senden Sie die Protokolle an <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-de/praventionstools/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.