From 06080c1f01184f386afdd3fc726c9c593c890bcf Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Sun, 7 May 2023 22:02:44 +0200
Subject: [PATCH] Ldaptive hints

---
 Doc/Sdi/Ldap/ldap.xml | 86 ++++++++++++++++++++-----------------------
 1 file changed, 39 insertions(+), 47 deletions(-)

diff --git a/Doc/Sdi/Ldap/ldap.xml b/Doc/Sdi/Ldap/ldap.xml
index 66887d1d9..42ff76b23 100644
--- a/Doc/Sdi/Ldap/ldap.xml
+++ b/Doc/Sdi/Ldap/ldap.xml
@@ -1276,7 +1276,7 @@ tar zxf /root/pam.tgz      # Restore your working PAM configuration</screen>
         </listitem>
 
         <listitem>
-          <para> <xref linkend="glo_LDAP"/> user entry DN's must be addressed
+          <para><xref linkend="glo_LDAP"/> user entry DN's must be addressed
           by uid e.g. <code>uid=ldaptest,ou=people,...</code> . On successful
           configuration you should see:</para>
 
@@ -1408,32 +1408,45 @@ shadow:         files ldap</programlisting>
             dependencies to your project's <filename>pom.xml</filename>
             file:</para>
 
-            <programlisting language="xml">&lt;dependencies&gt;
-  &lt;dependency&gt;
-    &lt;groupId&gt;org.ldaptive&lt;/groupId&gt;
-    &lt;artifactId&gt;ldaptive&lt;/artifactId&gt;
-    &lt;version&gt;<emphasis role="red">find my current version on Maven central</emphasis>&lt;/version&gt;
-  &lt;/dependency&gt;
-
-  &lt;dependency&gt;
-    &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
-    &lt;artifactId&gt;slf4j-api&lt;/artifactId&gt;
-    &lt;version&gt;1.7.21&lt;/version&gt;
-  &lt;/dependency&gt;
-
-  &lt;dependency&gt;
-    &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
-    &lt;artifactId&gt;slf4j-simple&lt;/artifactId&gt;
-    &lt;version&gt;1.7.21&lt;/version&gt;
-  &lt;/dependency&gt;
-&lt;/dependencies&gt;</programlisting>
+            <programlisting language="none">&lt;project xmlns="http://maven.apache.org/POM/4.0.0" ... &gt;
+
+  &lt;properties&gt;
+    &lt;slf4j.version&gt;<emphasis role="red">find my current version on Maven central</emphasis>&lt;/slf4j.version&gt;
+       ...
+  &lt;/properties&gt;
+
+  &lt;dependencies&gt;
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.ldaptive&lt;/groupId&gt;
+      &lt;artifactId&gt;ldaptive&lt;/artifactId&gt;
+      &lt;version&gt;<emphasis role="red">find my current version on Maven central</emphasis>&lt;/version&gt;
+    &lt;/dependency&gt;
+
+    &lt;dependency&gt; &lt;!-- required for ldaptive's internal logging --&gt;
+      &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
+      &lt;artifactId&gt;slf4j-api&lt;/artifactId&gt;
+      &lt;version&gt;${slf4j.version}&lt;/version&gt;
+    &lt;/dependency&gt;
+
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.slf4j&lt;/groupId&gt;
+      &lt;artifactId&gt;slf4j-simple&lt;/artifactId&gt;
+      &lt;version&gt;${slf4j.version}&lt;/version&gt;
+    &lt;/dependency&gt; ...</programlisting>
+
+            <tip>
+              <para>Follow <link
+              xlink:href="https://www.swtestacademy.com/how-to-configure-simple-logger-slf4j-log-levels">How
+              To Configure Simple Logger slf4j Log Levels</link> avoiding
+              unrelated <productname>Ldaptive</productname> logging
+              info.</para>
+            </tip>
           </listitem>
         </itemizedlist>
       </tip>
 
-      <para>The idea is reading your own <xref linkend="glo_LDAP"/> entry and
-      write the corresponding attributes according to the following
-      rules:</para>
+      <para>The idea is reading <xref linkend="glo_LDAP"/> entries thereby
+      write corresponding attributes according to the following rules:</para>
 
       <itemizedlist>
         <listitem>
@@ -1478,9 +1491,9 @@ shadow:         files ldap</programlisting>
         </listitem>
       </itemizedlist>
 
-      <para>If your <xref linkend="glo_DN"/> was <code>uid=mistudent,
-      ou=userlist, dc=hdm-stuttgart, dc=de</code> the result should look
-      like:</para>
+      <para>If your own binding <xref linkend="glo_DN"/> was
+      <code>uid=mistudent,ou=userlist,dc=hdm-stuttgart,dc=de</code> the result
+      should look like:</para>
 
       <screen>mail: mistudent@mi.hdm-stuttgart.de
 gidNumber: 31104
@@ -1502,27 +1515,6 @@ homeDirectory: /home/stud/MI/mistudent
 sambaNTPassword: C1E13066AA936CBF9260913EE962B8C2
 sn: Testuser
 matrikelNr: 98911</screen>
-
-      <para>Solution available at:</para>
-
-      <annotation role="make">
-        <para role="eclipse">Sdi/ReadMyData</para>
-      </annotation>
-
-      <para>Notice: The above project will read the required password from a
-      <package>de.hdm_stuttgart.mi.sdai.readmydata.messages.properties</package>
-      file corresponding to
-      <filename>src/main/java/de/hdm_stuttgart/mi/sdai/readmydata/messages.properties</filename>.
-      Due to password protection this file has been excluded from versioning.
-      You will however find <filename>messages.properties.template</filename>
-      next to the intended location containing the appropriate property key
-      name. Using your own account data should enable you running the
-      application.</para>
-
-      <caution>
-        <para>Do not miss changing the value of
-        <code>ReadMyLdap.bindDn</code>!</para>
-      </caution>
     </section>
   </section>
 </chapter>
-- 
GitLab