Beginning with PC-BSD 9.1, the Control Panel contains an AD & LDAP Configuration icon for managing connections settings to an AD or LDAP server. If your network contains an Active Directory or an LDAP 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. That feature will be added in PC-BSD 9.2.

+

Beginning with PC-BSD®&nbsp;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®&nbsp;9.1; this will be added as a feature of version 9.2. [[File:ldap.png|thumb|393px|'''Figure 8.3b: Managing LDAP Client Settings''']]

−

'''NOTE:''' this utility is to manage the ''' ''client'' ''', not the Active Directory or LDAP server itself.

+

{{note|width=48.5%|icon64=this utility is used 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: Managing Active Directory Client Settings'''

+

=== Connecting to Active Directory ===

−

[[File:Ad.png]]

+

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:

−

If you need to connect to a network running Active Directory, check the box "Enable Active Directory". This will ungrey out 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.

* '''Workgroup Name:''' input the name of the Windows workgroup. Unless the administrator has changed it, the default workgroup name is ''WORKGROUP''.

−

* NetBIOS Name:''' hostname of PC-BSD system.

+

* '''Allow Trusted Domains:''' only check this box if the network has {{citelink|url=http://technet.microsoft.com/en-us/library/cc757352%28WS.10%29.aspx|txt=active domain/forest trusts}}.

−

* '''Allow Trusted Domains:''' checking this box is optional. It should only be checked if the network has [http://technet.microsoft.com/en-us/library/cc757352%28WS.10%29.aspx active domain/forest trusts] and you need to manage files on multiple domains; use with caution as it will generate more winbindd traffic, slowing down the ability to filter through user/group information

+

* '''Administrator Name:''' input the name of the Active Directory Administrator account.

−

* '''Administrator Name:''' name of 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 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:

* '''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:''' {{citelink|url=http://www.openldap.org/software/man.cgi?query=ldap.conf|txt=ldap.conf(5)}} 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''.

−

[[File:Ad1.png]]

+

If you are new to LDAP terminology, you may find it useful to skim through the {{Citelink|url=http://www.openldap.org/doc/admin24/|txt=OpenLDAP Software 2.4 Administrator's Guide}}.

<noinclude>

<noinclude>

+

{{refheading}}

[[category:handbook]]

[[category:handbook]]

[[category:Control Panel]]

[[category:Control Panel]]

+

[[category:Active Directory & LDAP]]

</noinclude>

</noinclude>

Revision as of 16:11, 30 March 2013

(Sorry for the inconvenience)

Editor: please update template:UseTOC/9.2

Translator: please use {{UseTOC{{putVers}}|TOC}}

Protection (edit): sysopEdited by: Tigersharke

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.

Figure 8.3b: Managing LDAP Client Settings

This utility is used 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.

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.

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.

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:

Figure 8.3a: Initial Active Directory & LDAP Screen

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).