FreeBSD Manual Pages
IDMAP_NSS(8) System Administration tools IDMAP_NSS(8) NAME idmap_nss - Samba's idmap_nss Backend for Winbind DESCRIPTION The idmap_nss plugin provides a means to map Unix users and groups to Win- dows accounts. This provides a simple means of ensuring that the SID for a Unix user named jsmith is reported as the one assigned to DOMAIN\jsmith which is necessary for reporting ACLs on files and printers stored on a Samba member server. IDMAP OPTIONS range = low - high Defines the available matching UID and GID range for which the backend is authoritative. Note that the range acts as a filter. Returned UIDs or GIDs by NSS modules that fall outside the range are ignored and the corresponding maps discarded. It is intended as a way to avoid acciden- tal UID/GID overlaps between local and remotely defined IDs. use_upn = <yes | no> Some NSS modules can return and handle UPNs and/or down-level logon names (e.g., DOMAIN\user or user@REALM). If this parameter is enabled the returned names from NSS will be parsed and the resulting namespace will be used as the authoritative namespace instead of the IDMAP domain name. Also, down-level logon names will be sent to NSS instead of the plain username to give NSS modules a hint about the user's correct domain. Default: no EXAMPLES This example shows how to use idmap_nss to obtain the local account ID's for its own domain (SAMBA) from NSS, whilst allocating new mappings for the default domain (*) and any trusted domains. [global] idmap config * : backend = tdb idmap config * : range = 1000000-1999999 idmap config SAMBA : backend = nss idmap config SAMBA : range = 1000-999999 AUTHOR The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed. Samba 4.23.8 08/01/2026 IDMAP_NSS(8)
NAME | DESCRIPTION | IDMAP OPTIONS | EXAMPLES | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=idmap_nss&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>