> 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-en-es/herramientas-de-prevencion/ad-scan/setup-errors.md).

# Errores de configuración

Corrija los errores más comunes que imprime el script de análisis de Active Directory cuando falla.

## Lectura de la salida del script

La mayoría de los errores provienen de un punto final (estación de trabajo o servidor) que no cumple con los [requisitos previos](/help/help-center-en-es/herramientas-de-prevencion/ad-scan/setup.md#prerequisites). La salida del script indica cuál:

* El script ejecuta 10 comprobaciones numeradas e imprime `OK` o `NOK` para cada una, y luego un `Problemas obligatorios` resumen. La `NOK` línea suele indicar qué corregir.
* Si la ventana se cerró, abra el archivo de registro `C:\Temp\Stoik\Stoik_ADScan_<date>.log`. Se conserva cuando la ejecución falla.

## Solución de problemas

<details>

<summary>"Edad de descarga del script: NOK", "Token caducado" o "400 Bad Request"</summary>

El script tiene más de 24 horas (la comprobación 5 muestra su antigüedad en horas). Descargue uno nuevo desde Stoïk Protect.

</details>

<details>

<summary>"Unido al dominio: NOK"</summary>

La máquina no forma parte del dominio (un servidor en un grupo de trabajo, un portátil personal). Use una máquina unida al dominio.

Si no tiene ningún Active Directory local (solo Entra ID), el análisis de AD no se aplica: use el [análisis en la nube](/help/help-center-en-es/herramientas-de-prevencion/cloud-scan.md).

</details>

<details>

<summary>"No se pudo crear un canal seguro SSL/TLS"</summary>

La API de Stoïk solo acepta TLS 1.2 y 1.3 con cifrados recientes. Dos causas habituales:

* **Windows antiguo:** Windows Server 2012 y muchas máquinas con Windows Server 2016 no ofrecen estos cifrados. La solución más sencilla es ejecutar el script desde una máquina unida al dominio más reciente. No tiene por qué ser el controlador de dominio.
* **Inspección SSL** en su proxy o firewall: consulte [PingCastle no se puede descargar o el informe no se puede subir](#pingcastle-cannot-be-downloaded-or-the-report-cannot-be-uploaded).

En Windows Server 2016, también puede habilitar los cifrados desde un PowerShell abierto como administrador y luego ejecutar de nuevo el script:

```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>El script se cierra automáticamente después de ejecutarse</summary>

Esto significa que la ejecución de scripts está restringida en la terminal. Aquí tiene una solución en tres pasos:

1. Descargue el script y vaya a `Descargas`, luego escriba `powershell -ep bypass` en la barra de búsqueda:

   <figure><img src="https://1731397918-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. La consola de PowerShell debería abrirse automáticamente. Una vez abierta, escriba `& '.\` luego pulse Tab hasta que el archivo de script correcto sea visible:

   <figure><img src="https://1731397918-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. Pulse Enter.

</details>

<details>

<summary>PingCastle no se puede descargar o el informe no se puede subir</summary>

La máquina debe poder alcanzar los tres hosts enumerados en el [requisitos previos](/help/help-center-en-es/herramientas-de-prevencion/ad-scan/setup.md#prerequisites) a través de HTTPS, sin inspección SSL. Un proxy que inspecciona el tráfico HTTPS hacia los buckets S3 rompe el enlace de descarga, incluso cuando la conectividad DNS y TCP parecen correctas. Si eso ya está hecho:

* **El `PingCastle.exe` la descarga se queda bloqueada y luego falla con 403** (o se descarga el archivo de configuración pero no el `.exe`): un filtro web bloquea los archivos ejecutables. `PingCastle.exe` tiene unos 230 MB.
* **"Error al subir ad\_hc\_….xml"** (403 o "No se puede conectar"): el firewall bloquea las cargas al host de informes. Si solo la `.html` carga falló, los resultados aparecen pero el informe no se puede descargar.
* **La descarga en un navegador funciona, el script no:** el proxy trata el tráfico de PowerShell de forma diferente, normalmente por la inspección SSL.
* **Pasa a través de un proxy:** el script usa la configuración de proxy de Windows. Para forzar uno, ejecútelo con `-Proxy "http://proxy:8080"`.

Para probar desde la misma máquina, este comando debe responder `{"status":"ok"}`:

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

</details>

<details>

<summary>"PingCastle ha dejado de funcionar" o "No se encontraron archivos de informe"</summary>

PingCastle es una herramienta de auditoría de Active Directory, por lo que los antivirus suelen detectarla (por ejemplo como `Riskware.PingCastle`). Otros signos: PingCastle se detiene con un código de salida, o una comprobación menciona que el antivirus puede haber eliminado un archivo.

* Excluya el script, `PingCastle.exe` y la `C:\Temp\Stoik` carpeta, o pause el EDR durante el análisis.
* Si su EDR está gestionado por Stoïk MDR, contacte con <protect@stoik.io>.
* Para ayudar a Stoïk a investigar, ejecute de nuevo el script con `-PCDebug -KeepLog -NoDelete` y envíe los registros a <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-center-en-es/herramientas-de-prevencion/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.