You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by er...@apache.org on 2004/12/18 01:12:36 UTC

svn commit: r122689 - /incubator/directory/kerberos/trunk/xdocs/configuration.xml /incubator/directory/kerberos/trunk/xdocs/navigation.xml

Author: erodriguez
Date: Fri Dec 17 16:12:35 2004
New Revision: 122689

URL: http://svn.apache.org/viewcvs?view=rev&rev=122689
Log:
Documentation on configuring Kerberos clients in Linux.
Added:
   incubator/directory/kerberos/trunk/xdocs/configuration.xml
Modified:
   incubator/directory/kerberos/trunk/xdocs/navigation.xml

Added: incubator/directory/kerberos/trunk/xdocs/configuration.xml
Url: http://svn.apache.org/viewcvs/incubator/directory/kerberos/trunk/xdocs/configuration.xml?view=auto&rev=122689
==============================================================================
--- (empty file)
+++ incubator/directory/kerberos/trunk/xdocs/configuration.xml	Fri Dec 17 16:12:35 2004
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+  <properties>
+    <author email="erodriguez@apache.org">Enrique Rodriguez</author>
+    <title>Configuring Kerberos Clients</title>
+  </properties>
+  
+  <body>
+
+    <section name="Configuring Kerberos Clients">
+      <subsection name="Linux Configuration">
+        <p>
+          You may use the gnome-kerberos client or command-line tools such as kinit to 
+          perform authentication or change a password in Linux.  Configuration in Linux is
+          in the <code>/etc/krb5.conf</code> text file.  At a minimum, you need to tell Linux
+          the default realm to use.  You also may wish to set the default encryption types,
+          depending on your environment.
+        </p>
+
+        <source>
+[libdefaults]
+ default_realm = EXAMPLE.COM
+ default_tkt_enctypes = des-cbc-md5
+ default_tgs_enctypes = des-cbc-md5
+
+[realms]
+ EXAMPLE.COM = {
+  kdc = kerberos.example.com:88
+  admin_server = kerberos.example.com:749
+  default_domain = example.com
+ }
+
+[domain_realm]
+ .example.com = EXAMPLE.COM
+ example.com = EXAMPLE.COM
+        </source>
+
+        <p>
+          You can install kerberos clients from the apt repositories.  A working GUI client
+          is <code>gnome-kerberos</code> and the command-line tools can be found as
+          <code>krb5-workstation</code>.
+        </p>
+        
+        <source>
+$ apt-get install gnome-kerberos
+        </source>
+        
+        <p>
+          or
+        </p>
+        
+        <source>
+$ apt-get install krb5-workstation
+        </source>
+
+        <p>
+          When you run the gnome-kerberos client (<code>/usr/bin/krb5</code>) after a fresh
+          install, you will see that the <code>EXAMPLE.COM</code> domain is already configured.
+          Users must currently be added to the Eve backing store using LDAP tools.
+        </p>
+
+      </subsection>
+      
+      <subsection name="Changing Your Password">
+        <p>
+          The gnome-kerberos client (<code>/usr/bin/krb5</code>) may also be used to change
+          passwords.  Clicking the button <code>Change Password ...</code> will open a Change
+          Kerberos Password dialog.
+        </p>
+      </subsection>
+
+    </section>
+  </body>
+</document>

Modified: incubator/directory/kerberos/trunk/xdocs/navigation.xml
Url: http://svn.apache.org/viewcvs/incubator/directory/kerberos/trunk/xdocs/navigation.xml?view=diff&rev=122689&p1=incubator/directory/kerberos/trunk/xdocs/navigation.xml&r1=122688&p2=incubator/directory/kerberos/trunk/xdocs/navigation.xml&r2=122689
==============================================================================
--- incubator/directory/kerberos/trunk/xdocs/navigation.xml	(original)
+++ incubator/directory/kerberos/trunk/xdocs/navigation.xml	Fri Dec 17 16:12:35 2004
@@ -28,6 +28,7 @@
       <item name="Change Password Protocol" href="/changepw.html"/>
       <item name="News and Status" href="/news.html"/>
       <item name="Roadmap" href="/roadmap.html"/>
+      <item name="Configuring Clients" href="/configuration.html"/>
     </menu>
     <menu name="Project Information">
       <item name="Open Issues" href="http://nagoya.apache.org/jira/browse/DIRKERBEROS"/>