- Información general
- Requisitos
- Plantillas de implementación
- Manual: preparar la instalación
- Manual: preparar la instalación
- Paso 2: configurar el registro compatible con OCI para las instalaciones sin conexión
- Paso 3: configurar el almacén de objetos externo
- Paso 4: configurar High Availability Add-on
- Paso 5: configurar las bases de datos SQL
- Paso 7: configurar el DNS
- Paso 8: configurar los discos
- Paso 9: configurar los ajustes a nivel de kernel y sistema operativo
- Paso 10: configurar los puertos de nodo
- Paso 11: aplicar ajustes varios
- Paso 12: Validar e instalar los paquetes RPM necesarios
- Paso 13: Generar cluster_config.json
- Ejemplo de Clúster_config.json
- Configuración general
- Configuración del perfil
- Configuración de certificados
- Configuración de la base de datos
- Configuración del almacén de objetos externo
- Configuración de URL prefirmada
- Configuración de ArgoCD
- Configuración de la autenticación Kerberos
- Configuración de registro externo compatible con OCI
- Disaster recovery: configuraciones activas/pasivas y activas/activas
- Configuración de High Availability Add-on
- Configuración específica de Orchestrator
- Configuración específica de Insights
- Process Mining-specific configuration
- Configuración específica de Document Understanding
- Automation Suite Robots-specific configuration
- Configuración de la supervisión
- Opcional: configurar el servidor proxy
- Opcional: habilitación de la resistencia a fallos de zona en un clúster multinodo de producción preparada para alta disponibilidad
- Opcional: pasar resolv.conf personalizado
- Optional: Increasing fault tolerance
- Inclusión de un nodo agente dedicado compatible con GPU
- Añadir un nodo agente dedicado a Automation Suite Robots
- Paso 15: configurar el registro temporal de Docker para las instalaciones sin conexión
- Paso 16: validar los requisitos previos para la instalación
- Ejecutar uipathctl
- Manual: realizar la instalación
- Después de la instalación
- Administración de clústeres
- Gestionar los productos
- Primeros pasos con el Portal de administración del clúster
- Migración de Redis desde un clúster a un High Availability Add-on externo
- Migrating in-cluster objectstore to external objectstore
- Migrar del registro en clúster a un registro externo compatible con OCI
- Configurar la instalación posterior a FQDN
- Configurar la autenticación Kerberos
- Reenvío de registros a herramientas externas
- Reenvío de registros de Kubernetes a Elasticsearch
- Cambiar manualmente al clúster secundario en una configuración activa/pasiva
- Disaster Recovery: realizar operaciones posteriores a la instalación
- Convertir una instalación existente en una configuración en varios sitios
- Directrices sobre la actualización de una implementación activa/pasiva o activa/activa
- Directrices sobre la copia de seguridad y restauración de una implementación activa/pasiva o activa/activa
- Escalar una implementación de nodo único (evaluación) a una implementación multinodo (HA)
- Supervisión y alertas
- Migración y actualización
- Migrar entre clústeres de Automation Suite
- Actualizar Automation Suite
- Descargar los paquetes de instalación y obtener todos los archivos del primer nodo del servidor
- Recuperar la última configuración aplicada del clúster
- Actualizar la configuración del clúster
- Configurar el registro compatible con OCI para las instalaciones sin conexión
- Ejecutar la actualización
- Realizar operaciones posteriores a la actualización
- Configuración específica del producto
- Configuración avanzada de Orchestrator
- Configurar parámetros de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar NLog
- Guardar los registros del robot en Elasticsearch
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Limpiar la base de datos de Orchestrator
- Omitir la instalación de la biblioteca de host
- Buenas prácticas y mantenimiento
- Solución de problemas
- Cómo solucionar los problemas de los servicios durante la instalación
- Cómo reducir los permisos para un directorio de copia de seguridad NFS
- Cómo desinstalar el clúster
- Cómo limpiar los artefactos sin conexión para mejorar el espacio en disco
- Cómo borrar datos de Redis
- Cómo habilitar el registro de Istio
- Cómo limpiar manualmente los registros
- Sacar a Ceph del modo solo lectura
- Cómo limpiar los registros antiguos almacenados en el depósito sf-logs
- Cómo deshabilitar los registros de transmisión para AI Center
- Cómo depurar instalaciones de Automation Suite fallidas
- Cómo eliminar imágenes del instalador antiguo después de la actualización
- Cómo deshabilitar la descarga de la suma de comprobación TX
- Cómo establecer manualmente el nivel de registro de ArgoCD en Info
- Cómo expandir el almacenamiento de AI Center
- Cómo generar el pull_secret_value codificado para registros externos
- Cómo abordar los cifrados débiles en TLS 1.2
- Cómo comprobar la versión de TLS
- Cómo trabajar con certificados
- Cómo programar la copia de seguridad y la restauración de datos de Ceph
- Cómo recopilar datos de uso de DU con el almacén de objetos en el clúster (Ceph)
- Cómo instalar RKE2 SELinux en entornos aislados
- Cómo limpiar copias de seguridad diferenciales antiguas en un servidor NFS
- Cómo implementar Insights en un clúster habilitado para FIPS
- Cómo migrar a cgroup v2
- Cómo recuperar la autenticación Kerberos después de reiniciar una máquina virtual
- Cómo enviar una imagen de Docker local al registro en el clúster
- Cómo excluir depósitos de la copia de seguridad
- Error al descargar el paquete
- La instalación sin conexión falla porque falta un binario
- Azure disk not marked as SSD
- Fallo tras la actualización del certificado
- Errores de validación del certificado TLS
- Antivirus causes installation and operation issues
- Automation Suite not working after OS upgrade
- Automation Suite requiere que backlog_wait_time se establezca en 0
- La instalación del registro temporal falla en RHEL 8.9
- Problema de reinicio frecuente en las implementaciones del espacio de nombres de uipath durante las instalaciones sin conexión
- Configuración de DNS no respetada por CoreDNS
- La propagación del registro en el clúster falla debido a la memoria insuficiente
- Las comprobaciones de requisitos previos fallan cuando los proyectos modernos de Document Understanding están habilitados y AI Center está deshabilitado
- Pods atascados en estado Init debido a un fallo de montaje del volumen XFS
- Los datos del clúster parecen perdidos después de un reinicio debido a un orden incorrecto de montaje del disco de Rancher y etcd
- Upgrade fails due to unhealthy Ceph
- La actualización falla debido a objetos clásicos en la base de datos de Orchestrator
- El clúster de Ceph se encuentra en un estado degradado tras una actualización en paralelo.
- La actualización del servicio falla para Apps
- Tiempos de actualización in situ
- La actualización falla en entornos sin conexión
- pod de snapshot-controller-crds en estado CrashLoopBackOff después de la actualización
- La actualización falla debido a los tamaños de PVC de Insights anulados
- Error de actualización debido a un nombre de host en mayúsculas
- Establecer un intervalo de tiempo de espera para los portales de gestión
- La autenticación no funciona tras la migración
- kinit: no se puede encontrar la KDC para el territorio <AD Domain> mientras se obtienen las credenciales iniciales
- kinit: keytab no contiene claves adecuadas para *** mientras se obtienen las credenciales iniciales
- Error en la operación GSSAPI debido a un código de estado no válido
- Alarma recibida por un error en el trabajo de Kerberos-tgt-update
- Proveedor de SSPI: servidor no encontrado en la base de datos de Kerberos
- Error en inicio de sesión de un usuario AD debido a una cuenta deshabilitada
- ArgoCD login failed
- Fallo en la obtención de la imagen de Sandbox
- Los pods no se muestran en la interfaz de usuario de ArgoCD
- Fallo de la sonda Redis
- El servidor RKE2 no se inicia
- ArgoCD entra en estado de progreso tras la primera instalación
- Pod del servidor de repositorio de ArgoCD en CrashLoopBackOff
- Mitigación manual de Política de red de ArgoCD (GHSA-47m3-95c7-g2g8)
- Faltan métricas de Ceph-rook en los paneles de supervisión
- Falta de coincidencia en los errores informados durante las comprobaciones de estado de diagnóstico
- Configurar solicitudes de recursos y límites para cargas de trabajo creadas por uipathctl
- No hay problema ascendente en buen estado
- Inicio de Redis bloqueado por antivirus
- Los pods de AI Center y Document Understanding no se inician con la verificación del certificado TLS habilitada
- Fluentd no exporta registros en entornos IPv6
- Studio Desktop no puede cargar conectores y actividades de Integration Service
- Document Understanding no se encuentra en la barra izquierda de Automation Suite
- Estado fallido al crear una sesión de etiquetado de datos
- Estado fallido al intentar implementar una habilidad ML
- El trabajo de migración falla en ArgoCD
- El reconocimiento de la escritura manual con el extractor de formularios inteligente no funciona
- Ejecutar alta disponibilidad con Process Mining
- La ingestión de Process Mining falló al iniciar sesión con Kerberos
- No se puede conectar a la base de datos AutomationSuite_ProcessMining_Warehouse utilizando una cadena de conexión en formato pyodbc
- La instalación de Airflow falla con sqlalchemy.exc.ArgumentError: no se pudo analizar la URL rfc1738 de la cadena ''
- Cómo añadir una regla de tabla de IP para utilizar el puerto 1433 de SQL Server
- El certificado de Automation Suite no es de confianza desde el servidor donde se ejecuta CData Sync
- Process Mining no se carga después de deshabilitarlo y volver a habilitarlo
- Ejecutar la herramienta de diagnóstico
- Uso del paquete de soporte de Automation Suite
- Explorar registros
Configurar la autenticación Kerberos
Referencia para los requisitos previos de configuración de la autenticación Kerberos y los pasos de configuración para Automation Suite.
Requisitos previos
Para configurar correctamente la autenticación Kerberos, debe cumplir los siguientes requisitos previos:
- Garantizar que el clúster de Automation Suite pueda acceder a su AD
- Configurar la cuenta del servicio AD para la autenticación Kerberos
- Opcional: Requisitos previos de autenticación SQL
Garantizar que el clúster de Automation Suite pueda acceder a su AD
Antes de configurar la autenticación Kerberos, consulte a los administradores de TI si el clúster de Automation Suite puede acceder a su instancia de AD.
Deben cumplirse los siguientes requisitos:
-
El clúster de Automation Suite debe estar en la misma red que el dominio de AD.
-
El DNS debe configurarse correctamente en la red para que el clúster de Automation Suite pueda resolver los nombres de dominio de AD.
Nota:Es de vital importancia que el clúster de Automation Suite pueda resolver el AD
domain names. Puede verificarlo ejecutandonslookup <AD domain name>en la máquina host.
Configurar la cuenta del servicio AD para la autenticación Kerberos
Generación de parámetros de keytab y nombre de usuario predeterminados de Kerberos
Opción 1: ejecutando el script (recomendado)
-
Inicia sesión con tu cuenta de administrador de AD en una máquina unida a un dominio de Windows.
-
Ejecuta el script keytab-creator.ps1 como administrador.
-
Introduzca los siguientes valores en el script:
Service Fabric FQDN. Por ejemplo,uipath-34i5ui35f.westeurope.cloudapp.azure.com.AD domain FQDN. Por ejemplo,TESTDOMAIN.LOCAL.- Una cuenta de usuario de AD. Puedes usar una cuenta existente, como
sAMAccountName, o puedes permitir que el script cree una nueva.
El archivo de salida contiene los parámetros <KERB_DEFAULT_USERNAME> y <KERB_DEFAULT_KEYTAB> requeridos por la configuración de Kerberos.
Opción 2: manualmente
Hable con su administrador de AD sobre la cuenta de usuario de AD, y recupere <KERB_DEFAULT_USERNAME> y <KERB_DEFAULT_KEYTAB> para dicha cuenta de la siguiente manera:
-
Cree una cuenta de usuario nuevo en su servidor AD. Si ya tiene una, continúe con el paso 2.
- En la consola Usuarios y equipos de Active Directory, abre el menú contextual de la carpeta Usuarios , selecciona Nuevo y luego selecciona Usuario.
- Termine de crear la cuenta de usuario.
-
Abre el menú contextual de la cuenta de usuario y selecciona Propiedades.
-
Vaya a la pestaña Cuenta y, en Opciones de cuenta, seleccione Esta cuenta admite cifrado AES de Kerberos de 256 bits.
-
Importante: El archivo keytab generado en los siguientes pasos dejará de ser válido si la contraseña de usuario de AD expira o se actualiza. Plantéese marcar La contraseña no caduca nunca en Opciones de cuenta para esta cuenta de usuario de AD. Como alternativa, puede actualizar la contraseña cuando esté a punto de caducar y generar un nuevo archivo keytab.
-
Para generar un archivo keytab para el SPN, abra PowerShell con acceso de administrador y ejecute el siguiente comando:
ktpass -princ HTTP/<Service Fabric FQDN>@<AD FQDN in cap> -pass <AD user's password> -mapuser <AD NetBIOS name in cap>\<AD user name> -pType KRB5_NT_PRINCIPAL -out <output file path> -crypto AES256-SHA1ktpass -princ HTTP/<Service Fabric FQDN>@<AD FQDN in cap> -pass <AD user's password> -mapuser <AD NetBIOS name in cap>\<AD user name> -pType KRB5_NT_PRINCIPAL -out <output file path> -crypto AES256-SHA1Algunos campos deben especificarse en mayúsculas. Por ejemplo:
ktpass -princ HTTP/uipath-34i5ui35f.westeurope.cloudapp.azure.com@TESTDOMAIN.LOCAL -pass pwd123 -mapuser TESTDOMAIN\aduser -pType KRB5_NT_PRINCIPAL -out c:\krb5.keytab -crypto AES256-SHA1 -setpassktpass -princ HTTP/uipath-34i5ui35f.westeurope.cloudapp.azure.com@TESTDOMAIN.LOCAL -pass pwd123 -mapuser TESTDOMAIN\aduser -pType KRB5_NT_PRINCIPAL -out c:\krb5.keytab -crypto AES256-SHA1 -setpassNota:Para actualizar keytab para Automation Suite, ejecuta el comando con la opción
-setpass. La primera vez que generes el keytab, debes ejecutar el comando como administrador de dominio. Esto es necesario porque el comando actualiza el SPN de la cuenta de servicio. Para actualizaciones posteriores, puedes ejecutar el comando como usuario del dominio si la asignación de SPN no ha cambiado.Después de la generación del keytab, el nombre de inicio de sesión del usuario cambia a
HTTP/<Service Fabric FQDN>. Utiliza este valor para el campo<KERB_DEFAULT_USERNAME>endefault_ad_usernameencluster_config.jsonde la siguiente manera:"kerberos_auth_config": { "enabled": true, "ticket_lifetime_in_hour": 8, "ad_domain": "AUTOSUITEAD.LOCAL", "default_ad_username": "HTTP/sfqakxxxx-ea.infra.uipath-dev.com", "default_user_keytab": "BQIAAAB9AAIxxxxxxxxxxxxxxxxxxGRCqh+yQ=" "enable_integrated_sql_auth": true },"kerberos_auth_config": { "enabled": true, "ticket_lifetime_in_hour": 8, "ad_domain": "AUTOSUITEAD.LOCAL", "default_ad_username": "HTTP/sfqakxxxx-ea.infra.uipath-dev.com", "default_user_keytab": "BQIAAAB9AAIxxxxxxxxxxxxxxxxxxGRCqh+yQ=" "enable_integrated_sql_auth": true },Nota:El parámetro
enable_integrated_sql_authestá establecido entruede forma predeterminada. Si quieres deshabilitar la autenticación Kerberos para SQL para todos los productos, debes establecer el parámetro enfalse. -
Cifre el archivo keytab generado en Base64, abra PowerShell y ejecute el siguiente comando:
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("<path to the generated keytab file>"))[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("<path to the generated keytab file>")) -
Guarde el archivo keytab codificado. Lo utilizará al configurar el clúster de UiPath® para Kerberos. A este valor del paso 6 lo vamos a llamar
<KERB_DEFAULT_KEYTAB>.
Opcional: Requisitos previos de autenticación SQL
Para configurar el clúster de UiPath® para conectarse a SQL mediante la autenticación integrada de Windows o mediante Kerberos, necesita realizar una serie de pasos adicionales:
- El servidor SQL debe conectarse al dominio de AD.
- El clúster de Automation Suite debe estar en la misma red que el servidor SQL.
- El clúster de Automation Suite puede resolver los nombres de dominio de los servidores SQL y AD.
- El usuario de AD debe tener acceso a los permisos del servidor SQL y de la base de datos.
Para crear un nuevo inicio de sesión en SQL Server Management Studio, siga estos pasos:
a. En el panel Explorador de objetos, ve a Seguridad > Inicios de sesión.
b. Abre el menú contextual de la carpeta Inicios de sesión y selecciona Nuevo inicio de sesión. Se mostrará la ventana Inicio de sesión: nuevo .
c. Selecciona la opción Autenticación de Windows. La ventana se actualizará en consecuencia.
D. En el campo Nombre de inicio de sesión , introduce el dominio de usuario que deseas utilizar como cuenta de servicio.
e. En la lista de Idioma predeterminado, selecciona Inglés.
Asegúrate de que el idioma predeterminado esté establecido en inglés. Si no es así, el sitio web no puede iniciarse y el Visor de eventos en el equipo en el que está instalado Orchestrator muestra el siguiente mensaje de error: The conversion of a varchar data type to a datetime data type resulted in an out of range value.
f. Selecciona Aceptar. Sus configuraciones se guardan.
Si la cuenta de servicio ya se ha creado y añadido a la sección Seguridad > Inicios de sesión de SQL Server, comprueba que el idioma predeterminado de esa cuenta SQL esté establecido en inglés. Si no lo está, realiza los ajustes necesarios.
Es necesario proporcionar al usuario que va a conectarse a la base de datos SQL el rol db_owner de asignación de usuarios, como se muestra en la siguiente captura de pantalla.
Si las restricciones de seguridad no te permiten utilizar el rol db_owner de asignación de usuarios con el inicio de sesión de UiPath®, concede los siguientes permisos:
db_datareaderdb_datawriterdb_ddladminEXECUTEpermiso en el esquemadbo
La siguiente imagen muestra los permisos de la base de datos que se conceden cuando no se puede utilizar db_owner.
Debe otorgarse el permiso EXECUTE utilizando el comando GRANT EXECUTE de SQL, como se muestra a continuación:
USE UiPath
GO
GRANT EXECUTE ON SCHEMA::dbo TO [domain\)\)user]
GO
USE UiPath
GO
GRANT EXECUTE ON SCHEMA::dbo TO [domain\)\)user]
GO
Si quiere que las aplicaciones de UiPath® utilicen cuentas exclusivas para conectarse a SQL mediante Integrated Security=True, necesitará crear un archivo keytab exclusivo para cada aplicación de UiPath®, tal como se indica a continuación. Para esta aplicación, se le denominará <KERB_APP_KEYTAB>.
Generar el keytab de la aplicación de Kerberos y los parámetros de nombre de usuario
Opción 1: ejecutando el script (recomendado)
-
Ejecuta el script service-keytab-creator.ps1.
-
Introduzca los siguientes valores en el script:
AD domain FQDN. Por ejemplo,TESTDOMAIN.LOCAL.- El nombre de usuario y la contraseña de una cuenta de usuario de AD. Por ejemplo, la cuenta de usuario de AD
sAMAccountNamey su contraseña.
El archivo de salida contiene los parámetros <KERB_APP_USERNAME> y <KERB_APP_KEYTAB> requeridos por Kerberos.
Opción 2: manualmente
Ejecuta el siguiente script manualmente:
# Generate keytab file and output it in the desired path
ktpass /princ <AD username>@<AD domain in cap> /pass <AD user password> /ptype KRB5_NT_PRINCIPAL /crypto AES256-SHA1 /out <path to keytab file> -setpass
# Converts AD user's keytab file to base 64
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("<path to the generated keytab file>"))
# Generate keytab file and output it in the desired path
ktpass /princ <AD username>@<AD domain in cap> /pass <AD user password> /ptype KRB5_NT_PRINCIPAL /crypto AES256-SHA1 /out <path to keytab file> -setpass
# Converts AD user's keytab file to base 64
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("<path to the generated keytab file>"))
El valor <AD username> será el <KERB_APP_USERNAME> correspondiente a <KERB_APP_KEYTAB>.
Configurar Automation Suite como cliente de Kerberos
Esta sección explica cómo configurar Automation Suite como cliente de Kerberos para el acceso a LDAP o SQL.
Configure Automation Suite como cliente de Kerberos con <KERB_DEFAULT_KEYTAB> de alguna de las siguientes formas:
- Configurar la autenticación Kerberos mediante el instalador interactivo
- Configurar la autenticación Kerberos mediante cluster_config.json
Nota:
Actualmente, permitimos la configuración independiente de solo la autenticación de usuario estableciendo
kerberos_auth_config.enableden verdadero ykerberos_auth_config.enable_integrated_sql_authen falso. La autenticación de SQL independiente aún no es compatible.
Configurar la autenticación Kerberos mediante cluster_config.json
-
En el archivo
cluster_config.json, establece el parámetrokerberos_auth_config.enabledcomotrue. -
Si quiere utilizar Kerberos para el acceso a SQL, configure
sql_connection_string_template,sql_connection_string_template_jdbcysql_connection_string_template_odbccon la marca Seguridad integrada.Nota:La autenticación Kerberos no es compatible exclusivamente con SQL. Para activar Kerberos con autenticación SQL, debes habilitar
kerberos_auth_config. Esto también añade la autenticación de usuario. -
Si quieres configurar un usuario de AD diferente por servicio, sigue los siguientes pasos:
-
Especifica
ad_usernameyuser_keytaben el objeto JSON del grupo de servicios. -
Actualice la cadena de conexión SQL para el servicio para habilitar la seguridad integrada.
-
El parámetro
enabledse establece entruede forma predeterminada cuando la autenticación Kerberos está habilitada a nivel global. Si quieres deshabilitar la autenticación Kerberos para SQL para un producto específico, debes establecerenabledcomofalse.El objeto JSON debe ser el siguiente:
"<serviceGroupName>": { "kerberos_auth_config": { "ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for this service group", "user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for this service group", "enabled": true } }"<serviceGroupName>": { "kerberos_auth_config": { "ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for this service group", "user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for this service group", "enabled": true } }Nota:Para obtener la lista de nombres de grupos de servicios, consulta Grupos de servicios y servicios.
-
-
Después de
cluster_config.json, ejecuta el script del instalador para actualizar la configuración. Para obtener más información, consulta Gestionar productos.Nota:Puedes utilizar este procedimiento para actualizar o rotar el keytab de Kerberos.
Ejemplo de actualización de Orchestrator y la plataforma para utilizar la autenticación Kerberos
"kerberos_auth_config": {
"enabled" : true,
"ticket_lifetime_in_hour" : 8,
"ad_domain": "PLACEHOLDER - INSERT ACTIVE DIRECTORY DOMAIN",
"default_ad_username": "PLACEHOLDER - INSERT KERB_DEFAULT_USERNAME",
"default_user_keytab": "PLACEHOLDER - INSERT KERB_DEFAULT_KEYTAB",
"enable_integrated_sql_auth": true
},
"sql_connection_string_template": "PLACEHOLDER",
"sql_connection_string_template_jdbc": "PLACEHOLDER",
"sql_connection_string_template_odbc": "PLACEHOLDER",
"orchestrator": {
"sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_Orchestrator;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
"kerberos_auth_config": {
"ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for Orchestrator",
"user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for Orchestrator",
"enabled": true
},
"testautomation": {
"enabled": true
},
"updateserver": {
"enabled": true
}
},
"platform": {
"sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
"kerberos_auth_config": {
"ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for platform",
"user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for platform",
"enabled": true
}
}
"kerberos_auth_config": {
"enabled" : true,
"ticket_lifetime_in_hour" : 8,
"ad_domain": "PLACEHOLDER - INSERT ACTIVE DIRECTORY DOMAIN",
"default_ad_username": "PLACEHOLDER - INSERT KERB_DEFAULT_USERNAME",
"default_user_keytab": "PLACEHOLDER - INSERT KERB_DEFAULT_KEYTAB",
"enable_integrated_sql_auth": true
},
"sql_connection_string_template": "PLACEHOLDER",
"sql_connection_string_template_jdbc": "PLACEHOLDER",
"sql_connection_string_template_odbc": "PLACEHOLDER",
"orchestrator": {
"sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_Orchestrator;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
"kerberos_auth_config": {
"ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for Orchestrator",
"user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for Orchestrator",
"enabled": true
},
"testautomation": {
"enabled": true
},
"updateserver": {
"enabled": true
}
},
"platform": {
"sql_connection_str": "Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;Integrated Security=true;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;",
"kerberos_auth_config": {
"ad_username": "PLACEHOLDER - INSERT KERB_APP_USERNAME for platform",
"user_keytab": "PLACEHOLDER - INSERT KERB_APP_KEYTAB for platform",
"enabled": true
}
}
El parámetro enable_integrated_sql_auth está establecido en true de forma predeterminada. Si quieres deshabilitar la autenticación Kerberos para SQL para todos los productos, debes establecer este parámetro en false.
Grupos de servicios y servicios
La siguiente tabla enumera los grupos de servicios disponibles y los servicios que incluyen. Los nombres son ligeramente diferentes en el archivo cluster_config.json o en la interfaz de usuario de ArgoCD.
Nombre de grupo del servicio para cluster_config.json | Nombre del grupo de servicios para ArgoCD | Servicios incluidos |
|---|---|---|
orchestrator | orchestrator | Orchestrator, Webhooks |
platform | platform | Identidad, licencia contable (LA), auditoría, ubicación, administrador de recursos de licencia (LRM), servicio de gestión de la organización (OMS) |
discovery_group | discoverygroup | Automation Hub |
test_manager | testmanager | Test Manager |
automation_ops | automationops | Automation Ops |
aicenter | aicenter | AI Center |
documentunderstanding | documentunderstanding | Document Understanding |
insights | insights | Insights |
dataservice | dataservice | Data Service |
asrobots | asrobots | Automation Suite Robots |
processmining | processmining | Process Mining |
Configurar la integración de Active Directory
Para la autenticación Kerberos que va a utilizarse al iniciar sesión en Automation Suite, debe realizar más ajustes en la configuración del host de Automation Suite.
Disabling Kerberos authentication
Removing Kerberos authentication completely
Para eliminar por completo la autenticación de Kerberos, siga los siguientes pasos:
- Si utilizaste Kerberos para configurar la integración de AD, vuelve a configurar AD con la opción de nombre de usuario y contraseña siguiendo las instrucciones en Configurar la integración de Active Directory.
- If you used SQL integrated authentication, configure the SQL connection strings to use User Id and Password.
- Deshabilita la autenticación Kerberos. En el archivo
cluster_config.json, establece el parámetrokerberos_auth_config.enabledenfalsey, a continuación, ejecuta el script del instalador para actualizar la configuración. Para obtener más información, consulta Gestionar productos.
Removing SQL integrated authentication
Para eliminar la autenticación integrada de SQL, siga los siguientes pasos:
- Configure the SQL connection strings to use User Id and Password.
- Si quieres deshabilitar la autenticación integrada de SQL para todos los servicios, en el archivo
cluster_config.json, establece el parámetrokerberos_auth_config.enabledenfalsey luego ejecuta el script del instalador para actualizar la configuración. Para obtener más información, consulta Gestionar productos.
Resolución de problemas de Kerberos
Limpiar registros DNS de Active Directory
Si un controlador de dominio (DC) de Active Directory (AD) se elimina o da de baja a la fuerza, realiza la limpieza de metadatos del servidor de Servicios de dominio de Active Directory (AD DS). La limpieza de metadatos elimina los metadatos de AD DS del DC retirados.
Después de la limpieza, inspecciona el DNS y elimina los registros obsoletos del DC retirado. En particular, verifica que los registros del servicio Kerberos (SRV) en _kerberos._udp y _kerberos._tcp sean coherentes y contengan solo DC activos. Una falta de coincidencia puede causar fallos de conexión del Protocolo ligero de acceso a directorios (LDAP), como se describe en la guía del foro de UiPath.
No podemos aceptar un punto final de equilibrador de carga para interactuar con los servicios de dominio de Active Directory debido a las razones especificadas en ese artículo.
Si tienes algún problema al configurar Kerberos, consulta Solución de problemas de autenticación.
Debugging SQL integrated authentication
Use this flow when the cluster fails to authenticate to SQL using Windows integrated authentication even after completing the configuration.
Prerrequisitos:
- The SQL server runs on domain-joined machines.
- The SQL server service runs as a domain account.
- Automation Suite is configured with the keytab corresponding to the SQL client account whose credentials are used to connect to the SQL database.
- Verify that the SPN
MSSQLSvc/<exact SQL server name used by Automation Suite>:1433is registered on the AD domain account that the SQL Server service runs as — not on the account represented by the keytab configured in the cluster — as specified in Using Kerberos with SQL Server. - If the configuration is correct and the SQL connection still fails (visible in the Automation Suite pod logs), reproduce the failure from a Windows client:
- On a domain-joined Windows machine, open SQL Server Management Studio and connect to the SQL server using the same connection string used by Automation Suite.
- Enable Kerberos event logging as described in the Microsoft documentation, then try connecting again.
- Open Event Viewer and navigate to the System log to inspect the Kerberos logs.
KDC_ERR_PREAUTH_REQUIREDerrors are expected and can be ignored.- If you see
KDC_ERR_S_PRINCIPAL_UNKNOWNorKRB_AP_ERR_MODIFIED, the SPN for the SQL server is not set correctly. Verify that the SPN from step 1 is registered on the domain account that the SQL Server service runs as, and that the SQL server name resolves directly to its IP address through an A record in DNS. If the name resolves through a CNAME alias, clients can resolve the alias before verifying the Kerberos service name, which breaks the authentication. - If you see
KDC_ERR_ETYPE_NOTSUPP, encryption types are disabled in your organization. To force AES256, in Active Directory Users and Computers, navigate to the user account that represents the keytab file used by the cluster, open the Account tab, select This account supports Kerberos AES 256 bit encryption, and select OK. Then reset the password of this account, regenerate the keytab, and update it in the cluster configuration.
- Requisitos previos
- Garantizar que el clúster de Automation Suite pueda acceder a su AD
- Configurar la cuenta del servicio AD para la autenticación Kerberos
- Opcional: Requisitos previos de autenticación SQL
- Configurar Automation Suite como cliente de Kerberos
- Configurar la autenticación Kerberos mediante cluster_config.json
- Configurar la integración de Active Directory
- Disabling Kerberos authentication
- Removing Kerberos authentication completely
- Removing SQL integrated authentication
- Resolución de problemas de Kerberos
- Limpiar registros DNS de Active Directory
- Debugging SQL integrated authentication