From 1b6ad6fc08499ca650a4c4da0e1f4fb22b22223b Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Fri, 20 Jan 2012 12:55:16 +0000
Subject: [PATCH] Note on using passwords with special characters

---
 opendj3/src/main/docbkx/admin-guide/chap-ldap-operations.xml |   30 +++++++++++++++++++++++++++++-
 1 files changed, 29 insertions(+), 1 deletions(-)

diff --git a/opendj3/src/main/docbkx/admin-guide/chap-ldap-operations.xml b/opendj3/src/main/docbkx/admin-guide/chap-ldap-operations.xml
index 45c2056..f9e7025 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-ldap-operations.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-ldap-operations.xml
@@ -734,7 +734,35 @@
  --newPassword secret12
 The LDAP password modify operation was successful</screen>
   </example>
-  
+
+  <example xml:id="non-ascii-password">
+   <title>Passwords With Special Characters</title>
+
+   <para>OpenDJ expects passwords to be UTF-8 encoded (base64 encoded when
+   included in LDIF).</para>
+
+   <screen>$ echo $LANG
+en_US.utf8
+$ ldappasswordmodify
+ --port 1389
+ --bindDN uid=bjensen,ou=People,dc=example,dc=com
+ --bindPassword hifalutin
+ --currentPassword hifalutin
+ --newPassword pàsswȏrd
+The LDAP password modify operation was successful
+$ ldapsearch
+ --port 1389
+ --bindDN uid=bjensen,ou=People,dc=example,dc=com
+ --bindPassword pàsswȏrd
+ --baseDN dc=example,dc=com
+ "(uid=bjensen)" cn
+dn: uid=bjensen,ou=People,dc=example,dc=com
+userPassword: {SSHA}k0eEeCxj9YRXUp8yJn0Z/mwqe+wrcFb1N1gg2g==
+cn: Barbara Jensen
+cn: Babs Jensen
+</screen>
+  </example>
+
   <tip xml:id="fix-forgotten-directory-manager-pwd">
    <para>If you forget the password for <literal>cn=Directory Manager</literal>,
    then one remedy uses the following steps.</para>

--
Gitblit v1.10.0