File:  [NetBSD Developer Wiki] / wikisrc / kerberos / system.mdwn
Revision 1.3: download - view: text, annotated - select for diffs
Thu Nov 5 03:14:44 2009 UTC (4 years, 5 months ago) by wiki
Branches: MAIN
CVS tags: HEAD
web commit by schmonz: add best-guess XP instructions (incomplete)

[[!tag kerberos howto]]

#### Why enable Kerberos on your system?

Convenience and security. With
[Kerberos](http://web.mit.edu/Kerberos/dialogue.html), a single
login grants access to all NetBSD web services. Configuration is easy
and you only have to do it once (sometimes less).

#### [[!toggle id="macosx" text="Mac OS X"]]
[[!toggleable id="macosx" text="""
OS X autodiscovers and uses the NETBSD.ORG KDC as defined in DNS.
To use Kerberized TNF services, log in with your Kerberos [[password]]:

`$ kinit <username>@NETBSD.ORG`

The right-hand side is a Kerberos realm, not a DNS domain. Case is significant!
"""]]

#### [[!toggle id="netbsd" text="NetBSD"]]
[[!toggleable id="netbsd" text="""
NetBSD needs to be configured to prevent Kerberos from being used
to log into _your_ system, and then to enable Kerberos.

7. Either disable Kerberos auth for `sshd`, `login`, etc. in
`/etc/pam.d`, or tell your relevant services not to use PAM.  
(Note that disabling KerberosAuthentication in `/etc/ssh/sshd_config`
does NOT prevent `sshd` from invoking `pam_krb5.so` and prompting
for a Kerberos password -- oops. Since you probably do not have a
host key in the realm NETBSD.ORG you have little to fear from ssh's
KerberosAuthentication method -- nothing can get tickets to use
your machine, because there is no host instance for your machine
shared between the NetBSD kerberos server and your local keytab.
So, the bottom line: turn off UsePAM for `sshd` or adjust your PAM
configuration; don't worry about KerberosAuthentication or
GSSAPIAuthentication in `sshd` itself.)
7. Create `/etc/krb5.conf` containing only the line `[libdefaults]`.

NetBSD will now autodiscover and uses the NETBSD.ORG KDC as defined
in DNS. To use Kerberized TNF services, log in with your Kerberos
[[password]]:

`$ kinit <username>@NETBSD.ORG`

The right-hand side is a Kerberos realm, not a DNS domain. Case is significant!
"""]]

#### [[!toggle id="windows" text="Windows XP"]]
[[!toggleable id="windows" text="""
Windows docs generally assume you want to add your machine to the realm and use Kerberos logins as system logins. This is not what we want.

Progress so far:

7. Download [Windows XP Service Pack 2 Support Tools](http://www.microsoft.com/downloads/details.aspx?FamilyId=49AE8576-9BB9-4126-9761-BA8011FABF38).
7. Install custom/full (whatever it takes to get everything installed).
7. From the Start menu, choose Run and enter `cmd` to get to the prompt.
7. `ksetup /AddKdc NETBSD.ORG`
7. `ksetup /MapUser <username>@NETBSD.ORG "%USERNAME%"`

This may or may not be on the right track. Don't know how to `kinit <username@NETBSD.ORG>` yet.
"""]]

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb