Páginas de manual de SSSD sssd-ipa 5 Formatos de archivo y convenciones sssd-ipa Proveedor SSSD IPA DESCRIPCION Este página de manual describe la configuración del proveedor IPA para sssd 8 . Para una referencia de sintaxis detalladas, vea la sección FILE FORMAT de la página de manual sssd.conf 5 . El proveedor IPA es un back end usado para conectar a un servidor IPA. (Vea el sitio web freeipa.org para información sobre los servidores IPA). Este proveedor requiere que la máquina este unido al dominio IPA; la configuración es casi enteramente auto descubierta y obtenida directamente del servidor. El proveedor IPA habilita a SSSD para usar el proveedor de identidad sssd-ldap 5 y el proveedor de autenticación sssd-krb5 5 con optimizaciones para entornos IPA. El proveedor IPA acepta las mismas opciones que las usadas por los proveedores sssd-ldap y sssd-krb5 con algunas excepciones. Sin embargo, no es necesario ni recomendable establecer estas opciones. El proveedor IPA copia primariamente las opciones por defecto tradicionales de los proveedores ldap y krb5 con algunas excepciones, las diferencias están listadas en la sección OPCIONES PREDETERMINADAS MODIFICADAS. As an access provider, the IPA provider has a minimal configuration (see ipa_access_order) as it mainly uses HBAC (host-based access control) rules. Please refer to freeipa.org for more information about HBAC. Si auth_provider=ipa o access_provider=ipa está configurado en sssd.conf id_provider se debe establecer también a ipa. El porveedor IPA usara el respondedor PAC si las entradas Kerberos de los usuario de reinos confiables contienen un PAC. Para hacer la configuración más fácil el respondedor PAC es iniciado automáticamente si la ID del proveedor IPA está configurada. OPCIONES DE CONFIGURACIÓN Vea la sección DOMAIN SECTIONS de la página de manual sssd.conf 5 para detalles sobre la configuración de un dominio SSSD. ipa_domain (cadena) Especifica el nombre del dominio IPA. Esto es opcional. Si no se suministra, se usa el nombre de configuración del dominio. ipa_server, ipa_backup_server (cadena) La lista separada por comas de direcciones IP o nombres de host de los servidores IPA a los que SSSD se conectaría en orden de preferencia. Para más información sobre conmutación en error y redundancia de servidores, vea la sección FAILOVER. Esto es opcional si autodiscovery está habilitado. Para más información sobre el servicio descubridor, vea la sección SERVICE DISCOVERY. ipa_hostname (cadena) Opcional. Se puede establecer sobre máquinas donde el hostname(5) no refleje el nombre totalmente cualificado usado en el dominio IPA para identificar este host. El nombre de host debe ser totalmente cualificado. dyndns_update (booleano) Opcional. Esta opción le dice a SSSD que actualice automáticamente el servidor DNS incorporado a FreeIPA con la dirección IP de este cliente. La actualización está asegurada utilizando GSS-TSIG. La dirección IP de la conexión IPA LDAP se usa para las actualizaciones, si no se especifica de otra manera utilizando la opción dyndns_iface. NOTA: Sobre sistemas más antiguos (como RHEL 5), para que este comportamiento trabaje fiablemente, el reino por defecto Kerberos debe ser fijado apropiadamente en /etc/krb5.conf AVISO: Aunque todas es posible usar la vieja opción ipa_dyndns_update, los usuarios deberían migrar para usar dyndns_update en su fichero de configuración. Predeterminado: false dyndns_ttl (entero) El TTL a aplicar al registro del cliente DNS cuando lo actualiza. Si dyndns_update está a false esto no tiene efecto. Esto anula el TTL del lado servidor si se establece por un administrador. AVISO: Aunque todavía es posible usar la antigua opción ipa_dyndns_ttl, los usuarios deberían migrar usando dyndns_ttl en su fichero de configuración. Por defecto: 1200 (segundos) dyndns_iface (cadena) Opcional. Aplicable solo cuando dyndns_update está a true. Elija la interfaz o la lista de interfaces cuyas direcciones IP serían usadas para las actualizaciones DNS dinámicas. El valor especial * implica que las IPs de todas las interfaces serían las usadas. AVISO: Aunque todavía es posible usar la vieja opción ipa_dyndns_iface, los usuarios deberían migrar usando dyndns_iface en su fichero de configuración. Predeterminado: Usa las direcciones IP de la interfaz que es usada para la conexión IPA LDAP Ejemplo: dyndns_iface = em1, vnet1, vnet2 dyndns_auth (cadena) Si la utilidad nsupdate debe usar la autenticación GSS-TSIG para actualizaciones seguras con el servidor DNS, las actualizaciones inseguras se pueden enviar fijando esta opción a 'none'. Predeterminado: GSS-TSIG dyndns_auth_ptr (string) Whether the nsupdate utility should use GSS-TSIG authentication for secure PTR updates with the DNS server, insecure updates can be sent by setting this option to 'none'. Default: Same as dyndns_auth ipa_enable_dns_sites (booleano) Habilita sitios DNS - descubrimiento de servicio basado en la ubicación. Si es ciertp y descubrimiento de servicio (vea el párrafo Descubrimiento del Servicio en la parte inferior de la página de manual) está habilitado, SSSD primero intentará la localización basada en el descubrimiento usando una consulta que contenga "_location.hostname.example.com" y después irá al descubrimiento tradicional SRV. Si la localización basada en el descubrimiento tiene éxito, los servidores IPA localizados con la localización basada en el descubrimiento son tratados como servidores primarios y los servidores IPA localizados usando el descubrimiento tradicional SRV son usados como servidores de respaldo Predeterminado: false dyndns_refresh_interval (entero) Con qué frecuencia el back-end debe realizar una actualización periódica de DNS además de la actualización automática que se realiza cuando el back-end se conecta. Esto es una posibilidad opcional y aplicable solo cuando dyndns_update está a true. Predeterminado: 0 (deshabilitado) dyndns_update_ptr (booleano) Si el registro PTR debería ser explícitamente actualizado cuando se actualizan los registros DNS del cliente. Aplicable solo cuando dyndns_update está a true. Esta opción debería estar a False en la mayoría de los despliegues IPA puesto que el servidor IPA genera los registros PTR automáticamente cuando se cambian los registros que envía. Note that dyndns_update_per_family parameter does not apply for PTR record updates. Those updates are always sent separately. Predeterminado: False (deshabilitado) dyndns_force_tcp (booleano) Si la utilidad nsupdate debería usar de manera predeterminada TCP cuando se comunica con el servidor DNS. Predeterminado: False (permitir a nsupdate elegir el protocolol) dyndns_server (cadena) El servidor DNA a usar cuando se lleva a cabo una actualización DNS update. En la mayoría de las configuraciones se recomienda dejar esta opción sin establecer. El establecimiento de esta opción tiene sentido en entornos donde el servidor DNS es distinto del servidor de identidad. Tenga en cuenta que esta opción solo se usará en un intento de recuperación cuando el intento anterior de usar la configuración autodetectada falló. Predeterminado: None (permitir a nsupdate elegir el servidor) dyndns_update_per_family (booleano) La actualización DNS es llevada a cabo de manera predeterminada en dos pasos - actualización IPv4 y después actualización IPv6. En algunos casos puede ser deseable llevar a cabo la actualización IPv4 e IPv6 en un único paso. Predeterminado: true ipa_access_order (string) Lista separada por coma de opciones de control de acceso. Los valores permitidos son: expire: use IPA's account expiration 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: pwd_expire_policy_reject - user is denied to log in, pwd_expire_policy_warn - user is still able to log in, pwd_expire_policy_renew - user is prompted to change their password immediately. Please note that 'access_provider = ipa' must be set for this feature to work. ipa_deskprofile_search_base (cadena) Opcional. Usa la cadena dada como base de búsqueda de los objetos relacionados con Desktop Profile. Predeterminado: Utilizar DN base ipa_subid_ranges_search_base (string) Optional. Use the given string as search base for subordinate ranges related objects. Default: the value of cn=subids,%basedn ipa_hbac_search_base (cadena) Opcional. Usa la cadena dada como base de búsqueda para los objetos HBAC relacionados. Predeterminado: Utilizar DN base ipa_host_search_base (cadena) Obsoleto. Usa en su lugar ldap_host_search_base. ipa_selinux_search_base (cadena)Opcional. Opcional. Usa la cadena dada como base de búsqueda para los mapas de usuario SELinux. 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 ipa_subdomains_search_base (cadena) Opcional: Usa la cadena dada como base de búsqueda de dominios de confianza. Vea ldap_search_base para información sobre la configuración de múltiples bases de búsqueda. Por defecto: el valor de cn=trusts,%basedn ipa_master_domain_search_base (cadena) Opcional: Usa la cadena dada como base de búsqueda para el objeto maestro de dominio. Vea ldap_search_base para información sobre la configuración de múltiples bases de búsqueda. Por defecto: el valor de cn=ad,cn=etc,%basedn ipa_views_search_base (cadena) Opcional. Usa la cadena dada como base de búsqueda de contenedores de vista. Vea ldap_search_base para información sobre la configuración de múltiples bases de búsqueda. Predeterminado: el valor de cn=views,cn=accounts,%basedn krb5_realm (cadena) El nombre del reino Kerberos. Esto es opcional y por defecto está al valor de ipa_domain. El nombre del reino Kerberos tiene un significado especial en IPA – es convertido hacia la base DN para usarlo para llevar a cabo operaciones LDAP. krb5_confd_path (cadena) Ruta absoluta de un directorio donde SSSD debe colocar fragmentos de configuración de Kerberos. Para deshabilitar la creación de fragmentos de configuración establezca el parámetro a 'none'. Predeterminado: no establecido (krb5.include.d subdirectorio del directorio pubconf de SSSD) ipa_deskprofile_refresh (entero) La cantidad de tiempo entre búsquedas de reglas Desktop Profile contra el servidor IPA. Esto reducirá la latencia y la carga sobre el servidor IPA si hay muchas solicitudes de perfiles de escritorio en un período corto. Predeterminado: 5 (segundos) ipa_deskprofile_request_interval (entero) La cantidad de tiempo entre búsquedas de las reglas Desktop Profile contra el servidor IPA en el caso de que la última petición no devolvió ninguna regla. Predeterminado: 60 (minutos) ipa_hbac_refresh (entero) La cantidad de tiempo entre vbúsquedas de las reglas HBAC contra el servidor IPA. Esto reducirá la latencia y la carga sobre el servidor IPA si hay muchas peticiones de control de acceso hechas en un corto período. Predeterminado: 5 (segundos) ipa_hbac_selinux (entero) La cantidad de tiempo entre búsquedas de los mapas SELinux contra el servidor IPA. Esto reducirá la latencia y la carga sobre el servidor IPA si hay muchas peticiones de acceso de usuario hechas en un corto período. Predeterminado: 5 (segundos) ipa_server_mode (booleano) Esta opción será establecida por el instalador IPA (ipa-server-install) automáticamente y denota si SSSD está corriendo sobre un servidor IPA o no. Sobre un servidor IPA SSSD buscara usuarios y grupos de los dominios de confianza directamente mientras que sobre un cliente preguntará a un servidor IPA. NOTA: Actualmente hay algunas suposiciones que deben cumplirse cuando SSSD se ejecuta en un servidor IPA. La opcion ipa_server debe configurarse para que apunte al servidor IPA mismo. Esto está establecido de manera predeterminada por el instalador IPA de modo que no se necesitan cambios manuales. La opción full_name_format no debe modificarse para imprimir solo nombres cortos de los usuarios de los dominios de confianza. Predeterminado: false ipa_automount_location (cadena) La localización del automontador de este cliente IPA que será usada Por defecto: La localización llamada “default” VISTAS Y ANULACIONES SSSD puede manejar vistas y anulaciones que son ofrecidas por FreeIPA 4.1 y versiones posteriores. Como todas las rutas y objectclasses son fijadas en el lado servidor no se necesita configurar nada. Para completar, las opciones relacionadas son listadas aquí con sus valores predeterminados. ipa_view_class (cadena) Objectclass del contenedorde vistas. Predeterminado: nsContainer ipa_view_name (cadena) Nombre del atributo que contiene el nombre de la vista. Predeterminado: cn ipa_override_object_class (cadena) Objectclass de los objetos anulados. Predeterminado: ipaOverrideAnchor ipa_anchor_uuid (cadena) Nombre del atributo que contiene la referencia al objeto original en un dominio remoto. Predeterminado: ipaAnchorUUID ipa_user_override_object_class (cadena) Nombre de los objectclass para los usuarios anulados. Se usa para determinar si el objeto anulado encontrado está relacionado con un usuario o un grupo. Las anulaciones de usuario pueden contener atributos dados por ldap_user_name ldap_user_uid_number ldap_user_gid_number ldap_user_gecos ldap_user_home_directory ldap_user_shell ldap_user_ssh_public_key Predeterminado: ipaUserOverride ipa_group_override_object_class (cadena) Nombre del objectclass para grupos anulados. Se usa para determinar si el objeto anulado encontrado está relacionado con un usuario o un grupo. Las anulaciones de grupo pueden contener atributos dados por ldap_group_name ldap_group_gid_number Predeterminado: ipaGroupOverride PROVEEDOR DE SUBDOMINIOS El proveedor de subdominios IPA se comporta de forma ligeramente diferente si está configurado explícitamente o implícitamente. Si la opción ' subdomains_provider = ipa' se encuentra en la sección de dominio de sssd.conf, el proveedor de subdominios de IPA se configura explícitamente, y todas las peticiones de subdominio se envían al servidor de IPA si es necesario. Si la opción 'subdomains_provider' no está establecida en la sección dominio de sssd.conf pero hay la opción 'id_provider = ipa', el proveedor de subdominios IPA está configurado implícitamente. En este caso, si una petición de subdominio falla e indica que el servidor no soporta subdominios, i.e. no está configurado para confianza, el proveedor de subdominios IPA está deshabilitado. Después de una hora o después de que el proveedor IPA esté en línea, el proveedor de subdominios está habilitado otra vez. CONFIGURACIÓN DE DOMINIOS DE CONFIANZA Some configuration options can also be set for a trusted domain. A trusted domain configuration can be set using the trusted domain subsection as shown in the example below. Alternatively, the subdomain_inherit option can be used in the parent domain. [domain/ipa.domain.com/ad.domain.com] ad_server = dc.ad.domain.com For more details, see the sssd.conf 5 manual page. Se pueden ajustar diferentes opciones de configuración para un dominio de confianza dependiendo de si usted está configurando SSSD sobre un servidor IPA o un cliente IPA. OPCIONES AJUSTABLES EN IPA MAESTROS Se pueden establecer las siguientes opciones en una sección subdominio sobre un IPA maestro: ad_server ad_backup_server ad_site ldap_search_base ldap_user_search_base ldap_group_search_base use_fully_qualified_names OPCIONES AJUSTABLES SOBRE CLIENTES IPA Las siguientes opciones pueden ser establecidas en una sección subdominio sobre un cliente IPA: ad_server ad_site Advierta que si ambas opciones están establecidas solo se evalúa ad_server. Puesto que cualquier petición para una identidad de usuario o de grupo de un dominio de confianza disparada desde un cliente IPA se resuelve por el servidor IPA, las opciones ad_server y ad_site solo afectan a que AD DC llevará a cabo la autenticación. En concreto, las direcciones resueltas desde estas listas serán escritas a ficheros kdcinfo leídos por el complemento localizador Kerberos. Por favor vea la página de manual sssd_krb5_locator_plugin 8 para mas detalles sobre el complemento localizador Kerberos. EJEMPLO El siguiente ejemplo asume que SSSD está correctamente configurado y example.com es uno de los dominios en la sección [sssd]. Este ejemplo muestra sólo las opciones específicas del proveedor ipa. [domain/example.com] id_provider = ipa ipa_server = ipaserver.example.com ipa_hostname = myhost.example.com