Documentation
Table of Contents
Objeto de directorio de usuario
Los siguientes objetos están directamente relacionados con la API userdirectory.
Directorio de usuarios
El objeto del directorio de usuarios tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| userdirectoryid | cadena | ID del directorio de usuarios. Si se elimina un directorio de usuarios, el valor de la propiedad objeto de usuario userdirectoryid se establece en "0" para todos los usuarios que están vinculados al directorio de usuarios eliminados.Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| idp_type | entero | Tipo de protocolo de autenticación utilizado por el proveedor de identidad para el directorio de usuarios. Tenga en cuenta que solo puede existir un directorio de usuarios de tipo SAML . Valores posibles: 1 - Usuario directorio de tipo LDAP; 2 - Directorio de usuario de tipo SAML. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| group_name | cadena | Atributo del directorio de usuarios LDAP/SAML que contiene el nombre del grupo utilizado para asignar grupos entre el directorio de usuarios LDAP/SAML y Zabbix. Ejemplo: cn Comportamiento de la propiedad: - obligatorio si provision_status está configurado en "Habilitado" y saml_jit_status de objeto de autenticación está configurado en "Habilitado para IdP SAML configurados" |
| user_username | cadena | Atributo del directorio de usuarios LDAP/SAML (también atributo SCIM si scim_status está configurado en "El aprovisionamiento SCIM está habilitado") que contiene el nombre del usuario que se utiliza como valor para el objeto de usuario propiedad nombre cuando se aprovisiona el usuario.Ejemplos: cn, commonName, displayName, name |
| user_lastname | cadena | Atributo del directorio de usuarios LDAP/SAML (también atributo SCIM si scim_status está configurado en "El aprovisionamiento SCIM está habilitado") que contiene el apellido del usuario que se utiliza como valor para el objeto de usuario propiedad apellido cuando se aprovisiona el usuario.Ejemplos: sn, apellido, apellido |
| provision_status | entero | Estado de aprovisionamiento del directorio de usuarios. Valores posibles: 0 - (predeterminado) Deshabilitado (el aprovisionamiento de usuarios creados por este directorio de usuarios está deshabilitado); 1 - Habilitado (el aprovisionamiento de usuarios creados por este directorio de usuarios está habilitado; además, el estado del aprovisionamiento LDAP o SAML ( ldap_jit_status o saml_jit_status de objeto de autenticación) debe estar habilitado). |
| provision_groups | matriz | Matriz de asignaciones de grupos de aprovisionamiento objetos para asignar el patrón de grupo de usuarios LDAP/SAML al grupo de usuarios y la función de usuario de Zabbix. Comportamiento de la propiedad: - obligatorio si provision_status está configurado en "Habilitado" |
| provision_media | matriz | Matriz de asignaciones de tipos de medios objetos para asignar los atributos de medios LDAP/SAML del usuario (por ejemplo, correo electrónico) a los medios de usuario de Zabbix para enviar notificaciones. |
| Propiedades específicas de LDAP: | ||
| name | cadena | Nombre único del directorio de usuarios. Comportamiento de la propiedad: - obligatorio si idp_type está configurado en " Directorio de usuarios de tipo LDAP" |
| host | cadena | Nombre de equipo, IP o URI del servidor LDAP. El URI debe contener el esquema ( ldap:// o ldaps://), host y puerto (opcional).Ejemplos: host.example.com 127.0.0.1 ldap://ldap.example.com:389 Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| port | entero | Puerto del servidor LDAP. Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Usuario directorio de tipo LDAP" |
| base_dn | cadena | Ruta base del directorio de usuarios LDAP a las cuentas de usuario. Ejemplos: ou=Users,dc=example,dc=org ou=Users,ou=system (para OpenLDAP) DC=company,DC=com (para Microsoft Active Directory) uid=%{user},dc=example,dc=com (para enlace directo de usuario; marcador de posición "* %{user}" es obligatorio) Comportamiento de la propiedad: - obligatorio* si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| search_attribute | cadena | Atributo del directorio de usuarios LDAP mediante el cual identificar la cuenta de usuario a partir de la información proporcionada en la solicitud de inicio de sesión. Ejemplos: uid (para OpenLDAP) sAMAccountName ( para Microsoft Active Directory) Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| bind_dn | cadena | Cuenta del servidor LDAP para vincular y buscar a través del servidor LDAP. Para vinculación directa de usuario y vinculación anónima, bind_dn debe estar vacío.Ejemplos: * uid=ldap_search,ou=sistema* (para OpenLDAP) CN=ldap_search,OU=user_group,DC=empresa,DC=com (para Microsoft Active Directory) CN=Admin,OU=Usuarios, OU=Zabbix,DC=zbx,DC=local Comportamiento de la propiedad: - compatible si idp_type está configurado en " Directorio de usuarios de tipo LDAP" |
| bind_password | cadena | Contraseña LDAP de la cuenta para vincular y buscar en el servidor LDAP. Para vinculación directa de usuario y vinculación anónima, bind_password debe estar vacío.[Comportamiento de la propiedad] (/manual/api/reference_commentary#property-behavior): - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| description | cadena | Descripción del directorio de usuarios. Comportamiento de la propiedad: - compatible si idp_type está configurado en "Usuario directorio de tipo LDAP" |
| group_basedn | cadena | Ruta base del directorio de usuarios LDAP a los grupos; se utiliza para configurar una verificación de membresía de usuario en el directorio de usuarios LDAP. Se ignora al aprovisionar un usuario si se establece group_membership.Ejemplo: ou=Grupos,dc=ejemplo,dc= com Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| group_filter | cadena | Cadena de filtro para recuperar grupos de directorios de usuarios LDAP de los que el usuario es miembro; se utiliza para configurar una verificación de membresía de usuario en el directorio de usuarios LDAP. Se ignora al aprovisionar un usuario si se establece group_membership.Marcadores de posición group_filter admitidos:%{attr } - atributo de búsqueda (reemplazado por el valor de la propiedad search_attribute);%{groupattr} - atributo de grupo (reemplazado por el valor de la propiedad group_member);%{host} - host nombre, IP o URI del servidor LDAP (reemplazado por el valor de la propiedad host);%{user} - nombre de usuario del usuario de Zabbix. Predeterminado: (%{groupattr}=% {user}) Ejemplos: - (member=uid=%{ref},ou=Users,dc=example,dc=com) coincidirá con "User1" si es un grupo LDAP El objeto contiene el atributo "miembro" con el valor "uid=Usuario1,ou=Users,dc=example,dc=com", y devolverá el grupo del que "Usuario1" es miembro; - (%{groupattr}=cn=%{ref},ou=Users,ou=Zabbix,DC=example,DC=com) coincidirá con "Usuario1" si un objeto de grupo LDAP contiene el atributo especificado en group_member propiedad con el valor "cn=Usuario1,ou=Usuarios,ou=Zabbix,DC=example,DC=com", y devolverá el grupo del que "Usuario1" es miembro.Propiedad comportamiento: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| group_member | cadena | Atributo del directorio de usuarios LDAP que contiene información sobre los miembros del grupo; se utiliza para configurar una verificación de membresía de usuario en el directorio de usuarios LDAP. Se ignora al aprovisionar un usuario si se establece group_membership.Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| group_membership | cadena | Atributo del directorio de usuarios LDAP que contiene información sobre los grupos a los que pertenece un usuario. Ejemplo: memberOf Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| search_filter | cadena | Cadena de filtro personalizado utilizada para localizar y autenticar a un usuario en un directorio de usuarios LDAP según la información proporcionada en la solicitud de inicio de sesión. Marcadores de posición search_filter admitidos:%{attr} - nombre del atributo de búsqueda (por ejemplo, uid, sAMAccountName); %{user} - nombre de usuario del usuario de Zabbix. Predeterminado: (%{attr}=%{user} ) Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| start_tls | entero | Opción de configuración del servidor LDAP que permite proteger la comunicación con el servidor LDAP utilizando Seguridad de la capa de transporte (TLS). Tenga en cuenta que start_tls debe estar configurado en "Desactivado" para los hosts que utilizan el ldaps:// protocolo.Valores posibles: 0 - (predeterminado) Deshabilitado; 1 - Habilitado. Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo LDAP" |
| user_ref_attr | string | Atributo del directorio de usuarios LDAP utilizado para hacer referencia a un objeto de usuario. El valor de user_ref_attr se utiliza para obtener valores del atributo especificado en el directorio de usuarios y colocarlos en lugar del %{ref} marcador de posición en la cadena group_filter.Ejemplos: cn , uid, miembro, uniqueMember Comportamiento de la propiedad: - compatible si idp_type está configurado en " Directorio de usuarios de tipo LDAP" |
| Propiedades específicas de SAML: | ||
| idp_entityid | cadena | URI que identifica al proveedor de identidad y se utiliza para comunicarse con el proveedor de identidad en mensajes SAML. Ejemplo: https://idp.example.com/idp <br >Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sp_entityid | cadena | URL o cualquier cadena que identifique al proveedor de servicios del proveedor de identidad. Ejemplos: https://idp.example.com/sp zabbix Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| username_attribute | cadena | Atributo del directorio de usuarios SAML (también atributo SCIM si scim_status está configurado en "El aprovisionamiento SCIM está habilitado") que contiene el nombre de usuario del usuario que se compara con el valor del objeto de usuario propiedad nombre de usuario al autenticarse.Ejemplos: uid, userprincipalname, samaccountname, username, userusername, urn:oid:0.9. 2342.19200300.100.1.1, urn:oid:1.3.6.1.4.1.5923.1.1.1.13, urn:oid:0.9.2342.19200300.100.1.44 Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sso_url | cadena | URL del servicio de inicio de sesión único SAML del proveedor de identidad, al que Zabbix enviará las solicitudes de autenticación SAML. Ejemplo: http://idp.example.com/idp/sso/ saml Comportamiento de la propiedad: - obligatorio si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| slo_url | cadena | URL del servicio de cierre de sesión único SAML del proveedor de identidad, al que Zabbix enviará las solicitudes de cierre de sesión SAML. Ejemplo: https://idp.example.com/idp/slo/ saml Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| encrypt_nameid | entero | Si el ID del nombre SAML debe cifrarse. Valores posibles: 0 - (predeterminado) No cifrar el ID del nombre; 1: cifrar el ID del nombre.<br > Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| encrypt_assertions | integer | Si las aserciones SAML deben cifrarse. Valores posibles: 0 - (predeterminado) No cifrar las aserciones; 1: cifrar las aserciones. <br >Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| nameid_format | cadena | Formato de ID de nombre del proveedor de servicios del proveedor de identidad SAML. Ejemplos: urn:oasis:names:tc:SAML:2.0:nameid-format:persistent * urna:oasis:names:tc:SAML:2.0:nameid-format:transient urna:oasis:names:tc:SAML:2.0:nameid-format:kerberos urna:oasis:names: tc:SAML:2.0:nameid-format:entity Comportamiento de la propiedad: - compatible* si idp_type está configurado en " Directorio de usuarios de tipo SAML" |
| scim_status | entero | Si el aprovisionamiento SCIM para SAML está habilitado o deshabilitado. Valores posibles: 0 - (predeterminado) El aprovisionamiento SCIM está deshabilitado; 1 - El aprovisionamiento SCIM está habilitado.< br> Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sign_assertions | entero | Si las aserciones SAML deben firmarse con una firma SAML. Valores posibles: 0 - (predeterminado) No firmar aserciones; 1 - Firmar aserciones.< br> Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sign_authn_requests | entero | Si las solicitudes de AuthN SAML deben firmarse con una firma SAML. Valores posibles: 0 - (predeterminado) No firmar solicitudes de AuthN; 1 - Firmar AuthN solicitudes. Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sign_messages | entero | Si los mensajes SAML deben firmarse con una firma SAML. Valores posibles: 0 - (predeterminado) No firmar mensajes; 1 - Firmar mensajes.< br> Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sign_logout_requests | entero | Si las solicitudes de cierre de sesión de SAML deben firmarse con una firma SAML. Valores posibles: 0 - (predeterminado) No firmar solicitudes de cierre de sesión; 1 - Firmar cierre de sesión solicitudes. Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
| sign_logout_responses | entero | Si las respuestas de cierre de sesión de SAML deben firmarse con una firma SAML. Valores posibles: 0 - (predeterminado) No firmar las respuestas de cierre de sesión; 1 - Firmar cierre de sesión respuestas. Comportamiento de la propiedad: - compatible si idp_type está configurado en "Directorio de usuario de tipo SAML" |
Asignaciones de tipos de medios
El objeto de asignaciones de tipos de medios tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| userdirectory_mediaid | ID | ID de asignación de tipo de medio. Comportamiento de la propiedad: - solo lectura |
| nombre | cadena | Nombre visible en la lista de asignaciones de tipos de medios. Comportamiento de la propiedad: - requerido |
| mediatypeid | ID | ID del tipo de medio que se creará; utilizado como valor para la propiedad Objeto multimedia mediatypeid.Comportamiento de la propiedad: - obligatorio |
| atributo | cadena | Atributo del directorio de usuarios LDAP/SAML (también atributo SCIM si scim_status está configurado en "El aprovisionamiento SCIM está habilitado") que contiene los medios del usuario (por ejemplo, [email protected]) que se utiliza como valor para la propiedad objeto multimedia sendto.Si está presente en los datos recibidos del proveedor de identidad LDAP/SAML y el valor no está vacío, esto activará la creación de medios para el usuario aprovisionado. Comportamiento de la propiedad: - requerido |
| activo | entero | Valor de propiedad activo de los medios de usuario cuando se crean los medios para el usuario aprovisionado.Valores posibles: 0 - (predeterminado) habilitado; 1 - deshabilitado. |
| severidad | entero | Valor de la propiedad severity de los medios de usuario cuando se crean los medios para el usuario aprovisionado.Valor predeterminado: 63. |
| period | cadena | Valor de propiedad period de medios de usuario cuando se crean medios para el usuario aprovisionado.Predeterminado: 1-7,00:00-24:00. |
Asignaciones de grupos de aprovisionamiento
Las asignaciones de grupos de aprovisionamiento tienen las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| nombre | cadena | Nombre completo de un grupo (p. ej., administradores de Zabbix) en el directorio de usuarios LDAP/SAML (también SCIM si scim_status está configurado en "El aprovisionamiento SCIM está habilitado").Admite el carácter comodín " *". Único en todas las asignaciones de grupos de aprovisionamiento. Comportamiento de la propiedad: - obligatorio |
| roleid | ID | ID de la función de usuario que se asignará al usuario. Si coinciden varias asignaciones de grupos de aprovisionamiento, la función del tipo de usuario más alto (Usuario, Administrador o Superadministrador ) se asigna al usuario. Si hay varios roles con el mismo tipo de usuario, el primer rol (ordenado alfabéticamente) se asigna al usuario. Comportamiento de la propiedad:< br>- obligatorio |
| user_groups | array | Matriz de objetos de ID de grupo de usuarios de Zabbix. Cada objeto tiene las siguientes propiedades:usrgrpid - (ID) ID del grupo de usuarios de Zabbix para asignar al usuario.Si coinciden varias asignaciones de grupos de aprovisionamiento, los grupos de usuarios de Zabbix de todos coinciden las asignaciones se asignan al usuario. Comportamiento de la propiedad: - obligatorio |