For the complete documentation index, see llms.txt. This page is also available as Markdown.

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. 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

"Script download age: NOK", "Token expired" of "400 Bad Request"

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

"Domain-joined: NOK"

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.

"Could not create SSL/TLS secure channel"

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.

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

"TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256" | ForEach-Object { Enable-TlsCipherSuite -Name $_ }
Het script sluit automatisch na uitvoering

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:

  2. De PowerShell-console zou automatisch moeten openen. Zodra die is geopend, typ & '.\ druk vervolgens op Tab totdat het juiste scriptbestand zichtbaar is:

  3. Druk op Enter.

PingCastle kan niet worden gedownload of het rapport kan niet worden geüpload

De machine moet de drie hosts kunnen bereiken die in de vereisten 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"}:

"PingCastle has stopped working" of "No report files found"

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.

Laatst bijgewerkt