Solución de algunos errores comunes

Last published : Oct 24, 2026
Este tema enumera algunos de los errores que puede encontrar al configurar Secure Private Access.
Errores de certificado
Errores de creación de base de datos
Fallos de StoreFront
Fallos de la puerta de enlace pública/de devolución de llamada
Servidor de Secure Private Access no accesible

Errores de certificado

Mensaje de error: No se pueden obtener los certificados automáticamente de uno o varios servidores Gateway.
Este mensaje de error aparece cuando intenta agregar una dirección de NetScaler® Gateway pública y hay un problema al obtener el certificado. Este problema puede ocurrir al configurar Secure Private Access o al actualizar la configuración una vez completada la configuración.
Solución alternativa: Actualice el certificado de la puerta de enlace de la misma manera que lo haría para Citrix Virtual Apps and Desktops.

Errores de creación de base de datos

  • Mensaje de error: Error al crear la base de datos
    Resolución: Para el caso automático: la máquina debe tener permisos de LECTURA, ESCRITURA y ACTUALIZACIÓN para crear tablas dentro de la base de datos en el servidor SQL.
  • Mensaje de error: Error al crear la base de datos: Ya existe una base de datos.
    Este mensaje de error puede aparecer en cualquiera de los siguientes escenarios.
    • Si se selecciona la opción Configuración automática al configurar las bases de datos.
    • Si el administrador está creando una base de datos, debe ser una base de datos vacía. Este mensaje de error puede aparecer si la base de datos no está vacía.
      Resolución: Debe crear una base de datos vacía.
    • Desinstala Secure Private Access y vuelve a intentar la configuración con el mismo nombre de sitio. En este caso, la base de datos de la instalación anterior no se habría eliminado.
      Resolución: Debe eliminar la base de datos manualmente.
    • Elige configurar la base de datos manualmente (seleccionando Configuración manual en la página Configuración de bases de datos) mediante el script y, a continuación, cambia a la opción Configuración automática, pero utiliza el mismo nombre de sitio. En este caso, ya se ha creado una base de datos con el mismo nombre al ejecutar el script.
      Resolución: Debe cambiar el nombre del sitio y, a continuación, volver a ejecutar el script.
    • La máquina no tiene los permisos de LECTURA, ESCRITURA, ACTUALIZACIÓN para crear tablas dentro de la base de datos en el servidor SQL.
      Resolución: Habilite los permisos adecuados en la máquina. Para obtener más información, consulte Permisos necesarios para configurar bases de datos.
  • Mensaje de error: Error al crear la base de datos: Conexión fallida
    Resolución:
    • Compruebe la conectividad de red de la base de datos desde su máquina. Asegúrese de que el puerto del servidor SQL esté abierto en el firewall.
    • Si utiliza un servidor SQL remoto, compruebe si el servidor SQL tiene un inicio de sesión creado con la identidad de la máquina de Secure Private Access, Dominio\nombredehost$.
    • Si utiliza un servidor SQL remoto, confirme que la identidad de la máquina tiene asignado el rol correcto, el rol de administrador del sistema.
    • Si utiliza un servidor SQL local (no desde el instalador), compruebe si el usuario NT AUTHORITY\SYSTEM debe tener un inicio de sesión creado.

Fallos de StoreFront™

  • Mensaje de error: No se pudo crear la entrada de StoreFront para: <Store URL>
    Actualice las entradas de StoreFront desde la pestaña Configuración si no están visibles. Después de configurar Secure Private Access mediante el asistente, puede editar las entradas de StoreFront desde la pestaña Configuración. Anote la URL de la tienda de StoreFront para la que se produjo este error.
    Resolución:
    1. Haga clic en Configuración y, a continuación, en la pestaña Integraciones.
    2. En URL de la tienda de StoreFront, añada la entrada de StoreFront si no está visible.
  • Mensaje de error: No se pudo configurar la entrada de StoreFront para: <Store URL>
    Resolución:
    1. Puede que exista una restricción de la política de ejecución de PowerShell. Ejecute el comando del script de PowerShell Get-ExecutionPolicy para obtener más detalles.
    2. Si está restringido, debe omitirlo y ejecutar un script de configuración de StoreFront manualmente.
    3. Haga clic en Configuración y, a continuación, en la pestaña Integraciones.
    4. En URL de la tienda de StoreFront, identifique la entrada de URL de StoreFront para la que se produjo el error.
    5. Haga clic en el botón Descargar script junto a esta URL de tienda y ejecute este script de PowerShell con privilegios de administrador en la máquina en la que esté presente la instalación de StoreFront correspondiente. Este script debe ejecutarse en todas las máquinas de StoreFront.
    Nota:
    Si está reintentando la instalación después de desinstalar, asegúrese de no tener una entrada con el nombre "Secure Private Access" en la configuración de StoreFront (StoreFront > store> Delivery Controller™ -> Secure Private Access). Si Secure Private Access está presente, elimine esta entrada. Descargue y ejecute manualmente el script desde la página Configuración > Integraciones.
  • Mensaje de error: La configuración de StoreFront no es local para: <Store URL>
    Después de haber configurado Secure Private Access mediante el asistente, puede editar las entradas de la puerta de enlace desde la ficha Configuración. Anote la URL de la tienda de StoreFront para la que se produjo este error.
    Resolución:
    Este problema ocurre si StoreFront no está instalado en la misma máquina que Secure Private Access. Debe ejecutar manualmente la configuración de StoreFront en la máquina donde haya instalado StoreFront.
    1. Haga clic en Configuración y, a continuación, en la ficha Integraciones.
    2. En URL de la tienda de StoreFront, identifique la entrada de URL de StoreFront para la que se produjo el error.
    3. Haga clic en el botón Descargar script junto a esta URL de la tienda y ejecute este script de PowerShell con privilegios de administrador en la máquina en la que está presente la instalación de StoreFront correspondiente. Este script debe ejecutarse en todas las máquinas de StoreFront.
    Nota:
    Para ejecutar el script de PowerShell de StoreFront, abra la ventana de PowerShell compatible con Windows x64 con privilegios de administrador y, a continuación, ejecute ConfigureStorefront.ps1. El script de StoreFront no es compatible con Windows PowerShell (x86).
  • Mensaje de error: "Get-STFStoreService : Exception of type 'Citrix.DeliveryServices.Framework.Feature.Exceptions.RegistryKeyNotFoundException' was thrown." al ejecutar el script de StoreFront mediante PowerShell.
    Este error se produce cuando el script de StoreFront se ejecuta en una ventana de PowerShell compatible con x86.
    Resolución:
    Para ejecutar el script de PowerShell de StoreFront, abra la ventana de PowerShell compatible con Windows x64 con privilegios de administrador y, a continuación, ejecute ConfigureStorefront.ps1.

Fallos de la puerta de enlace pública/puerta de enlace de devolución de llamada

Mensaje de error: Error al crear la entrada de Gateway para: <Gateway URL> O Error al crear la entrada de Callback Gateway para: <Callback Gateway URL>
Resolución:
Anote la URL de Public Gateway o Callback Gateway para la que se produjo el error. Después de configurar Secure Private Access mediante el asistente, puede editar las entradas de gateway desde la pestaña Configuración.
  1. Haga clic en Configuración y, a continuación, en la pestaña Integraciones.
  2. Actualice la dirección de gateway pública o la dirección de gateway de devolución de llamada y la dirección IP virtual para la que se produjo el error.

Servidor de Secure Private Access no accesible

Mensaje de error: Error al actualizar el grupo de IIS. Error al reiniciar el grupo de IIS
Resolución:
Vaya a Grupos de aplicaciones en Internet Information Services (IIS) y compruebe que los siguientes grupos de aplicaciones se hayan iniciado y estén en ejecución:
  • Grupo de tiempo de ejecución de Secure Private Access
  • Grupo de administración de Secure Private Access
Compruebe también que el sitio IIS predeterminado "Default Web Site" esté en funcionamiento.

Errores de comprobación de conectividad de la base de datos

Mensaje de error: Error en la comprobación de conectividad
La comprobación de conectividad de la base de datos puede fallar por varias razones:
  • El servidor de la base de datos no es accesible desde la máquina host del plug-in de Secure Private Access debido a un firewall.
    Resolución: Compruebe si el puerto de la base de datos (puerto predeterminado 1433) está abierto en el firewall.
  • La máquina host del plug-in de Secure Private Access no tiene permiso para conectarse a la base de datos.
    Resolución: Consulte (/es-es/citrix-secure-private-access/2311/spa-onprem-troubleshooting#sql-database-permissions-for-secure-private-access)Permisos de la base de datos SQL para Secure Private Access.

Error en la comprobación de conectividad de Gateway. No se puede obtener el certificado público

Mensaje de error: La configuración posterior a la instalación falla con el error “Error en la comprobación de conectividad de Gateway. No se puede obtener un certificado público…”
Resolución:
  • Cargue el certificado público de Gateway en la base de datos de Secure Private Access manualmente mediante la herramienta de configuración.
  • Abra la ventana de PowerShell o del símbolo del sistema con privilegios de administrador.
  • Cambie el directorio a la carpeta Admin\AdminConfigTool dentro de la carpeta de instalación de Secure Private Access (por ejemplo, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")
  • Ejecute el siguiente comando:
    .\AdminConfigTool.exe /UPLOAD_PUBLIC_GATEWAY_CERTIFICATE <PublicGatewayUrl> <PublicGatewayCertificatePath>

Error de enumeración de aplicaciones

La enumeración de aplicaciones se interrumpe si la URL de StoreFront o la URL de NetScaler Gateway contiene una barra diagonal (/).
Resolución:
Elimine la barra diagonal final en la URL del almacén de StoreFront o en la URL de NetScaler Gateway. Para obtener más información, consulte Actualizar StoreFront o los detalles del servidor de NetScaler Gateway después de la configuración.

Asuntos varios

Crear paquete de soporte de diagnóstico de Secure Private Access

Realice los siguientes pasos para crear un paquete de soporte de diagnóstico de Secure Private Access:
  • Abra la ventana de PowerShell o del símbolo del sistema con privilegios de administrador.
  • Cambie el directorio a la carpeta Admin\AdminConfigTool dentro de la carpeta de instalación de Secure Private Access (por ejemplo, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool").
  • Ejecute el siguiente comando:
    .\AdminConfigTool.exe /SUPPORTBUNDLE <output folder>

Permisos de la base de datos SQL para Secure Private Access

Para la creación automática de la base de datos, la máquina host del complemento de Secure Private Access debe tener los permisos para conectarse a la base de datos y crear el esquema de la base de datos.
Base de datos remota:
Realice los siguientes pasos para configurar los permisos de una base de datos remota.
  1. Cree una base de datos vacía con la sintaxis de nombre CitrixAccessSecurity<Site Name>. Aquí <Site Name> es el nombre del sitio de Secure Private Access (por ejemplo, CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Cree un inicio de sesión de servidor SQL para la identidad de la máquina virtual de Secure Private Access. Por ejemplo, si el nombre de la máquina intermediaria de Secure Private Access es HOST1 y el dominio de la máquina es DOMAIN1, entonces la identidad de la máquina es "DOMAIN1\HOST1$". Si el inicio de sesión ya está creado, puede omitir este paso.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [DOMAIN1\HOST1$] FROM WINDOWS
    El nombre de dominio se puede encontrar utilizando la siguiente consulta:
    SELECT DEFAULT_DOMAIN()[DomainName]
  3. Asigne el rol db_owner a la identidad de la máquina.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'
    ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
Base de datos local:
Realice los siguientes pasos para configurar los permisos de una base de datos local.
  1. Cree una base de datos vacía con la sintaxis de nombre CitrixAccessSecurity<Site Name>. Aquí <Site Name> es el nombre del sitio de Secure Private Access (por ejemplo, CitrixAccessSecuritySPA).
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Cree un inicio de sesión de servidor SQL para el usuario NT AUTHORITY\SYSTEM. Si el inicio de sesión ya está creado, puede omitir este paso.
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS
  3. Asigne el rol db_owner al usuario “NT AUTHORITY\SYSTEM”.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
Cuando cree la base de datos manualmente, el script de base de datos descargado añade los permisos a la identidad de la máquina.