SSSD-LDAP(5) | Formatos de archivo y convenci | SSSD-LDAP(5) |
NAME¶
sssd-ldap - Proveedor SSSD LDAP
DESCRIPCION¶
Esta página de manual describe la configuración de dominios LDAP para sssd(8). Vea la sección “FILE FORMAT” de la página de manual sssd.conf(5) para información detallada de la sintáxis.
Puede configurar SSSD para usar más de un dominio LDAP.
LDAP back end supports id, auth, access and chpass providers. If you want to authenticate against an LDAP server either TLS/SSL or LDAPS is required. sssd does not support authentication over an unencrypted channel. Even if the LDAP server is used only as an identity provider, an encrypted channel is strongly recommended. Please refer to “ldap_access_filter” config option for more information about using LDAP as an access provider.
OPCIONES DE CONFIGURACIÓN¶
Todas las opciones comunes de configuración que se aplican a los dominios SSSD tambien se aplican a los dominios LDAP. Vea la sección “DOMAIN SECTIONS” de la página de manual sssd.conf(5) para todos los detalles. Advierta que los atributos de mapeo SSSD LDAP están descritos en la página de manual sssd-ldap-attributes(5).
ldap_uri, ldap_backup_uri (string)
El formato de la URI debe coincidir con el formato definido en RFC 2732:
ldap[s]://<host>[:port]
Para direcciones IPv6 explícitas, <host> debe estar entre corchetes []
ejemplo: ldap://[fc00::126:25]:389
ldap_chpass_uri, ldap_chpass_backup_uri (cadena)
Para habilitar el servicio descubrimiento ldap_chpass_dns_service_name debe ser establecido.
Por defecto: vacio, esto es ldap_uri se está usando.
ldap_search_base (cadena)
Desde SSSD 1.7.0, SSSD soporta múltiples bases de búsqueda usando la sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
El alcance puede ser uno de “base”, “onlevel” o “subtree”.
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Ejemplos:
ldap_search_base = dc=example,dc=com (que es equivalente a) ldap_search_base = dc=example,dc=com?subtree?
ldap_search_base = cn=host_specific,dc=example,dc=com?subtree?(host=thishost)?dc=example.com?subtree?
Nota: No está soportado tener múltiples bases de búsqueda que se referencien a objetos nombrados idénticamente (por ejemplo, grupos con el mismo nombre en dos bases de búsqueda diferentes). Esto llevara a comportamientos impredecibles sobre máquinas cliente.
Por defecto: no se fija, se usa el valor de los atributos defaultNamingContext o namingContexts de RootDSE del servidor LDAP usado. Si defaultNamingContext no existe o tiene un valor vacío se usa namingContexts. El atributo namingContexts debe tener un único valor con el DN de la base de búsqueda del servidor LDAP para hacer este trabajo. No se soportan múltiples valores.
ldap_schema (cadena)
Cuatro tipos de esquema son actualmente soportados:
La principal diferencia entre estos tipos de esquemas es como las afiliaciones de grupo son grabadas en el servidor. Con rfc2307, los miembros de grupos son listados por nombre en el atributo memberUid. Con rfc2307bis e IPA, los miembros de grupo son listados por DN y almacenados en el atributo member. El tipo de esquema AD fija los atributos para corresponderse con los valores Active Directory 2008r2.
Predeterminado: rfc2307
ldap_pwmodify_mode (cadena)
Actualmente se soportan dos modos:
Aviso: Primero, se establece una nueva conexión para verificar la contraseña acutal uniendo con el usuario que ha pedido el cambio de contraseña. Si tiene éxito, esta conexión se usa para el cambio de contraseña por lo tanto el usuario debe haber escrito el atributo de acceos a userPassword.
Predeterminado: exop
ldap_default_bind_dn (cadena)
ldap_default_authtok_type (cadena)
Los dos mecanismos actualmente soportados son:
contraseña
obfuscated_password
Por defecto: contraseña
See the sss_obfuscate(8) manual page for more information.
ldap_default_authtok (cadena)
ldap_force_upper_case_realm (boolean)
Predeterminado: false
ldap_enumeration_refresh_timeout (entero)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 300
ldap_purge_cache_timeout (entero)
Estableciendo esta opción a cero deshabilitará la operación de limpieza del caché. Por favor advierta que si la enumeración está habilitada, se requiere la tarea de limpieza con el objetivo de detectar entradas borradas desde el servidor y no pueden ser deshabilitadas. Por defecto, la tarea de limpieza correrá cada tres horas con la enumeración habilitada.
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 0 (deshabilitado)
ldap_group_nesting_level (entero)
Aviso: Esta opción especifica el nivel garantizado d grupos anidados a ser procesados para cualquier búsqueda. Sin embargo, los grupos anidados detrás de este límite pueden ser devueltos si las búsquedas anteriores ya resueltas en os niveles más profundos de anidamiento. También, las búsquedas subsiguientes para otros grupos pueden agrandar el conjunto de resultados de la búsqueda origina si se requiere.
Si ldap_group_nesting_level está establecido a 0 no se procesan de ninguna manera grupos anidados. Sin embargo, cuando está conectado a Active-Directory Server 2008 y posteriores usando “id_provider=ad” se recomienda además deshabilitar la utilización de Token-Groups estableciendo ldap_use_tokengroups a false con el objetivo de restringir el anidamiento de grupos.
Predeterminado: 2
ldap_use_tokengroups
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: True para AD e IPA en otro caso False.
ldap_host_search_base (cadena)
Vea “ldap_search_base” para información sobre la configuración de múltiples bases de búsqueda.
Predeterminado: el valor de ldap_search_base
ldap_service_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_iphost_search_base (string)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_ipnetwork_search_base (string)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_search_timeout (entero)
Nota: esta opción será sujeto de cambios en las futuras versiones del SSSD. Probablemente será sustituido en algunos puntos por una serie de tiempos de espera para tipos específicos de búsqueda.
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 6
ldap_enumeration_search_timeout (entero)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 60
ldap_network_timeout (entero)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 6
ldap_opt_timeout (entero)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 8
ldap_connection_expire_timeout (entero)
If the connection is idle (not actively running an operation) within ldap_opt_timeout seconds of expiration, then it will be closed early to ensure that a new query cannot require the connection to remain open past its expiration. This implies that connections will always be closed immediately and will never be reused if ldap_connection_expire_timeout <= ldap_opt_timout
This timeout can be extended of a random value specified by ldap_connection_expire_offset
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 900 (15 minutos)
ldap_connection_expire_offset (integer)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 0
ldap_connection_idle_timeout (integer)
You can disable this timeout by setting the value to 0.
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 900 (15 minutos)
ldap_page_size (entero)
Predeterminado: 1000
ldap_disable_paging (booleano)
Ejemplo: los servidores OpenLDAP con el módulo de control de paginación instalado sobre el servidor pero no habilitado lo reportarán en el RootDSE pero es incapaz de usarlo.
Ejemplo: 389 DS tiene un bug donde puede sólo soportar un control de paginación a la vez en una única conexión. Sobre clientes ocupados, esto puede ocasionar que algunas peticiones sean denegadas.
Por defecto: False
ldap_disable_range_retrieval (booleano)
Active Directory limita el número de miembros a recuperar en una única búsqueda usando la política MaxValRange (que está predeterminada a 1500 miembros). Si un grupo contiene mas miembros, la replica incluiría una extensión de rango específica AD. Esta opción deshabilita el análisis de la extensión del rango, por eso grupos grandes aparecerán como si no tuvieran miembros.
Por defecto: False
ldap_sasl_minssf (entero)
Por defecto: Usa el sistema por defecto (normalmente especificado por ldap.conf)
ldap_sasl_maxssf (integer)
Por defecto: Usa el sistema por defecto (normalmente especificado por ldap.conf)
ldap_deref_threshold (entero)
Puede desactivar las búsquedas de desreferencia completamente estableciendo el valor a 0. Tenga en cuenta que hay algunas rutas de código en SSSD, como el proveedor IPA HBAC, que solo son implementadas usando la llamada de desreferencia, de modo que solo con la desreferencia explícitamente deshabilitada aquellas partes usarán todavía la desreferencia si el servidor lo soporta y auncia el control de la desreferencia en el objeto rootDSE.
Una búsqueda dereference es un medio de descargar todos los miembros del grupo en una única llamada LDAP. Servidores diferentes LDAP pueden implementar diferentes métodos dereference. Los servidores actualmente soportados son 389/RHDS, OpenLDAP y Active Directory.
Nota: Si alguna de las bases de búsqueda especifica un filtro de búsqueda, la mejora del rendimiento de la búsqueda dereference será deshabilitado sin tener en cuenta este ajuste.
Predeterminado: 10
ldap_ignore_unreadable_references (bool)
This parameter may be useful when using the AD provider and the computer account that sssd uses to connect to AD does not have access to a particular entry or LDAP sub-tree for security reasons.
Por defecto: False
ldap_tls_reqcert (cadena)
never = El cliente no pedirá o comprobará ningún certificado de servidor.
allow = Se pide el certificado del servidor. Si no se suministra certificado, la sesión sigue normalmente. Si se suministra un certificado malo, será ignorado y la sesión continua normalmente.
try = Se pide el certificado del servidor. Si no se suministra certificado, la sesión continua normalmente. Si se suministra un certificado malo, la sesión se termina inmediatamente.
demand = Se pide el certificado del servidor. Si no se suministra certificado, o se suministra un certificado malo, la sesión se termina inmediatamente.
hard = Igual que “demand”
Predeterminado: hard
ldap_tls_cacert (cadena)
Por defecto: use los valores por defecto OpenLDAP, normalmente en /etc/openldap/ldap.conf
ldap_tls_cacertdir (cadena)
Por defecto: use los valores por defecto OpenLDAP, normalmente en /etc/openldap/ldap.conf
ldap_tls_cert (cadena)
Predeterminado: no definido
ldap_tls_key (cadena)
Predeterminado: no definido
ldap_tls_cipher_suite (cadena)
Por defecto: use los valores por defecto OpenLDAP, normalmente en /etc/openldap/ldap.conf
ldap_id_use_start_tls (booleano)
Predeterminado: false
ldap_id_mapping (booleano)
Actualmente está función soporta sólo mapeos de objectSID de ActiveDirectory.
Predeterminado: false
ldap_min_id, ldap_max_id (entero)
Predeterminado: no establecido (ambas opciones se establecen a 0)
ldap_sasl_mech (cadena)
Si el backend admite subdominios el valor de ldap_sasl_mech es heredado automáticamente por los subdominios. Si se necesita un valor diferente para un subdominio puede ser sobrescrito estabeciendo ldap_sasl_mech para este subdominio explícitamente. Por favor vea la SECCIÓN DOMINIO DE CONFIANZA es sssd.conf(5) para más detalles.
Predeterminado: no definido
ldap_sasl_authid (cadena)
hostname@REALM netbiosname$@REALM host/hostname@REALM *$@REALM host/*@REALM host/*
Si no se encuentra ninguno de ellos, se devuelve en primer principal en la pestaña.
Por defecto: host/nombre_de_host@REALM
ldap_sasl_realm (string)
Por defecto: el valor de krb5_realm.
ldap_sasl_canonicalize (boolean)
Predeterminado: false;
ldap_krb5_keytab (cadena)
This option can be also set per subdomain or inherited via subdomain_inherit.
Por defecto: Keytab del sistema, normalmente /etc/krb5.keytab
ldap_krb5_init_creds (booleano)
Predeterminado: true
ldap_krb5_ticket_lifetime (entero)
This option can be also set per subdomain or inherited via subdomain_inherit.
Predeterminado: 86400 (24 horas)
krb5_server, krb5_backup_server (cadena)
Cuando se utiliza el servicio descubiertos para servidores KDC o kpasswd, SSSD primero busca entradas DNS que especifiquen _udop como protocolo y regresa a _tcp si no se encuentra nada.
Este opción se llamaba “krb5_kdcip” en las revisiones más tempranas de SSSD. Mientras el legado de nombre se reconoce por el tiempo que sea, los usuarios son advertidos para migrar sus ficheros de configuración para usar “krb5_server” en su lugar.
krb5_realm (cadena)
Predeterminado: Predeterminados del sistema, vea /etc/krb5.conf
krb5_canonicalize (boolean)
Predeterminado: false
krb5_use_kdcinfo (booleano)
Vea la página de manual sssd_krb5_locator_plugin(8) para más información sobre el complemento localizador.
Predeterminado: true
ldap_pwd_policy (cadena)
none - Sin evaluación en el lado cliente. Esta opción no puede deshabilitar las políticas de password en el lado servidor.
shadow - Use shadow(5) style attributes to evaluate if the password has expired. Please see option "ldap_chpass_update_last_change" as well.
mit_kerberos - Usa los atributos utilizados por MIT Kerberos para determinar si el password ha expirado. Use chpass_provider=krb5 para actualizar estos atributos cuando se cambia el password.
Predeterminado: none
Aviso: si está configurada una política de contraseña en el lado del servidor siempre tiene prioridad sobre la política establecida por esta opción.
ldap_referrals (boolean)
Por favor advierta que sssd sólo soporta seguimiento de referencias cuando está compilado con OpenLDAP versión 2.4.13 o más alta.
Chasing referrals may incur a performance penalty in environments that use them heavily, a notable example is Microsoft Active Directory. If your setup does not in fact require the use of referrals, setting this option to false might bring a noticeable performance improvement. Setting this option to false is therefore recommended in case the SSSD LDAP provider is used together with Microsoft Active Directory as a backend. Even if SSSD would be able to follow the referral to a different AD DC no additional data would be available.
Predeterminado: true
ldap_dns_service_name (cadena)
Predeterminado: ldap
ldap_chpass_dns_service_name (cadena)
Por defecto: no fijado, esto es servicio descubridor deshabilitado.
ldap_chpass_update_last_change (booleano)
It is recommend to set this option explicitly if "ldap_pwd_policy = shadow" is used to let SSSD know if the LDAP server will update shadowLastChange LDAP attribute automatically after a password change or if SSSD has to update it.
Por defecto: False
ldap_access_filter (cadena)
Ejemplo:
access_provider = ldap ldap_access_filter = (employeeType=admin)
Este ejemplo significa que el acceso a este host está restringido a los usuarios cuyo atributo employeeType esté establecido a "admin".
El almacenamiento en caché sin conexión para esta función está limitado a determinar si el último inicio de sesión del usuario recibió permiso de acceso. Si obtuvieron permiso de acceso durante su último inicio de sesión, se les seguirán otorgando acceso sin conexión y viceversa.
Predeterminado: vacío
ldap_account_expire_policy (cadena)
Por favor advierta que siempre se recomienda utilizar el control de acceso del lado servidor, esto es el servidor LDAP denegaría petición de enlace con una código de error definible aunque el password sea correcto.
Los siguientes valores están permitidos:
shadow: usa el valor de ldap_user_shadow_expire para determinar si la cuenta ha expirado.
ad: usa el valor del campo de 32 bit ldap_user_ad_user_account_control y permite el acceso si el segundo bit no está fijado. Si el atributo está desaparecido se concede el acceso. También se comprueba el tiempo de expiración de la cuenta.
rhds, ipa, 389ds: usa el valor de ldap_ns_account_lock para comprobar si se permite el acceso o no.
nds: los valores de ldap_user_nds_login_allowed_time_map, ldap_user_nds_login_disabled y ldap_user_nds_login_expiration_time se usan para comprobar si el acceso está permitido. Si ambos atributos están desaparecidos se concede el acceso.
Por favor advierta que la opción de configuración ldap_access_order debe incluir “expire” con el objetivo de la opción ldap_account_expire_policy funcione.
Predeterminado: vacío
ldap_access_order (cadena)
filtro: utilizar ldap_access_filter
lockout: usar bloqueo de cuenta. Si se establece, esta opción deniega el acceso en el caso de que el atributo ldap 'pwdAccountLockedTime' esté presente y tenga un valor de '000001010000Z'. Por favor vea la opción ldap_pwdlockout_dn. Por favor advieta que 'access_provider = ldap' debe ser establecido para que está característica funciones.
Por favor tenga en cuenta que esta opción es reemplazada por la opción “ppolicy” y puede ser quitada en un futuro lanzamiento.
ppolicy: usar bloqueo de cuenta. Si se establece, esta opción deniega el acceso en el caso de que el atributo ldap 'pwdAccountLockedTime' esté presente y tenga un valor de '000001010000Z' o represente cualquier momento en el pasado. El valor del atributo 'pwdAccountLockedTime' debe terminar con 'Z', que denota la zona horaria UTC. Otras zonas horarias no se soportan actualmente y llevarán a "access-denied" cuando los usuarios intenten acceder. Por favor vea la opción ldap_pwdlockout_dn. Por favor advierta que 'access_provider = ldap' debe estar establecido para que esta característica funcione.
caducar: utilizar ldap_account_expire_policy
pwd_expire_policy_reject, pwd_expire_policy_warn, pwd_expire_policy_renew: Estas opciones son útiles si los usuarios están interesados en que se les avise de que la contraseña está próxima a expirar y la autenticación está basada en la utilización de un método distinto a las contraseñas - por ejemplo claves SSH.
The difference between these options is the action taken if user password is expired:
Por favor advierta que 'access_provider = ldap' debe estar establecido para que esta función trabaje. También 'ldap_pwd_policy' debe estar establecido para una política de contraseña apropiada.
authorized_service: utilizar el atributo autorizedService para determinar el acceso
host: usa el atributo host para determinar el acceso
rhost: usar el atributo rhost para determinar si el host remoto puede acceder
Por favor advierta el campo rhost en pam es establecido por la aplicación, es mejor comprobar que la aplicación lo envía a pam, antes de habilitar esta opción de control de acceso
Predeterminado: filter
Tenga en cuenta que es un error de configuración si un valor es usado más de una vez.
ldap_pwdlockout_dn (cadena)
Ejemplo: cn=ppolicy,ou=policies,dc=example,dc=com
Predeterminado: cn=ppolicy,ou=policies,$ldap_search_base
ldap_deref (cadena)
never: Nunca serán eliminadas las referencias al alias.
searching: Las referencias al alias son eliminadas en subordinadas del objeto base, pero no en localización del objeto base de la búsqueda.
finding: Sólo se eliminarán las referencias a alias cuando se localice el objeto base de la búsqueda.
always: Las referencias al alias se eliminarán tanto para la búsqueda como en la localización del objeto base de la búsqueda.
Por defecto: Vacío (esto es manejado como nunca por las librerías cliente LDAP)
ldap_rfc2307_fallback_to_local_users (boolean)
En algunos entornos donde se usa el esquema RFC2307, los usuarios locales son hechos miembros de los grupos LDAP añadiendo sus nombres al atributo memberUid. La autoconsistencia del dominio se ve comprometida cuando se hace esto, de modo que SSSD debería normalmente quitar los usuarios “desparecidos” de las afiliaciones a grupos escondidas tan pronto como nsswitch intenta ir a buscar información del usuario por medio de las llamadas getpw*() o initgroups().
Esta opción cae de nuevo en comprobar si los usuarios locales están referenciados, y los almacena en caché de manera que más tarde las llamadas initgroups() aumentará los usuarios locales con los grupos LDAP adicionales.
Predeterminado: false
wildcard_limit (entero)
En este momento solo el respondedor InfoPipe soporta búsqueda de comodín
Predeterminado: 1000 (frecuentemente el tamaño de una página)
ldap_library_debug_level (integer)
OpenLDAP uses a bitmap to enable debugging for specific components, -1 will enable full debug output.
Default: 0 (libldap debugging disabled)
OPCIONES SUDO¶
Las instrucciones detalladas para la configuración de sudo_provider están en la página de manual sssd-sudo(5).
ldap_sudo_full_refresh_interval (entero)
El valor debe ser mayor que ldap_sudo_smart_refresh_interval
You can disable full refresh by setting this option to 0. However, either smart or full refresh must be enabled.
Por defecto: 21600 (6 horas)
ldap_sudo_smart_refresh_interval (entero)
Si los atributos USN no se soportan por el servidor, se usa en su lugar el atributo modifyTimestamp.
Aviso: el valor más alto de USN puede ser actualizado por tres tareas: 1) Por una actualización total o inteligente de sudo (si se encuentran reglas actualizadas), 2) por la enumeración de usuarios y grupos (si se encuentran usuarios y grupos habilitados y actualizados) y 3) reconectando con el servidor (por defecto cada 15 minutos, vea ldap_connection_expire_timeout).
You can disable smart refresh by setting this option to 0. However, either smart or full refresh must be enabled.
Predeterminado: 900 (15 minutos)
ldap_sudo_random_offset (integer)
Note that this random offset is also applied on the first SSSD start which delays the first sudo rules refresh. This prolongs the time when the sudo rules are not available for use.
You can disable this offset by setting the value to 0.
Predeterminado: 0 (deshabilitado)
ldap_sudo_use_host_filter (booleano)
Predeterminado: true
ldap_sudo_hostnames (cadena)
Si esta opción está vacía, SSSD intentará descubrir el nombre de host y el nombre de dominio totalmente cualificado automáticamente.
Si ldap_sudo_use_host_filter es false esta opción no tiene efecto.
Por defecto: no especificado
ldap_sudo_ip (cadena)
esta opción está vacía, SSSD intentará descrubrir las direcciones automáticamente.
Si ldap_sudo_use_host_filter es false esta opción no tiene efecto.
Por defecto: no especificado
sudo_include_netgroups (booleano)
Si ldap_sudo_use_host_filter es false esta opción no tiene efecto.
Predeterminado: true
ldap_sudo_include_regexp (booleano)
Si ldap_sudo_use_host_filter es false esta opción no tiene efecto.
Note
¡Usar comodines es una operación que es muy costosa de evaluar en el lado del servidor LDAP!
Esta página de manual sólo describe el atributo de nombre mapping. Para una explicación detallada de la semántica del atributo relacionada con sudo, vea sudoers.ldap(5)
OPCIONES AUTOFS¶
Algunos de los valores por defecto para los parámetros de abajo dependen del esquema LDAP.
ldap_autofs_map_master_name (cadena)
Pfredeterminado: auto.master
ldap_autofs_map_object_class (cadena)
Predeterminado: nisMap (rfc2307, autofs_provider=ad), de otra manera automountMap
ldap_autofs_map_name (cadena)
Predeterminado: nisMapName (rfc2307, autofs_provider=ad), de otra manera automountMapName
ldap_autofs_entry_object_class (cadena)
Predeterminado: nisObject (rfc2307, autofs_provider=ad), de otra manera automount
ldap_autofs_entry_key (cadena)
Predeterminado: cn (rfc2307, autofs_provider=ad), de otra manera automountKey
ldap_autofs_entry_value (cadena)
Predeterminado: nisMapEntry (rfc2307, autofs_provider=ad), de otra manera automountInformation
Por favor advierta que el automontador sólo lee el mapa maestro en el arranque, se modo que si se hace cualquier cambio relacionado con autofs al sssd.conf, usted normalmente también necesitará reiniciar el demonio automontador después de reiniciar el SSSD.
OPCIONES AVANZADAS¶
Estas opciones están soportadas por dominios LDAP, pero deberían ser usadas con precaución. Por favor incluyalas en su configuración si usted sabe lo que está haciendo.
ldap_netgroup_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_user_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_group_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
Note
Si la opción “ldap_use_tokengroups” está habilitada, las búsquedas contra Active Directory no serán restringidas y devolverán todos los grupos miembros, incluso sin mapeo GID. Se recomienda deshabilitar esta función, si los nombres de grupo no están siendo visualizados correctamente.
ldap_sudo_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
ldap_autofs_search_base (cadena)
sintaxis:
search_base[?scope?[filter][?search_base?scope?[filter]]*]
The scope can be one of "base", "onelevel" or "subtree". The scope functions as specified in section 4.5.1.2 of http://tools.ietf.org/html/rfc4511
El filtro debe ser un filtro de búsqueda LDAP válido como se especifica en http://www.ietf.org/rfc/rfc2254.txt
Para ejemplos de esta sintaxis, por favor vea la sección de ejemplos de “ldap_search_base”
Predeterminado: el valor de ldap_search_base
Por favor advierta que especificar el alcance o el filtro no está soportado para búsquedas contra un Active Directory Server que puede ceder un gran número de resultados y disparar la extensión Range Retrieval en la respuesta.
CONMUTACIÓN POR ERROR¶
La función conmutación en error permite a los finales conmutar automáticamente a un servidor diferente si el servidor actual falla.
Sintaxis de conmutación por error¶
La lista de servidores se da como una lista separada por comas; se permite cualquier número de espacios a los lados de la coma. Los servidores son listados en orden de preferencia. La lista puede contener cualquier número de servidores.
For each failover-enabled config option, two variants exist: primary and backup. The idea is that servers in the primary list are preferred and backup servers are only searched if no primary servers can be reached. If a backup server is selected, a timeout of 31 seconds is set. After this timeout SSSD will periodically try to reconnect to one of the primary servers. If it succeeds, it will replace the current active (backup) server.
El mecanismo de conmutación por errorEl mecanismo de failover distingue entre una máquina y un servicio. El punto final intenta primero resolver el nombre de host de una máquina dada; si el intento de resolución falla, la máquina es considerada fuera de línea. No se harán más intentos de conexión con esta máquina para ningún otro servicio. Si el intento de resolución tiene éxito, el punto final intenta conectar a un servicio en esa máquina. Si el intento de conexión al servicio falla, entonces sólo se considera fuera de línea este servicio concreto y el punto final conmutará automáticamente sobre el siguientes servicio. La máquina se considera que sigue en línea y se puede intentar el acceso a otros servicios.¶
El mecanismo de conmutación por error distingue entre una máquina y un servicio. El punto final intenta primero resolver el nombre de host de una máquina dada; si el intento de resolución falla, la máquina es considerada fuera de línea. No se harán más intentos de conexión con esta máquina para ningún otro servicio. Si el intento de resolución tiene éxito, el punto final intenta conectar a un servicio en esa máquina. Si el intento de conexión al servicio falla, entonces sólo se considera fuera de línea este servicio concreto y el punto final conmutará automáticamente sobre el siguientes servicio. La máquina se considera que sigue en línea y se puede intentar el acceso a otros servicios.
Los intentos de conexión adicionales son hechos a máquinas o servicios marcaros como fuera de línea después de un período de tiempo especificado; esto está codificado a fuego actualmente en 30 segundos.
Si no hay más máquinas para intentarlo, el punto final al completo conmutará al modo fuera de línea y después intentará reconectar cada 30 segundo.
Failover time outs and tuning¶
Resolving a server to connect to can be as simple as running a single DNS query or can involve several steps, such as finding the correct site or trying out multiple host names in case some of the configured servers are not reachable. The more complex scenarios can take some time and SSSD needs to balance between providing enough time to finish the resolution process but on the other hand, not trying for too long before falling back to offline mode. If the SSSD debug logs show that the server resolution is timing out before a live server is contacted, you can consider changing the time outs.
This section lists the available tunables. Please refer to their description in the sssd.conf(5), manual page.
dns_resolver_server_timeout
Predeterminado: 1000
dns_resolver_op_timeout
Predeterminado: 3
dns_resolver_timeout
Predeterminado: 6
For LDAP-based providers, the resolve operation is performed as part of an LDAP connection operation. Therefore, also the “ldap_opt_timeout” timeout should be set to a larger value than “dns_resolver_timeout” which in turn should be set to a larger value than “dns_resolver_op_timeout” which should be larger than “dns_resolver_server_timeout”.
SERVICIO DE DESCUBRIMIENTO¶
La función servicio descubridor permite a los puntos finales encontrar automáticamente los servidores apropiados a conectar para usar una pregunta especial al DNS. Esta función no está soportada por los servidores de respaldo.
Configuración¶
Si no se especifican servidores, el punto final usar automáticamente el servicio descubridor para intentar encontrar un servidor. Opcionalmente, el usuario puede elegir utilizar tanto las direcciones de servidor fijadas como el servicio descubridor para insertar una palabra clave especial, “_srv_”, en la lista de servidores. El orden de preferencia se mantiene. Esta función es útil sí, por ejemplo, el usuario prefiere usar el servicio descubridor siempre que sea posible, el volver a un servidor específico cuando no se pueden descubrir servidores usando DNS.
El nombre de dominio¶
Por favor vea el parámetro “dns_discovery_domain” en la página de manual sssd.conf(5) para más detalles.
El protocolo¶
Las consultas normalmente especifican _tcp como protocolo. Las excepciones se documentan en la descripción de la opción respectiva.
Vea también¶
Para más información sobre el mecanismo del servicio descubridor, vea el RFC 2782.
ASIGNACIÓN DE ID¶
La función asignación de ID permite a SSSD actuar como un cliente de Active Directory sin requerir de administradores para extender los atributos de usuario para soportar atributos POSIX para los identificadores de usuario y grupo.
NOTA: Cuando asignación de ID está habilitado, los atributos uidNumber y gidNumber son ignorados. Esto es para evitar la posibilidad de conflictos entre los valores automáticamente asignados y los asignados manualmente. Si usted necesita usar los valore asignados manualmente, TODOS los valores deben ser asignados manualmente.
Please note that changing the ID mapping related configuration options will cause user and group IDs to change. At the moment, SSSD does not support changing IDs, so the SSSD database must be removed. Because cached passwords are also stored in the database, removing the database should only be performed while the authentication servers are reachable, otherwise users might get locked out. In order to cache the password, an authentication must be performed. It is not sufficient to use sss_cache(8) to remove the database, rather the process consists of:
Moreover, as the change of IDs might necessitate the adjustment of other system properties such as file and directory ownership, it's advisable to plan ahead and test the ID mapping configuration thoroughly.
Algoritmo de asignación¶
Active Directory suministra un objectSID para cada objeto usuario y grupo en el directorio. El objectSID puede ser dividido en componente que representan la identidad del dominio Active Directory y le identificador relativo (RID) del objeto usuario y grupo.
El algoritmo de asignación de ID de SSSD tiene un rango de UIDs disponibles y lo divide en secciones componente de igual tamaño – llamadas “rebanadas” -. Cada rebanada representa el espacio disponible para un dominio Active Directory.
Cuando se encuentra por primera vez una entrada de usuario o grupo para un dominio concreto, SSSD asigna una de las rebanadas disponibles para ese dominio. Con el objetivo de hacer esta asignación de rebanadas repetible sobre diferentes máquinas clientes, seleccionamos la rebanada en base al siguiente algoritmo:
La cadena SID pasada a través del algoritmo murmurhash3 para convertirlo en un valor picado de 32 bit. Después tomamos los módulos de este valor con el número total de rebanadas disponibles para recoger la rebanada.
NOTA: Es posible encontrar colisiones en el picadillo y los módulos subsiguientes. En estas situaciones, seleccionaremos la siguiente rebanada disponible, pero puede no ser posible reproducir los mismos conjuntos exactos de rebanadas sobre otras máquinas (puesto que el orden en que se encuentren desterminará sus rebanadas). En esta situación, se recomienda o bien conmutar para usar los atributos explícitos POSIX en Active Directory (deshabilitando la asignación de ID) o configurar un dominio por defecto para garantizar que al menos uno sea siempre consistente. Vea “Configuración” para detalles.
Configuración¶
Configuración mínima (en la sección “[domain/DOMAINNAME]”):
ldap_id_mapping = True ldap_schema = ad
The default configuration results in configuring 10,000 slices, each capable of holding up to 200,000 IDs, starting from 200,000 and going up to 2,000,200,000. This should be sufficient for most deployments.
Configuración Avanzada
ldap_idmap_range_min (entero)
NOTA: Esta opción es diferente de “min_id” en esta “min_id” actúa para filtrar la salida de las peticiones a este dominio, mientras esta opción controla el rango de la asignación de ID. Esto es una sutil diferencia, pero el buen consejo general sería que “min_id” fuera menor o igual que “ldap_idmap_range_min”
Por defecto: 200000
ldap_idmap_range_max (entero)
NOTA: Esta opción es diferente de “max_id” en esta “max_id” actúa para filtrar la salida de las peticiones a este dominio, mientras esta opción controla el rango de la asignación de ID. Esto es una sutil diferencia, pero el buen consejo general sería que “max_id” fuera menor o igual que “ldap_idmap_range_max”
Por defecto: 2000200000
ldap_idmap_range_size (entero)
NOTE: The value of this option must be at least as large as the highest user RID planned for use on the Active Directory server. User lookups and login will fail for any user whose RID is greater than this value.
For example, if your most recently-added Active Directory user has objectSid=S-1-5-21-2153326666-2176343378-3404031434-1107, “ldap_idmap_range_size” must be at least 1108 as range size is equal to maximal SID minus minimal SID plus one (e.g. 1108 = 1107 - 0 + 1).
It is important to plan ahead for future expansion, as changing this value will result in changing all of the ID mappings on the system, leading to users with different local IDs than they previously had.
Por defecto: 200000
ldap_idmap_default_domain_sid (cadena)
Predeterminado: no definido
ldap_idmap_default_domain (cadena)
Predeterminado: no definido
ldap_idmap_autorid_compat (booleano)
When this option is configured, domains will be allocated starting with slice zero and increasing monotonically with each additional domain.
NOTA: Este algoritmo no es determinista (depende del orden en que usuario y grupos son pedidos). Si se requiere este modo para compatibilidad con máquinas que ejecutan winbind, se recomienda que también use la opción “ldap_idmap_default_domain_sid” para garantizar que al menos un dominio está asignado consistentemente a la rebanada cero.
Por defecto: False
ldap_idmap_helper_table_size (integer)
Note: Additional secondary slices might be generated when SID is being mapped to UNIX id and RID part of SID is out of range for secondary slices generated so far. If value of ldap_idmap_helper_table_size is equal to 0 then no additional secondary slices are generated.
Predeterminado: 10
Well-Known SIDs¶
SSSD supports to look up the names of Well-Known SIDs, i.e. SIDs with a special hardcoded meaning. Since the generic users and groups related to those Well-Known SIDs have no equivalent in a Linux/UNIX environment no POSIX IDs are available for those objects.
The SID name space is organized in authorities which can be seen as different domains. The authorities for the Well-Known SIDs are
The capitalized version of these names are used as domain names when returning the fully qualified name of a Well-Known SID.
Since some utilities allow to modify SID based access control information with the help of a name instead of using the SID directly SSSD supports to look up the SID by the name as well. To avoid collisions only the fully qualified names can be used to look up Well-Known SIDs. As a result the domain names “NULL AUTHORITY”, “WORLD AUTHORITY”, “LOCAL AUTHORITY”, “CREATOR AUTHORITY”, “MANDATORY LABEL AUTHORITY”, “AUTHENTICATION AUTHORITY”, “NT AUTHORITY” and “BUILTIN” should not be used as domain names in sssd.conf.
EJEMPLO¶
El siguiente ejemplo asume que SSSS está configurado correctamente y LDAP está fijado a uno de los dominios de la sección [domains].
[domain/LDAP] id_provider = ldap auth_provider = ldap ldap_uri = ldap://ldap.mydomain.org ldap_search_base = dc=mydomain,dc=org ldap_tls_reqcert = demand cache_credentials = true
EJEMPLO DE FILTRO DE ACCESO LDAP¶
El siguiente ejemplo asume que SSSD está correctamente configurado y usa ldap_access_order=lockout.
[domain/LDAP] id_provider = ldap auth_provider = ldap access_provider = ldap ldap_access_order = lockout ldap_pwdlockout_dn = cn=ppolicy,ou=policies,dc=mydomain,dc=org ldap_uri = ldap://ldap.mydomain.org ldap_search_base = dc=mydomain,dc=org ldap_tls_reqcert = demand cache_credentials = true
NOTAS¶
Las descripciones de algunas de las opciones de configuración en esta página de manual están basadas en la página de manual ldap.conf(5) de la distribución OpenLDAP 2.4.
VEA TAMBIEN¶
sssd(8), sssd.conf(5), sssd-ldap(5), sssd-ldap-attributes(5), sssd-krb5(5), sssd-simple(5), sssd-ipa(5), sssd-ad(5), sssd-sudo(5), sssd-session-recording(5), sss_cache(8), sss_debuglevel(8), sss_obfuscate(8), sss_seed(8), sssd_krb5_locator_plugin(8), sss_ssh_authorizedkeys(8), sss_ssh_knownhostsproxy(8), sssd-ifp(5), pam_sss(8). sss_rpcidmapd(5)
AUTHORS¶
The SSSD upstream - https://github.com/SSSD/sssd/
10/01/2024 | SSSD |