|Active Directory & LDAP|
Beginning with PC-BSD® 9.1, the Control Panel contains an "Active Directory & LDAP" icon for managing connections to an Active Directory or OpenLDAP domain. If your network contains an Active Directory or OpenLDAP server, use this icon to input the settings needed to connect to your account information stored on the network. At this time, these settings can not be set during installation of PC-BSD® 9.1; this will be added as a feature of version 9.2.
NOTE: this utility is to manage the settings of the client, not the Active Directory or OpenLDAP server itself.
To start the application, double-click its icon in Control Panel or type pc-su pc-adsldap. You will be prompted to input the administrative password. Figure 8.3a shows the configuration utility with the Active Directory tab open.
Figure 8.3a: Initial Active Directory & LDAP Screen
Connecting to Active Directory
If you need to connect to a network running Active Directory, check the box "Enable Active Directory". This will change the greyed-out status of the rest of the screen, allowing you to configure the following:
- Domain Name (DNS/Realm-Name): input the name of the Active Directory domain (e.g. example.com) or child domain (e.g. sales.example.com). This setting is mandatory.
- NetBIOS Name: input the hostname of the PC-BSD® system as listed in the About icon.
- Workgroup Name: input the name of the Windows workgroup. Unless the administrator has changed it, the default workgroup name is WORKGROUP.
- Allow Trusted Domains: only check this box if the network has .
- Administrator Name: input the name of the Active Directory Administrator account.
- Administrator Password: input and confirm the password for the Active Directory Administrator account.
The values that you input using this GUI are saved to /usr/local/etc/pc-activedirectory.conf.
Connecting to an OpenLDAP Server
Figure 8.3b shows the configuration utility with the LDAP tab open.
Figure 8.3b: Managing LDAP Client Settings
If you need to connect to a network which contains a configured LDAP server, check the box "Enable LDAP". This will change the greyed-out status of the rest of the screen, allowing you to configure the following:
- Hostname: input the hostname or IP address of the OpenLDAP server. This setting is mandatory.
- Base DN: input the top level of the LDAP directory tree to be used when searching for resources (e.g. dc=test,dc=org).
- Allow Anon Binding: only check this box if the LDAP server allows read and write access without requiring authentication.
- Root bind DN: input the name of the administrative account on the LDAP server (e.g. cn=Manager,dc=test,dc=org).
- Root bind password: input the password for the Root bind DN.
- Password Encryption: select a type supported by the LDAP server, choices are: clear (unencrypted), crypt, md5, nds, racf, ad, or exop.
- User Suffix: this setting is optional and is usually a dept. or company name. The input value will be added to the name when a user account is added to the LDAP directory
- Group Suffix: this setting is optional and is usually a dept. or company name. The input value will be added to the name when a group is added to the LDAP directory.
- Password Suffix: this setting is optional. The input value will be added to the password when a password is added to the LDAP directory.
- Machine Suffix: this setting is optional and usually represents a description such as server or accounting. The input value will be added to the name when a system is added to the LDAP directory.
- Encryption Mode: choices are "Off", "SSL", or "TLS". The selected type must be supported by the LDAP server.
- Self Signed Certificate: used to verify the certificate of the LDAP server if SSL connections are used. Paste the output of the command openssl s_client -connect server:port -showcerts.
- Auxiliary Parameters:  options, one per line, not covered by other options in this screen.
The values that you input into this tab are saved to /usr/local/etc/pc-ldap.conf.
If you are new to LDAP terminology, you may find it useful to skim through the OpenLDAP Software 2.4 Administrator's Guide.