System Administration Guide: Basic Administration

Authenticating a User by Specifying Named Support Credentials

Before a system's products can be registered, the user or account must be authenticated by specifying valid My Oracle Support credentials or valid Sun Online account credentials. If no support credentials are provided, the system is registered with an anonymous My Oracle Support account. You can use the regadm command with the auth subcommand, either interactively or non-interactively, to authenticate yourself with the Oracle Product Registration System.


Note –

Authentication must take place prior to registering by using the regadm register command.


The regadm auth command is used with the -u and -p options, as follows:


# regadm auth -u username -p pwfile

The -u option specifies a valid user name. The -p option specifies a file that contains password information for the user account.

The password file is a single-line file that you create and then add the credentials that are to be passed to the regadm command. The contents of the password file are private. For security reasons, remove the file immediately after the information is passed to the regadm command and a successful authentication has occurred.


Note –

A successful authentication persists across reboots and only needs to be provided one time. You can authenticate before or during an installation, or after an installation by using the regadm auth command. The password is never stored on the system. Only an opaque token is maintained after a successful authentication.


ProcedureHow to Authenticate a User by Specifying Named Support Credentials

The regadm auth command can be used to authenticate a user with My Oracle Support, either interactively or non-interactively. The following procedure describes how to use the command non-interactively. The examples that follow show how to run the command in both modes.

  1. Become superuser or assume an equivalent role.

  2. Create a temporary password file:


    # touch pwfile
    
  3. Secure permissions on the file:


    # chmod 600 pwfile
    
  4. Using a text editor, edit the temporary password file that you just created. Insert a one-line entry that contains your password information.

  5. Authenticate with My Oracle Support by specifying your named support credentials:


    # regadm auth -u user@example.com -p pwfile
    

    where user@example.com is either the My Oracle Support or Sun Online account user name, and pwfile is the password file that you created in Step 2.

    A message indicating that the authentication succeeded or failed is displayed.

  6. Proceed as follows:

  7. Remove the temporary password file:


    # rm pwfile
    

Example 17–7 Authenticating a User With Named Support Credentials (Non-Interactive)


# touch mospwfile
# chmod 600 mospwfile
# vi mospwfile
.
.
.
# regadm auth -u jdoe@mycompany.com -p mospwfile
Authenticating "jdoe@mycompany.com" with My Oracle Support
Authentication sucessful

You can now register this system with My Oracle Support
via "regadm register"
# rm mospwfile


Example 17–8 Authenticating a User With Named Support Credentials (Interactive)


# regadm auth
Enter your My Oracle Support username: jdoe@mycompany.com
Enter password:
Enter password again:
Authenticating "jdoe@mycompany.com" with My Oracle Support
Authentication successful

You can now register this system with My Oracle Support
via "regadm register"