From 110395c2a024a5481bc51c0f0d8cb8ff65be5710 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Wed, 04 Sep 2013 15:53:52 +0000
Subject: [PATCH] CR-2258 Fix for OPENDJ-1113: Provide an example for resetting passwords in AD

---
 opendj3/src/main/docbkx/dev-guide/chap-writing.xml |   21 +++++++++++++++++++++
 1 files changed, 21 insertions(+), 0 deletions(-)

diff --git a/opendj3/src/main/docbkx/dev-guide/chap-writing.xml b/opendj3/src/main/docbkx/dev-guide/chap-writing.xml
index 47ba251..edc8154 100644
--- a/opendj3/src/main/docbkx/dev-guide/chap-writing.xml
+++ b/opendj3/src/main/docbkx/dev-guide/chap-writing.xml
@@ -164,6 +164,27 @@
   entry, but instead by specifying individual changes. See a demonstration
   of this technique in <xref linkend="updating-static-groups" />.</para>
 
+  <indexterm>
+   <primary>Passwords</primary>
+  </indexterm>
+
+  <para>You can also construct a <literal>ModifyRequest</literal> for example
+  to change a user password in Active Directory, as demonstrated in the
+  following excerpt. When working with OpenDJ directory server, consider using
+  the LDAP Password Modify extended operation instead as shown in the section,
+  <link xlink:show="new" xlink:href="dev-guide#use-password-modify-extended-operation"
+  xlink:role="http://docbook.org/xlink/role/olink"><citetitle>Password Modify
+  Extended Operation</citetitle></link>.</para>
+
+  <programlisting language="java"
+  >[jcp:org.forgerock.opendj.examples.PasswordResetForAD:--- JCite main ---]</programlisting>
+
+  <para>To make the modification, the example connects to Active Directory over
+  LDAPS, and provides the password value in UTF-16LE format.</para>
+
+  <programlisting language="java"
+  >[jcp:org.forgerock.opendj.examples.PasswordResetForAD:--- JCite encodePassword ---]</programlisting>
+
   <para>If the modifications are easier to construct in LDIF, you can write the
   LDIF to the directory server as shown in the chapter, <link xlink:show="new"
   xlink:href="dev-guide#chap-ldif" xlink:role="http://docbook.org/xlink/role/olink"

--
Gitblit v1.10.0