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="[EMAIL PROTECTED]">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"/>
