doc/html/AdminReference/auarf023.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf022.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf024.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRKEYFILE" HREF="auarf002.htm#ToC_21">KeyFile</A></H2>
  19 <P><STRONG>Purpose</STRONG>
  20 <A NAME="IDX3934"></A>
  21 <A NAME="IDX3935"></A>
  22 <A NAME="IDX3936"></A>
  23 <A NAME="IDX3937"></A>
  24 <A NAME="IDX3938"></A>
  25 <A NAME="IDX3939"></A>
  26 <A NAME="IDX3940"></A>
  27 <A NAME="IDX3941"></A>
  28 <P>Defines AFS server encryption keys
  29 <P><STRONG>Description</STRONG>
  30 <P>The <B>KeyFile</B> file defines the server encryption keys that the AFS
  31 server processes running on the machine use to decrypt the tickets presented
  32 by clients during the mutual authentication process. AFS server
  33 processes perform privileged actions only for clients that possess a ticket
  34 encrypted with one of the keys from the file. The file must reside in
  35 the <B>/usr/afs/etc</B> directory on every server machine. For more
  36 detailed information on mutual authentication and server encryption keys, see
  37 the <I>IBM AFS Administration Guide</I>.
  38 <P>Each key has a corresponding a key version number that distinguishes it
  39 from the other keys. The tickets that clients present are also marked
  40 with a key version number to tell the server process which key to use to
  41 decrypt it. The <B>KeyFile</B> file must always include a key with
  42 the same key version number and contents as the key currently listed for the
  43 <B>afs</B> entry in the Authentication Database.
  44 <P>The <B>KeyFile</B> file is in binary format, so always use the
  45 appropriate commands from the <B>bos</B> command suite to administer
  46 it:
  47 <UL>
  48 <P><LI>The <B>bos addkey</B> command to define a new key
  49 <P><LI>The <B>bos listkeys</B> command to display the keys
  50 <P><LI>The <B>bos removekey</B> command to remove a key from the file
  51 </UL>
  52 <P>In cells that run the United States edition of AFS and use the Update
  53 Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
  54 is customary to edit only the copy of the file stored on the system control
  55 machine. In cells that run the international version of AFS, edit the
  56 file on each server machine individually.
  57 <P><STRONG>Related Information</STRONG>
  58 <P><A HREF="auarf095.htm#HDRBOS_ADDKEY">bos addkey</A>
  59 <P><A HREF="auarf107.htm#HDRBOS_LISTKEYS">bos listkeys</A>
  60 <P><A HREF="auarf111.htm#HDRBOS_REMOVEKEY">bos removekey</A>
  61 <P><A HREF="auarf194.htm#HDRKAS_SETPASSWORD">kas setpassword</A>
  62 <P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
  63 <P><A HREF="auarf241.htm#HDRUPSERVER">upserver</A>
  64 <P><I>IBM AFS Administration Guide</I>
  65 <P>
  66 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf022.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf024.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  67 <!-- Begin Footer Records  ========================================== -->
  68 <P><HR><B>
  69 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  70 </B>
  71 <!-- End Footer Records  ============================================ -->
  72 <A NAME="Bot_Of_Page"></A>
  73 </BODY></HTML>