kas_create

Section: AFS Command Reference (8)
Updated: OpenAFS
Index

NAME

kas create - Creates an entry in the Authentication Database

SYNOPSIS

kas create << -name <name of user >>>
    << [-initial_password <initial password] >>>
    << [-admin_username <admin principal to use for authentication] >>>
    << [-password_for_admin <admin password] >>> << [-cell <cell name] >>>
    << [-servers <explicit list of authentication servers+] >>>
    [-noauth] [-help]

kas c << -na <name of user >>> << [-i <initial password] >>>
    << [-a <admin principal to use for authentication] >>>
    << [-p <admin password] >>> << [-c <cell name] >>>
    << [-s <explicit list of authentication servers+] >>> [-no] [-h]

DESCRIPTION

The kas create command creates an entry in the Authentication Databasefor the user named by the -name argument.

To avoid having the account's initial password echo visibly at the shellprompt, omit the -initial_password argument; the command interpreterprompts for the password and does not echo it visibly. Whether or not-initial_password is omitted, the Authentication Server converts thepassword into a form suitable for use as an encryption key, and records itin the entry's key field.

To alter settings in an Authentication Database entry, use the kassetfields command. To examine an entry, use the kas examinecommand. To list every entry in the database, use the kas list command.

OPTIONS

-name <name of user>: Names the new Authentication Database entry. Because it is the name underwhich the user logs in, it must obey the restrictions that many operatingsystems impose on user names (usually, to contain no more than eightlowercase letters).
-initial_password <initial password>: Sets the user's password; provide a character string that can includeuppercase and lowercase letters, numerals and punctuation. TheAuthentication Server scrambles the string into an octal string suitablefor use as an encryption key before placing it in the entry's keyfield. If this argument is omitted, the command interpreter prompts forthe string and does not echo it visibly.
-admin_username <admin principal>: Specifies the user identity under which to authenticate with theAuthentication Server for execution of the command. For more details,see the kas(8) manpage.
-password_for_admin <admin password>: Specifies the password of the command's issuer. If it is omitted (asrecommended), the kas command interpreter prompts for it and does notecho it visibly. For more details, see the kas(8) manpage.
-cell <cell name>: Names the cell in which to run the command. For more details, seethe kas(8) manpage.
-servers <authentication servers>: Names each machine running an Authentication Server with which toestablish a connection. For more details, see the kas(8) manpage.
-noauth: Assigns the unprivileged identity anonymous to the issuer. For moredetails, see the kas(8) manpage.
-help: Prints the online help for this command. All other valid options areignored.

EXAMPLES

The following example shows the prompts that appear when an administratorlogged in as admin creates an Authentication Database entry for theuser smith, and does not include either the -initial_password or-password_for_admin arguments.

   % kas create smith   Password for admin:   initial_password:   Verifying, please re-enter initial_password:

PRIVILEGE REQUIRED

The issuer must have the ADMIN flag set on his or her AuthenticationDatabase entry.

COPYRIGHT

This documentation is covered by the IBM Public License Version 1.0. It wasconverted from HTML to POD by software written by Chas Williams and RussAllbery, based on work by Alf Wachsmann and Elizabeth Cassell.

This document was created byman2html,using the manual pages.