You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en-US/LDAP-for-user-authentication.xml
+20-11Lines changed: 20 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -24,19 +24,28 @@
24
24
<sectionid="LDAP-for-user-authentication">
25
25
<title>Using an LDAP Server for User Authentication</title>
26
26
<para>You can use an external LDAP server such as Microsoft Active Directory or OpenLDAP to authenticate &PRODUCT; end-users.</para>
27
-
<para>To set up LDAP authentication in &PRODUCT;, open the global settings page and set:</para>
27
+
<para>In order to do this you must:</para>
28
28
<itemizedlist>
29
-
<listitem><para>ldap.basedn - The base directory you want to search within for uses</para></listitem>
30
-
<listitem><para>ldap.bind.password - The password you wish to use to bind, this can be blank if the server supports anonymous binding</para></listitem>
31
-
<listitem><para>ldap.bind.principal - The account you wish to use to bind, this can be blank if the server supports anonymous binding</para></listitem>
32
-
<listitem><para>ldap.email.attribute - The attribute within your LDAP server that holds a value for users email address</para></listitem>
33
-
<listitem><para>ldap.realname.attribute - The attribute within your LDAP server that holds a value users realname</para></listitem>
34
-
<listitem><para>ldap.user.object - The object class that identifies a user</para></listitem>
35
-
<listitem><para>ldap.username.attribute - The attribute within your LDAP server that has a value that will match the cloudstack accounts username field</para></listitem>
29
+
<listitem><para>Set your LDAP configuration within &PRODUCT;</para></listitem>
30
+
<listitem><para>Create &PRODUCT; accounts for LDAP users</para></listitem>
36
31
</itemizedlist>
37
-
<para>Finally you can add LDAP servers from Global Settings -> Select View -> LDAP Configuration. This requires a hostname and port</para>
32
+
<para>To set up LDAP authentication in &PRODUCT;, open the global settings page and search for LDAP</para>
33
+
<para>Set ldap.basedn to match your sever's base directory.</para>
34
+
<para>Review the defaults for the following, ensure that they match your schema.</para>
<para>Optionally you can set the following:</para>
43
+
<itemizedlist>
44
+
<listitem><para>If you do not want to use anonymous binding you can set ldap.bind.principle and ldap.bind.password as credentials for your LDAP server that will grant &PRODUCT; permission to perform a search on the LDAP server.</para></listitem>
45
+
<listitem><para>For SSL support set ldap.truststore to a path on the file system where your trusted store is located. Along with this set ldap.truststore.password as the password that unlocks the truststore.</para></listitem>
46
+
<listitem><para>If you wish to filter down the user set that is granted access to &PRODUCT; via the LDAP attribute memberof you can do so using ldap.search.group.principle.</para></listitem>
47
+
</itemizedlist>
48
+
<para>Finally, you can add your LDAP server. To do so select LDAP Configuration from the views section within global settings. Click on "Configure LDAP" and fill in your server's hostname and port.</para>
@Parameter(name = "listtype", type = CommandType.STRING, required = false, description = "Determines whether all ldap users are returned or just non-cloudstack users")
0 commit comments