Solución de problemas
Encuentra el mensaje que ves, lee la causa y aplica la solución.
| Lo que ves | Causa y solución |
|---|---|
SFTP connections require a managed xEvolve Agent | La conexión no tiene agente. Edítala, selecciona un agente instalado y vuelve a probar. Lo mismo ocurre con FTP, FTPS, SMB y NFS. |
El agente no se registra y la API responde workspace_not_ready | XEVOLVE_API_URL apunta a api.xevolve.io. Usa la dirección de tu espacio https://<workspace>.xevolve.io. |
| Probar agente sale en verde pero no hay señal de presencia | Probar agente no verifica el secreto. Compara AGENT_SECRET y XEVOLVE_API_TOKEN con el secreto de la guía. Si lo perdiste, crea un agente nuevo. |
La guía de despliegue del agente muestra <agent-secret> | El secreto solo se muestra una vez, al crear el agente. Crea un agente nuevo para obtener un secreto nuevo. |
403 API key missing required scope | Añade el ámbito que nombra el mensaje. Crea una clave nueva; los ámbitos de una clave existente no se pueden ampliar. |
| 403 al crear una clave | Una clave solo puede conceder los ámbitos que tiene. Usa una sesión de consola o una clave que tenga todos los ámbitos solicitados. |
| Una subida se rechaza con 422 | El análisis bloqueó el archivo. Consulta el registro de auditoría para ver el detalle del análisis. |
| Un enlace para compartir responde 410 | El enlace ha caducado o ha alcanzado su límite de descargas. Crea un enlace nuevo. |
Al explorar una carpeta SFTP aparece una ruta duplicada como /upload/upload | La conexión tiene a la vez una ruta y una ruta base. Deja solo una. |
| Un socio no puede importar una clave creada en xEvolve | GnuPG no lee el formato OpenPGP v6. Crea la clave con gpg e impórtala en xEvolve. |
| Un webhook ya no recibe eventos | Una entrega fallida se cuenta y no se reintenta. Corrige el receptor y envía un evento de prueba. |
Para cualquier otra cosa, escribe a hello@spot-suite.com e indica la dirección de tu espacio.