com.sun.enterprise.security.cli.create-password-alias.1 Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of realms
There is a newer version: 10.0-b28

Administration Commands;                 create-password-alias(1)

NAME
     create-password-alias - creates a password alias

SYNOPSIS
     create-password-alias
     [--terse={true|false}][ --echo={true|false} ]
     [ --interactive={true|false} ] [ --host  host]
     [--port port] [--secure| -s ] [ --user  admin_user]
     [--passwordfile filename] [--help]
      aliasname

DESCRIPTION
     This command creates an alias for a password and  stores  it
     in   domain.xml.   An   alias   is   a  token  of  the  form
     ${ALIAS=password-alias-password}. The password corresponding
     to  the  alias  name  is  stored  in  an encrypted form. The
     create-password-alias command takes both a  secure  interac-
     tive  form  (in  which the user is prompted for all informa-
     tion) and a more script-friendly form, in which the password
     is propagated on the command line.

     This command is supported in remote mode only.

OPTIONS
     -t --terse

         Indicates that any output data  must  be  very  concise,
         typically avoiding human-friendly sentences and favoring
         well-formatted data for consumption by a script. Default
         is false.

     -e --echo
         If set to true, the command-line statement is echoed  on
         the standard output. Default is false.

     -I --interactive

         If set to true (default),  only  the  required  password
         options are prompted.

     -H --host
         The machine name where the domain administration  server
         is running. The default value is localhost.

     -p --port

         The HTTP port or HTTPS  port  for  administration.  This

Java EE 6           Last change: 30 Jan 2007                    1

Administration Commands;                 create-password-alias(1)

         port is the port in the URL that you specify in your web
         browser   to   manage   the   domain,    for    example,
         http://localhost:4848.

         The default port number for administration is 4848.

     -s --secure

         If set to true, uses SSL/TLS  to  communicate  with  the
         domain administration server.

         The default is false.

     -u --user
         The user name of the authorized administrative  user  of
         the domain administration server.

         If you have authenticated to a domain by using the asad-
         min  login  command,  you  need  not  specify the --user
         option for subsequent operations on the domain.

     --passwordfile

         Specifies the name, including the full path, of  a  file
         that contains the password entries in a specific format.

         The entry for a password must have the AS_ADMIN_  prefix
         followed  by the password name in uppercase letters. For
         example, to specify the password for the domain adminis-
         tration server, use an entry with the following format:

           AS_ADMIN_PASSWORD=password

         In this example, password is  the  actual  administrator
         password.

         The following other passwords can also be specified:

             o    AS_ADMIN_MAPPEDPASSWORD

             o    AS_ADMIN_USERPASSWORD

             o    AS_ADMIN_ALIASPASSWORD
         All remote  commands  must  specify  the  administration
         password  to  authenticate  to the domain administration
         server. The password can be specified by one of the fol-
         lowing means:

             o    Through the --passwordfile option

Java EE 6           Last change: 30 Jan 2007                    2

Administration Commands;                 create-password-alias(1)

             o    Through the asadmin login command

             o    Interactively at the command prompt
         The asadmin login command can be used  only  to  specify
         the  administration  password.  For other passwords that
         remote commands require, use the  --passwordfile  option
         or specify them at the command prompt.

         After authenticating to a domain by  using  the  asadmin
         login  command,  you need not specify the administration
         password through the --passwordfile  option  for  subse-
         quent  operations  on  the  domain.  However,  only  the
         AS_ADMIN_PASSWORD option is not required. You still must
         provide    the    other    passwords,    for    example,
         AS_ADMIN_USERPASSWORD, when required by individual  com-
         mands, such as update-file-user.

         For security reasons, a password that is specified as an
         environment variable is not read by the asadmin command.

         The  default  value   for   AS_ADMIN_MASTERPASSWORD   is
         changeit.

     --help

         Displays the help text for the command.

OPERANDS
     aliasname
         The name of the alias password  as  it  appears  in  the
         domain.xml file.

EXAMPLES
     Example 1 Using create-password-alias command in interactive
     mode

       asadmin> create-password-alias --user admin --passwordfile /home/password.txt
       --interactive=true jmspassword-alias
       Please enter the alias password>
       Please enter the alias password again>
       Command create-password-alias executed successfully.

EXIT STATUS
     0                   command executed successfully

Java EE 6           Last change: 30 Jan 2007                    3

Administration Commands;                 create-password-alias(1)

     1                   error in executing the command

SEE ALSO
     delete-password-alias(1), list-password-aliases(1),  update-
     password-alias(1)

Java EE 6           Last change: 30 Jan 2007                    4