ACT Commands

This chapter provides ACT (activate) commands for the Cisco ONS 15454, ONS 15327, ONS 15600 and ONS 15310-CL.

1.1  ACT-USER

Activate User

Usage Guidelines

Cisco ONS 15454, ONS 15327, ONS 15600, ONS 15310-CL

This command opens a session with the Network Element (NE).

Note•Passwords are masked for the following security commands: ACT-USER, COPY-RFILE, COPY-IOSCFG, ED-PID, ENT-USER-SECU and ED-USER-SECU. Access to a TL1 session through any means will have the password masked. The CTC Request History and Message Log will also show the masked commands. When a password-masked command is re-issued by double-clicking the command from CTC Request History, the password will still be masked in the CTC Request History and Message Log. The actual password that was previously issued will be sent to the NE. To use a former command as a template only, single-click the command in CTC Request History. The command will be placed in the Command Request text box, where you can edit the appropriate fields prior to reissuing it.

•This command is backwards compatible with userids and passwords from ONS 15454 2.x software versions according to the following rules:

ACT-USER:[TID]:[STRING]:CTAG::[STRING]

–The syntax of the userid (first [STRING]) and the password (second [STRING]) are not checked.

–Invalid syntax for both the userid and password is permitted, but the user can only log in if the userid/password match what is in the database.

–The userid and password cannot exceed 10 characters.

•For the ACT-USER command, it is required that no error code be transmitted except to convey that the login is granted or denied. Per TR-835, Appendix A, Section A.2:

"... the error codes corresponding to ACT ... do not apply to the ACT-USER command because this command requires that no error code be provided to the session request except to indicate that it has been denied. Before a session is established, a specific error code might reveal clues to an intruder attempting unauthorized entry."

•Starting with Release 4.6, the following feature can be turned on or off and the default is off: A new user must change his or her password after establishing a session for the first time before continuing. All TL1 commands except for ED-PID and CANC-USER will be denied until the password is changed. Once the password has been changed, a user can execute any command that his security level allows. If the user logs out without changing his password, each following session will DENY all commands, except ED-PID and CANC-USER, until the password is changed.

Category

Security

Security

N/A

Related Commands

ALW-MSG-SECU

ALW-USER-SECU

CANC

CANC-USER

CANC-USER-SECU

CLR-COND-SECU

DLT-USER-SECU

ED-CMD-SECU

INH-MSG-SECU

INH-USER-SECU

REPT ALM SEUC

REPT EVT SECU

REPT EVT SESSION

RTRV-CMD-SECU

ED-PID

EDU-USER-SECU

ENT-USER-SECU

RTRV-DFLT-SECU

RTRV-USER-SECU

SET-ATTR-SECUDFLT


Input Format

ACT-USER:[<TID>]:<UID>:<CTAG>[::<PID>];

Input Example

ACT-USER:PETALUMA:TERRI:100::MYPASSWD;

Input Parameters

Table 1-1 ACT-USER Input Parameters 

Parameter and Values
Description

UID

The user identifier (userid) of the person logged in. UID can be any combination of up to 10 alphanumeric characters. String. Must not be null

PID

The user password. PID is any combination of up to 10 alphanumeric characters. Passwords are encrypted for security reasons and will be displayed as asterisks (*). String. Must not be null


Output Format

SID DATE TIME
M CTAG COMPLD
"<UID>:<LASTLOGINTIME>,<UNSUCCESSFULLOGINS>"
;

Output Example

TID-000 1998-06-20 14:30:00
M 001 COMPLD
"TERRI:2003-01-02 14-04-49,0"
;

Output Parameters

Table 1-2 ACT-USER Output Parameters 

Parameter and Values
Description

UID

The user identifier (userid) of the person logged in. UID can be any combination of up to 10 alphanumeric characters. String. Must not be null

LASTLOGINTIME

The date and time of the last successful connection to the NE (not including current login). String

UNSUCCESSFULLOGINS

The number of unsuccessful login attempts since the last successful login. Integer