TrueNASTrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

Idmap Screens

Idmap in Linux is essentially a translation of a range of IDs into another or the same range of IDs.

Only administrators experienced with configuring Id mapping should attempt to add new or edit existing idmaps. Misconfiguration can impact system operation.

Idmap Widget

The Idmap widget in the Advanced Settings on the Directory Services screen displays idmaps added to TrueNAS.

IdmapSCALE

Add opens the Add Idmap configuration screen.

Click on any instance to open the Edit Idmap screen.

The Idmap widget header opens the Idmap screen.

Idmap Screen

The Idmap screen displays a list view of idmaps configured on your TrueNAS system.

IdmapScreen

Add opens the Add Idmap screen.

Click on an Idmap on the widget to open the screen for the selected idmap.

Add and Edit IDMAP Screens

The settings on the Add Idmap and Edit Idmap change based on the selection made in both the Name and Idmap Backend fields.

Add Idmap Screen (Default and Custom Value)

AddIdmapDefaultScreen

SettingDescription
Name(Required) Select an option from the dropdown list, SMB - Primary Domain or Custom Value. SMB - Primary Domain reduces the fields displayed on the Add Idmap screen. Selecting Custom Value adds The Custom Name field.
Custom NameDisplays below the Name field after selecting Custom Value in the Name field. Enter the pre-Windows 2000 domain name.
Idmap Backend(Required) Select the backend plugin interface for Winbind to use to store SID to UID/GID mapping tables. The correct setting depends on the environment you deployed the NAS in. Options are AD for Active Directory, LDAP for an LDAP environment. AUTORID is similar to RID but it can automatically assign IDs for different domains. NSS provides a means to map Unix users and groups to Windows accounts. RFC2307 provides a way for Winbind to read ID mappings from records in an LDAP server defined in RFC 2307. RID provides a way to use an algorithmic mapping scheme to map UIDs/GIDs and SIDs. TDB is similar to RID but it is an allocating backend, which means it needs to allocate new users and group IDs in order to create new mappings. The selected option changes the settings displayed on the Add Idmap screen.
DNS Domain NameEnter the DNS name of the domain.
Range Low(Required) Enter a value for the least number of members. Works with the Range High to establish the range of UID/GID numbers the Idmap backend translates. If an external credential like a Windows SID maps to a UID or GID number outside this range, TrueNAS ignores it.
Range High(Required) Enter a value for the greatest number of members. Works with the Range Low to establish the range of UID/GID numbers the Idmap backend translates. If an external credential like a Windows SID maps to a UID or GID number outside this range, TrueNAS ignores it.

Options Settings The Options settings change based on the selected Name and Idmap Backend fields.

SettingDescription
Unix Primary GroupSelect to fetch the primary group membership from the LDAP attributes (gidNumber). If unselected, the primary group membership is calculated via the primaryGroupID LDAP attribute.
Unix NSS InfoSelect sets Winbind to retrieve the login shell and home directory from the LDAP attributes. If unselected, when the AD LDAP entry lacks the SFU attributes the smb4.conf parameters template shell and template homedir are used.
Support for LDAP Schema Mode for SMB shares is deprecated in TrueNAS 22.02 (Angelfish) and removed in 24.10 (Electric Eel). Before updating to 24.10 or later, Administrators using this legacy feature should stop using SMB shares (continue using LDAP), convert directory users to local TrueNAS accounts (stop using LDAP), or convert to Active Directory (stop using LDAP).

Add Idmap Screen for SMB - Primary Domain

The settings for Add Idmap displays a subset of those on the default screen.

Settings for SMB - Primary Domain

AddIdmapSMBPrimaryDomainScreen

SettingDescription
NameDisplays SMB - Primary Domain.
DNS Domain NameEnter the DNS name of the domain.
Range Low(Required) Works with the Range High to establish the range of UID/GID numbers the idmap backend translates. If an external credential like a Windows SID maps to a UID or GID number outside this range, TrueNAS ignores it.
Range High(Required) Works with the Range Low to establish the range of UID/GID numbers the idmap backend translates. If an external credential like a Windows SID maps to a UID or GID number outside this range, TrueNAS ignores it.

Options only as the Read Only which, when selected, makes the module read-only. No new ranges are allocated or new mappings created in the idmap pool.

Add Idmap Screen with Idmap Backend as AD

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to AD shares the same settings as the default screen but it includes DNS Domain Name.

Idmap Backend - AD Settings

AddIdmapBackendAD

SettingDescription
DNS Domain NameEnter the domain name of the DNS server.

Add Idmap Screen with Idmap Backend as AUTORID

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to AUTORD shares the some of the same settings on the AD screen but the Options settings are different.

Idmap Backend - AUTORID Options Settings

AddIdmapBackendAD

SettingDescription
Range SizeEnter the number of UIDs/GIDs available per domain range. The minimum number is 2000. The recommended default is 100000.
Read OnlySelect to make the module read-only. No new ranges are allocated or new mappings created in the idmap pool.
Ignore BuiltinSelect to ignore mapping requests for the BUILTIN domain.

Add Idmap Screen with Idmap Backend as LDAP

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to LDAP shares the some of the same settings on the AD screen but it adds the Certificate option, and the Options settings are different.

Idmap Backend - LDAP Settings

AddIdmapBackendLDAPSettings

SettingDescription
CertificateSelect the certificate of the Active Directory server if SSL connections are used. When no certificates are available, move to the Active Directory server and create a Certificate Authority and certificate. Import the certificate to TrueNAS using the Credentials > Certificates screen widgets.
Manage CertificatesOpens the Credentials > Certificates screen. When finished on the Certificates screen, navigate back to Directory Services, click Show and confirm to display the Idmap widget again. Click Add to begin the configuration again.

Options The LDAP settings in Options are different from other Idmap Backend options except the RFC2307 option.

AddIdmapBackendLDAPOptionsSettings

SettingDescription
Read OnlySelect to make the module read-only. No new ranges are allocated or new mappings created in the idmap pool.
Base DN(Required) Enter the directory base suffix to use for SID to UID/GID mapping entries. Examples, dc=test, dc=org. When undefined, idmap_ldap defaults to using the LDAP idmap suffix option from smb.conf.
LDAP User DN(Required) Enter the user distinguished name (DN) to use for authentication.
LDAP User DN PasswordEnter the password associated with the LDAP user DN.
URL(Required) Enter the URL for the LDAP server to use for SID to UID/GID mapping. For example, ldap://ldap.netscap.com/o=Airus.com.
Encryption Mode(Required) Select the encryption mode to use with LDAP from the dropdown list. Options are On, Off, or StartTLS.

Add Idmap Screen with Idmap Backend as NSS

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to NSS shares the same settings as the AD screen. There is only one Options setting.

Idmap Backend - NSS Settings

AddIdmapBackendNSSSettings

SettingDescription
Linked Service(Required) Select the option that specifies the auxiliary directory service ID provider from the dropdown list. Options are Local Account, LDAP, or NIS.

Add Idmap Screen with Idmap Backend as RFC2307

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to RFC2307 shares the same settings as the LDAP screen, and some of the same Options settings.

Idmap Backend - RFC2307 Settings

The RFC2307 settings in Options share the Idmap Backend settings as the LDAP option, but includes more configuration settings.

AddIdmapBackendRFC2307Options

SettingDescription
LDAP User DN(Required) Enter the user distinguished name (DN) to use for authentication.
LDAP User DN PasswordEnter the password associated with the LDAP user DN.
URL(Required) Enter the URL for the LDAP server to use for SID to UID/GID mapping. For example, ldap://ldap.netscap.com/o=Airus.com.
Encryption Mode(Required) Select the encryption mode to use with LDAP from the dropdown list. Options are On, Off, or StartTLS.
LDAP ServerSelect the type of LDAP server to use. This can be the LDAP server provided by the Active Directory server or a stand-alone LDAP server.
LDAP RealmEnter the realm that performs authentication from an LDAP server.
User Bind PathEnter the search base where user objects are found in the LDAP server.
Group Bind PathEnter the search base where group objects are found in the LDAP server.
User CNEnter the user common name (CN) to query the CN instead of the uid attribute for the user name in LDAP.
CN RealmAppend @realm to the CN in LDAP queries for both groups and users when you set the User CN.
LDAP DomainEnter the domain to access the Active Directory server when using the LDAP server inside the Active Directory server.

Add Idmap Screen with Idmap Backend as RID

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to RID shares the same settings as the AD screen. There is only one Options setting.

Idmap Backend - RID Settings

AddIdmapBackendAUTORIDSettings

SettingDescription
SSSD CompatSelect to generate the idmap low range based on the same algorithm that SSSD uses by default.

Add Idmap Screen with Idmap Backend as TDB

The Add Idmap screen with Name set to Custom Value and Idmap Backend set to TDB shares the same settings as the AD screen. There is only one Options setting.

Idmap Backend - TDB Settings

AddIdmapBackendTDBSettings

SettingDescription
Read OnlySelect to make the module read-only. No new ranges are allocated or new mappings created in the idmap pool.