Guardar una credencial para el recolector
Una credencial es el inicio de sesión de solo lectura que usa el recolector para llegar a un sistema: un inicio de sesión de SQL, una cuenta de Windows, una clave SSH o una entidad de servicio de Azure. La guardas una vez en una entidad, y todos los recursos de esa entidad y de las que están debajo pueden usarla. Esta guía muestra cómo agregar una, qué tipo elegir, las opciones de conexión de cada tipo y cómo un recurso encuentra la credencial que usa.
Antes de empezar
- Necesitas el rol Administrador de entidad en la entidad a la que pertenecerá la credencial.
- El inicio de sesión existe en el sistema monitoreado con permisos de solo lectura. Para SQL Server, consulta Requisitos previos para grupos de disponibilidad; para todas las plataformas, consulta Permisos.
- Guarda la credencial lo más arriba posible en el árbol de entidades en el que sea válida. Un inicio de sesión de SQL que se usa en todos los servidores de Ciguapa Inc. va en Ciguapa Inc., no en cada entorno.
Elegir el tipo
| Tipo | Usuario | Secreto | Úsalo para |
|---|---|---|---|
Inicio de sesión de SQL (sql_login) | Inicio de sesión de SQL | Contraseña | Instancias de SQL Server y grupos de disponibilidad; sus bases de datos y servidores vinculados descubiertos usan el de la instancia. También el registro de ejecución de Reporting Services |
Cuenta de Windows (windows) | Cuenta (DOMAIN\user) | Contraseña | Hosts Windows por WinRM; servidores de informes y puntos de conexión web con autenticación de Windows (NTLM) |
Usuario y contraseña HTTP (http_basic) | Usuario | Contraseña | Puntos de conexión web y servidores de informes con autenticación básica; las comprobaciones de Wazuh |
Token de portador (token) | — | Token | Puntos de conexión web con autenticación de portador |
Clave SSH (ssh_key) | Usuario | Clave privada | Hosts Linux |
Contraseña SSH (ssh_password) | Usuario | Contraseña | Hosts Linux |
Entidad de servicio de Azure (azure_sp) | Id. de cliente | Secreto de cliente | Comprobaciones de postura de Azure y comprobaciones de identidad de Entra ID, para un inquilino al que la identidad administrada del servidor no puede llegar |
La autenticación integrada de Windows con SQL Server no es compatible: el recolector se ejecuta en un contenedor Linux sin un tique de Kerberos. Usa un inicio de sesión de SQL, para lo cual la instancia debe aceptar la autenticación de SQL Server (modo mixto).
Agregar una credencial
- Abre Configuración › Credenciales y elige la entidad en el selector de entidades, por ejemplo Ciguapa Inc..
- Selecciona Agregar credencial.
- Escribe un Nombre que reconozcas, como
sql-monitoring, y elige el Tipo. El tipo no se puede cambiar después. - Revisa la Entidad: los recursos de esta entidad y de las que están debajo pueden usar la credencial.
- Escribe el usuario y el secreto. Las etiquetas dependen del tipo, por ejemplo Inicio de sesión de SQL y Contraseña, o Id. de cliente y Secreto de cliente.
- En Opciones de conexión, configura lo que necesita el tipo. Consulta la sección siguiente.
- Selecciona Crear.
La credencial aparece en la lista con el secreto marcado como stored, cuántos recursos la usan y cuándo se usó por última vez.
Opciones de conexión
| Tipo | Opción | Valores | Efecto |
|---|---|---|---|
| Inicio de sesión de SQL | encrypt | yes (predeterminado), no, strict | Cifra la conexión. strict usa TDS 8 y necesita SQL Server 2022 o posterior |
| Inicio de sesión de SQL | trust_server_certificate | true (predeterminado), false | La mayoría de las instancias usan certificados autofirmados. Establece false cuando la instancia tenga un certificado en el que confíe el recolector |
| Inicio de sesión de SQL | host_name_in_certificate | Un nombre de host | El nombre que se valida cuando difiere del host, por ejemplo a través de un listener o un alias |
| Inicio de sesión de SQL | application_intent | ReadOnly (predeterminado), ReadWrite | ReadWrite solo cambia el enrutamiento, para que las comprobaciones por base de datos incluyan las bases de datos de disponibilidad de una primaria que rechaza las conexiones de intención de lectura. El inicio de sesión sigue sin tener permisos de escritura |
| Cuenta de Windows | auth | kerberos (predeterminado), negotiate, ntlm | Cómo se autentica WinRM. La imagen del recolector no tiene configuración de Kerberos, así que elige negotiate o ntlm |
| Clave SSH, Contraseña SSH | known_hosts | Líneas known_hosts de OpenSSH, una por línea | Fija las claves de host que acepta el recolector |
| Entidad de servicio de Azure | tenant_id | El ID del inquilino de Entra | El inquilino del registro de aplicación |
Algunas opciones solo se configuran mediante la API, en los attributes de la credencial:
| Tipo | Opción | Efecto |
|---|---|---|
| Entidad de servicio de Azure | subscriptions | Limita las comprobaciones de postura de Azure a estas suscripciones. Sin ella, se aplica AZURE_SUBSCRIPTION_IDS o, en su defecto, todas las suscripciones que la identidad puede leer |
| Usuario y contraseña HTTP | verify_tls | false acepta un certificado que no es de confianza en el indexador y el administrador de Wazuh. Valor predeterminado: true |
Los nombres de las opciones nunca contienen secretos: la API rechaza una opción cuyo nombre contenga pass, secret, token, private o pwd. Pon los secretos en el campo del secreto.
Cómo se protege el secreto
- El secreto es de solo escritura. Se cifra con la clave de datos de la instalación (
EXCUBIUS_DATA_KEY) y no se vuelve a mostrar, en ninguna pantalla ni a través de la API, que solo indica si hay uno guardado. - Para cambiarlo, edita la credencial y escribe uno nuevo. Deja el campo vacío para conservar el secreto guardado, o selecciona Quitar el secreto guardado para borrarlo.
- El recolector recibe el secreto por la red interna, lo mantiene solo en memoria y nunca lo registra.
- Guarda
EXCUBIUS_DATA_KEYjunto con la copia de seguridad del archivo.env. Sin ella, los secretos guardados no se pueden descifrar, y las comprobaciones fallan con el tipo de errorconfighasta que los vuelves a escribir.
Qué credencial usa un recurso
Un recurso busca una credencial en este orden y toma la primera cuyo tipo sirve para la comprobación:
- La credencial propia de la comprobación, si tiene una.
- La credencial del recurso.
- La credencial del recurso padre más cercano. Un grupo de disponibilidad o una base de datos descubiertos debajo de una instancia usan el inicio de sesión de SQL de la instancia.
Por ejemplo, la comprobación del registro de ejecución de un servidor de informes es una comprobación T-SQL. Cuando el recurso del servidor de informes tiene una cuenta de Windows para su portal, la comprobación usa el inicio de sesión de SQL de la instancia que está por encima, o un inicio de sesión de SQL que configures solo en esa comprobación.
Para configurar una credencial en una sola comprobación, usa la API: PATCH /api/v1/resources/{id}/checks/{check_id} con credential_id. Para que un recurso o una comprobación apunte a una credencial, necesitas el rol Administrador de entidad en la entidad a la que pertenece la credencial.
Editar o eliminar una credencial
- Editar cambia el nombre, el usuario, el secreto y las opciones. El tipo no cambia.
- Eliminar solo funciona cuando nada usa la credencial. Primero cambia los recursos y las comprobaciones que la usan.
- Eliminar una entidad también elimina las credenciales que le pertenecen.
La lista muestra, para cada credencial, cuántos recursos y comprobaciones la usan y cuándo la usó por última vez una comprobación correcta.
Contenido relacionado
- Cómo funciona el recolector
- Agregar un recurso, donde Probar conexión demuestra que la credencial funciona
- Errores del recolector
- Permisos