Negotiate

39000

CustomerFlow

ClientFlowType

0

Y

Idempotent

Constant value representing type of flow from customer to CME.

39003

HMACVersion

HMACVersion

0

Y

CME-1-SHA-256

Constant.

39005

HMACSignature

String32Req

32

Y

Contains the HMAC signature.

HMAC signature will be calculated using HMAC data consisting of these fields which should be in ascending order and delimited with new line (\n) characters. There should be no trailing new line.

• RequestTimestamp + '\n' +

• UUID + '\n' +

• SessionID + '\n' +

• FirmID

The HMAC signature is an encoded hash (digest) of the four fields mentioned above using the Secret Key provided by CME. 

In pseudo code:

HmacSHA256(HmacData, secretKey)

39004

AccessKeyID

String20Req

20

Y

Contains the AccessKeyID assigned to this session on this port.

For example: TXkgU2VjcmV0IEtleQ

39001

UUID

uInt64

8

Y

Session Identifier defined as type long (uInt64); CME Group recommends using the number of microseconds since epoch (Jan 1, 1970) as the timestamp.

• Unique at the beginning of the week on Sunday to start with sequence number 1

• Keep using same UUID in midweek Establish messages to maintain continuous sequence numbers

CME track of last known used UUID.

The Negotiate message must be sent prior to the Establish message with a new UUID midweek.

When used after Negotiate, Negotiate.UUID should have the same value as Etablish.UUID or the message will be rejected.

Client systems must use the same UUID for both primary and backup connections if using active-active fault tolerance to ensure that the sequence numbers will continue after a failover. 

39002

RequestTimestamp

uInt64

8

Y

Time of request. CME Group recommends using the number of nanoseconds since epoch (Jan 1, 1970) as the timestamp.

39006

Session

String3Req

3

Y

Session ID.

39007

Firm

String5Req

5

Y

Firm ID.

39008

Credentials

DATA

0

N

Currently not supported; however the length of variable data needs to be set to 0, represented as two bytes 00 00.