Difference between revisions of "Active Directory & LDAP/9.2"

From PC-BSD Wiki
Jump to: navigation, search
(38 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
<noinclude>{{NavHeader|back=About|forward=Hardware Compatibility}}</noinclude>
 
<noinclude>{{NavHeader|back=About|forward=Hardware Compatibility}}</noinclude>
  
SCREENSHOTS AND DESCRIPTIONS MAY CHANGE AFTER BETA1
+
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''']]
  
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.
+
{{note|width=48.5%|icon64=this utility is used to manage the settings of the client, not the Active Directory or OpenLDAP server itself.}}
  
'''NOTE:''' this utility is to manage the ''' ''client'' ''', not the Active Directory or LDAP 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 shows the configuration utility with the Active Directory tab open.
+
=== Connecting to Active Directory ===
  
'''Figure 8.3a: Managing Active Directory Client Settings'''
+
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:
  
[[File:Ad.png]]
+
* '''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.
  
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:
+
* '''NetBIOS Name:''' input the hostname of the PC-BSD® system as listed in the [[About]] icon.
  
* '''Domain Controller Name:''' the IP address or hostname of the Windows domain controller. 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''.
  
* '''Domain Name:''' name of Active Directory domain (e.g. example.com) or child domain (e.g. sales.example.com). This setting is mandatory.
+
* '''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}}.
  
* '''NetBIOS Name:''' hostname of PC-BSD system.
+
* '''Administrator Name:''' input the name of the Active Directory Administrator account.
  
* '''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 Password:''' input and confirm the password for 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''.
  
* '''Administrator Password:''' password for the Active Directory Administrator account.
+
=== 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:
 +
[[File:Ad2.png|thumb|393px|'''Figure 8.3a: Initial Active Directory & LDAP Screen''']]
 +
* '''Hostname:''' input the hostname or IP address of the OpenLDAP server. This setting is mandatory.
  
[[File:Ad1.png]]
+
* '''Base DN:''' input the top level of the LDAP directory tree to be used when searching for resources (e.g. dc=test,dc=org).
  
If you need to connect to a network which contains a configured LDAP server, check the box "Enable LDAP". This will ungrey out the rest of the screen, allowing you to configure the following:
+
* '''Allow Anon Binding:''' only check this box if the LDAP server allows read and write access without requiring authentication.
  
* '''Hostname:''' hostname or IP address of LDAP server. This setting is mandatory.
+
* '''Root bind DN:''' input the name of the administrative account on the LDAP server (e.g. cn=Manager,dc=test,dc=org).
  
* '''Base DN:''' top level of the LDAP directory tree to be used when searching for resources (e.g. dc=test,dc=org).
+
* '''Root bind password:''' input the password for the ''Root bind DN''.
  
* '''Allow Anon Binding:''' instructs the LDAP server to allow read/write access without requiring authentication.
+
* '''Password Encryption:''' select a type supported by the LDAP server, choices are: clear (unencrypted), crypt, md5, nds, racf, ad, or exop.
  
* '''Root bind DN:''' name of administrative account on LDAP server (e.g. cn=Manager,dc=test,dc=org).
+
* '''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
  
* '''Root bind password:''' password for Root bind DN.  
+
* '''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 Encryption:''' select a type supported by the LDAP server, choices are: clear (unencrypted), crypt, md5, nds, racf, ad, or exop.
+
  
* '''User Suffix:''' optional, can be added to name when user account added to LDAP directory (e.g. dept. or company name).
+
* '''Password Suffix:''' this setting is optional. The input value will be added to the password when a password is added to the LDAP directory.
  
* '''Group Suffix:''' optional, can be added to name when group added to LDAP directory (e.g. dept. or company name).
+
* '''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.
  
* '''Password Suffix:''' optional, can be added to password when password added to LDAP directory.
+
* '''Encryption Mode:''' choices are "Off", "SSL", or "TLS". The selected type must be supported by the LDAP server.
  
* '''Machine Suffix:''' optional, can be added to name when system added to LDAP directory (e.g. server, accounting).
+
* '''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.'''
  
* '''Encryption Mode:''' choices are Off, SSL, or TLS.
+
* '''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.
  
* '''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.'''
+
The values that you input into this tab are saved to ''/usr/local/etc/pc-ldap.conf''.
  
* '''Auxiliary Parameters:''' [http://www.openldap.org/software/man.cgi?query=ldap.conf ldap.conf(5)] options, one per line, not covered by other options in this screen
+
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 15:11, 30 March 2013

(Sorry for the inconvenience)

Contents

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
NOTE: 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).
  • 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: ldap.conf(5)[2] 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[3].


References


  1. http://technet.microsoft.com/en-us/library/cc757352%28WS.10%29.aspx
  2. http://www.openldap.org/software/man.cgi?query=ldap.conf
  3. http://www.openldap.org/doc/admin24/
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox