CALL:SECurity

CALL:SECurity

Last updated: February 14, 2012

GPIB Command Conventions

CALL:SECurity:AUTHenticate:AKAPrime:STATe

Function

 Sets/queries the EAP-AKA' authentication state, i.e. whether the test set will propose the EAP-AKA' protocol as the authentication method during the PPP session negotiation. See Authentication State .

Setting

1|ON|0|OFF

Query

Range: same as setting

*RST Setting

 OFF

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714; "CALL:SECurity:AUTHenticate:AKAPrime:STATe ON"
!Set the authentication state to on.

CALL:SECurity:AUTHenticate:AKAPrime:KEY

Function

 Sets/queries the 32 hex-digits authentication key (K) shared by UE and the authentication server during the authentication procedure. See Authentication Key (K) (Hex) .

Setting

 "0000...0000" to "FFFF...FFFF" (32 hex digits)

Query

Range: same as setting

*RST Setting

 "4147494C454E5420544543484E4F0000"

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:KEY '4147494C454E5420544543484E4F0000'"
!Set the hex-digits authentication key (K) to 4147494C454E5420544543484E4F0000

CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:CFIeld

Function

 Sets/queries the Operator Variant Parameter Value (Hex) (in 32 hex-digit) which is an input parameter of the AKA' authentication functions. Whether this value will be counted as OP or OPc depends on CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:PTYPe .

Setting

 "0000...0000" to "FFFF...FFFF" (32 hex digits)

Query

Range: same as setting

*RST Setting

 "00000000000000000000000000000000"

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:CFIeld '00000000000000000000000000000000'"
!Set the Operator Variant Algorithm Configuration Field (OP) to 00000000000000000000000000000000

CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:PTYPe

Function

 Sets/queries the Operator Variant Parameter Type . This parameter determines whether OP or OPc will be counted as the CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:CFIeld .

Setting

 OP |OPc

Query

Range: same as setting

*RST Setting

 OP

Requirements

Lab Application Revision: D.00.09 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:OPVariant:PTYPe  OP"
!Set the Operator Variant Parameter Type to OP.

CALL:SECurity:AUTHenticate:AKAPrime:AMF

Function

 Sets/queries the Authentication Management Field (AMF) in 4 hex-digit which is an parameter of the AKA' authentication algorithms. See Authentication Management Field (AMF) (Hex) .

Setting

 "0000" to "FFFF"

Query

Range: same as setting

*RST Setting

"8000"

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:AMF '8000'"
!Set the AMF value to 8000

CALL:SECurity:AUTHenticate:AKAPrime:SQN:RESet[:IMMediate]

Function

 Reset the Authentication Sequence Number (SQN) in the test set to zero. See Reset the Authentication Sequence Number .

Setting

 no setting

Query

 no query

*RST Setting

 None

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:SQN:RESet"
!Reset the Authentication Sequence Number (SQN) to zero

CALL:SECurity:AUTHenticate:AKAPrime:RANDom

Function

 Sets /queries the RAND Value. See Random (RAND) Value (Hex) .

Setting

 "0" to "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF" (1 to 32 characters from the set 0123456789ABCDEF)

Query

 Same as setting

*RST Setting

 None

Requirements

Lab Application Revision: D.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:RANDom `FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF'"
!Set the RAND Value to FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

CALL:SECurity:AUTHenticate:AKAPrime:RANDom:CURRent?

Function

 Queries the current RAND Value.

Query

 "0" to "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF" (1 to 32 characters from the set 0123456789ABCDEF)

*RST Setting

 None

Requirements

Lab Application Revision: D.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:RANDom:CURRent?"
!Query the current RAND Value.

CALL:SECurity:AUTHenticate:AKAPrime:RESult?

Function

Queries the EAP-AKA' Authentication Result. The result will indicate one of these:

  • UNKN - None, the EAP-AKA' authentication procedure is not performed.
  • SUCC - Success, the EAP-AKA' procedure is successfully finished.
  • IMAC - Authentication Failure, MAC Not Match.
  • IRES - Authentication Failure, RES Not Match
  • IRL - Authentication Failure, Incorrect RES Length.
  • ANGF - Authentication Failure, General Failure.
  • NRES - Authentication Failure, No Response.
  • SFA - Authentication Failure, Synch Failure.
  • UER - UE Authentication Failure, AUTN Rejected by UE.
  • UEGF - UE Authentication Failure, General Failure Reported by UE.

Setting

 no setting

Query

Range: UNKN | SUCC | IMAC | IRES | IRL | ANGF | NRES | SFA | UER | UEGF

*RST Setting

 UNKN

Requirements

Lab Application Revision: C.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SECurity:AUTHenticate:AKAPrime:RESult?"
!Queries the EAP-AKA' authentication result.