11.12.3.4.127. Function Se05x_API_SetPlatformSCPRequest

11.12.3.4.127.1. Function Documentation

smStatus_t Se05x_API_SetPlatformSCPRequest(pSe05xSession_t session_ctx, SE05x_PlatformSCPRequest_t platformSCPRequest)

Se05x_API_SetPlatformSCPRequest

Sets the required state for platform SCP (required or not required). This is a persistent state.

If platform SCP is set to SCP_REQUIRED, any applet APDU command will be refused by the applet when platform SCP is not enabled. Enabled means full encryption and MAC, both on C-APDU and R-APDU. Any other level is not sufficient and will not be accepted. SCP02 will not be accepted (as there is no response MAC and encryption).

If platform SCP is set to “not required,” any applet APDU command will be accepted by the applet.

This command can only be used in a session that used the credential with identifier RESERVED_ID_PLATFORM_SCP as authentication object.

Note that the default state is SCP_NOT_REQUIRED.

Command to Applet

Field

Value

Description

CLA

0x80

INS

INS_MGMT

See SE05x_INS_t

P1

P1_DEFAULT

See SE05x_P1_t

P2

P2_SCP

See SE05x_P2_t

Lc

#(Payload)

Payload

TLV[TAG_1]

1-byte SE05x_PlatformSCPRequest_t

Le

R-APDU Body

NA

R-APDU Trailer

SW

Description

SW_NO_ERROR

The command is handled successfully.

Parameters
  • [in] session_ctx: Session Context [0:kSE05x_pSession]

  • [in] platformSCPRequest: platf scp req [1:kSE05x_TAG_1]