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

From PC-BSD Wiki
Jump to: navigation, search
m
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<noinclude>{{NavHeader|back=About|forward=Hardware Compatibility}}</noinclude>
 
<noinclude>{{NavHeader|back=About|forward=Hardware Compatibility}}</noinclude>
  
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.
+
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.
  
 
'''NOTE:''' this utility is to manage the settings of the client, not the Active Directory or OpenLDAP server itself.
 
'''NOTE:''' this utility is to manage the settings of the client, not the Active Directory or OpenLDAP server itself.
Line 7: Line 7:
 
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.
 
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'''
+
'''Figure 8.3a: Initial Active Directory & LDAP Screen'''
  
 
[[File:Ad2.png]]
 
[[File:Ad2.png]]
 +
 +
=== 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:
 
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:''' name of Active Directory domain (e.g. example.com) or child domain (e.g. sales.example.com). This setting is mandatory.
+
* '''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:''' hostname of PC-BSD® system.
+
* '''NetBIOS Name:''' input the hostname of the PC-BSD® system as listed in the [[About]] icon.
  
* '''Workgroup Name:''' name of Windows server's workgroup.
+
* '''Workgroup Name:''' input the name of the Windows workgroup. Unless the administrator has changed it, the default workgroup name is ''WORKGROUP''.
  
* '''Allow Trusted Domains:''' checking this box is optional. It should only be checked 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:''' 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}}.
  
* '''Administrator Name:''' name of the Active Directory Administrator account.
+
* '''Administrator Name:''' input the name of the Active Directory Administrator account.
  
* '''Administrator Password:''' password for 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 shows the configuration utility with the LDAP tab open.
Line 33: Line 39:
 
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:
 
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:''' hostname or IP address of LDAP server. This setting is mandatory.
+
* '''Hostname:''' input the hostname or IP address of the OpenLDAP server. This setting is mandatory.
  
* '''Base DN:''' top level of the LDAP directory tree to be used when searching for resources (e.g. dc=test,dc=org).
+
* '''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:''' instructs the LDAP server to allow read/write access without requiring authentication.
+
* '''Allow Anon Binding:''' only check this box if the LDAP server allows read and write access without requiring authentication.
  
* '''Root bind DN:''' name of administrative account on LDAP server (e.g. cn=Manager,dc=test,dc=org).
+
* '''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:''' password for Root bind DN.
+
* '''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.
 
* '''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).
+
* '''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:''' optional, can be added to name when group added to LDAP directory (e.g. dept. or company name).
+
* '''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:''' optional, can be added to password when password added to 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:''' optional, can be added to name when system added to LDAP directory (e.g. server, accounting).
+
* '''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".
+
* '''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.'''
+
* '''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.
 
* '''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''.
 +
 +
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>{{refheading}}</noinclude>
 
<noinclude>{{refheading}}</noinclude>

Revision as of 23:52, 18 December 2012

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

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

Ad2.png

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.

Figure 8.3b: Managing LDAP Client Settings

Ldap.png

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: 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/