doc/html/AdminReference/auarf188.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="auarf187.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="auarf189.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="HDRKAS_INTERACTIVE" HREF="auarf002.htm#ToC_202">kas interactive</A></H2>
  19 <P><STRONG>Purpose</STRONG>
  20 <P>Enters interactive mode
  21 <P><STRONG>Synopsis</STRONG>
  22 <PRE><B>kas interactive</B> [<B>-admin_username</B> &lt;<VAR>admin&nbsp;principal&nbsp;to&nbsp;use&nbsp;for&nbsp;authentication</VAR>>]
  23                 [<B>-password_for_admin</B> &lt;<VAR>admin&nbsp;password</VAR>>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  24                 [<B>-servers</B> &lt;<VAR>explicit&nbsp;list&nbsp;of&nbsp;authentication&nbsp;servers</VAR>><SUP>+</SUP>]
  25                 [<B>-noauth</B>]  [<B>-help</B>]
  26
  27 <B>kas i</B> [<B>-a</B> &lt;<VAR>admin&nbsp;principal&nbsp;to&nbsp;use&nbsp;for&nbsp;authentication</VAR>>]
  28       [<B>-p</B> &lt;<VAR>admin&nbsp;password</VAR>>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]
  29       [<B>-s</B> &lt;<VAR>explicit&nbsp;list&nbsp;of&nbsp;authentication&nbsp;servers</VAR>><SUP>+</SUP>]  [<B>-n</B>]  [<B>-h</B>]
  30 </PRE>
  31 <P><STRONG>Description</STRONG>
  32 <P>The <B>kas interactive</B> command establishes an interactive session
  33 for the issuer of the command. By default, the command interpreter
  34 establishes an authenticated connection for the user logged into the local
  35 file system with all of the Authentication Servers listed in the local
  36 <B>/usr/vice/etc/CellServDB</B> file for the cell named in the local
  37 <B>/usr/vice/etc/ThisCell</B> file. To specify an alternate
  38 identity, cell name, or list of Authentication Servers, include the
  39 <B>-admin_username</B>, <B>-cell</B>, or <B>-servers</B> arguments
  40 respectively. Interactive mode lasts for six hours unless the maximum
  41 ticket lifetime for the issuer or the Authentication Server's Ticket
  42 Granting Service is shorter.
  43 <P>There are two other ways to enter interactive mode, in addition to the
  44 <B>kas interactive</B> command:
  45 <OL TYPE=1>
  46 <P><LI>Type the <B>kas</B> command at the shell prompt without any operation
  47 code. If appropriate, include one or more of the
  48 <B>-admin_username</B>, <B>-password_for_admin</B>, <B>-cell</B>,
  49 and <B>-servers</B> arguments.
  50 <P><LI>Type the <B>kas</B> command followed by a user name and cell name,
  51 separated by an <B>@</B> sign (for example: <B>kas
  52 admin@abc.com</B>), to establish a connection under the specified
  53 identity with the Authentication Servers listed in the local
  54 <B>/usr/vice/etc/CellServDB</B> file for the indicated cell. If
  55 appropriate, provide the <B>-servers</B> argument to specify an alternate
  56 list of Authentication Server machines that belong to the indicated
  57 cell.
  58 </OL>
  59 <P>There are several consequences of entering interactive mode:
  60 <UL>
  61 <P><LI>The <TT>ka></TT> prompt replaces the system (shell) prompt. When
  62 typing commands at this prompt, provide only the operation code (omit the
  63 command suite name, <B>kas</B>).
  64 <P><LI>The command interpreter does not prompt for the issuer's
  65 password.
  66 <P>The issuer's identity and password, the relevant cell, and the set of
  67 Authentication Server machines specified when entering interactive mode apply
  68 to all commands issued during the session. They cannot be changed
  69 without leaving the session, except by using the <B>(kas)
  70 noauthentication</B> command to replace the current authenticated
  71 connections with unauthenticated ones. The <B>-admin_username</B>,
  72 <B>-password_for_admin</B>, <B>-cell</B>, and <B>-servers</B>
  73 arguments are ignored if provided on a command issued during interactive
  74 mode.
  75 </UL>
  76 <P>To establish an unauthenticated connection to the Authentication Server,
  77 include the <B>-noauth</B> flag or provide an incorrect password.
  78 Unless authorization checking is disabled on each Authentication Server
  79 machine involved, however, it is not possible to perform any privileged
  80 operations within such a session.
  81 <P>To end the current authenticated connection and establish an
  82 unauthenticated one, issue the <B>(kas) noauthentication</B>
  83 command. To leave interactive mode and return to the regular shell
  84 prompt, issue the <B>(kas) quit</B> command.
  85 <P><STRONG>Options</STRONG>
  86 <DL>
  87 <P><DT><B>-admin_username
  88 </B><DD>Specifies the user identity under which to authenticate with the
  89 Authentication Server for execution of the command. For more details,
  90 see the introductory <B>kas</B> reference page.
  91 <P><DT><B>-password_for_admin
  92 </B><DD>Specifies the password of the command's issuer. If it is
  93 omitted (as recommended), the <B>kas</B> command interpreter prompts for
  94 it and does not echo it visibly. For more details, see the introductory
  95 <B>kas</B> reference page.
  96 <P><DT><B>-cell
  97 </B><DD>Names the cell in which to run the command. For more details, see
  98 the introductory <B>kas</B> reference page.
  99 <P><DT><B>-servers
 100 </B><DD>Names each machine running an Authentication Server with which to
 101 establish a connection. For more details, see the introductory
 102 <B>kas</B> reference page.
 103 <P><DT><B>-noauth
 104 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
 105 issuer. For more details, see the introductory <B>kas</B> reference
 106 page.
 107 <P><DT><B>-help
 108 </B><DD>Prints the online help for this command. All other valid options
 109 are ignored.
 110 </DL>
 111 <P><STRONG>Examples</STRONG>
 112 <P>The following example shows a user entering interactive mode as the
 113 privileged user <B>admin</B>.
 114 <PRE>   % <B>kas interactive admin</B>
 115    Password for admin: <VAR>admin_password</VAR>
 116    ka>
 117
 118 </PRE>
 119 <P><STRONG>Privilege Required</STRONG>
 120 <P>None
 121 <P><STRONG>Related Information</STRONG>
 122 <P><A HREF="auarf181.htm#HDRKAS_INTRO">kas</A>
 123 <P><A HREF="auarf191.htm#HDRKAS_NOAUTH">kas noauthentication</A>
 124 <P><A HREF="auarf192.htm#HDRKAS_QUIT">kas quit</A>
 125 <P>
 126 <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="auarf187.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="auarf189.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>
 127 <!-- Begin Footer Records  ========================================== -->
 128 <P><HR><B>
 129 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 130 </B>
 131 <!-- End Footer Records  ============================================ -->
 132 <A NAME="Bot_Of_Page"></A>
 133 </BODY></HTML>