Example STI Server Heartbeat Requests

This section provides examples of ATIS and 3GPP STI server heartbeat requests.

ATIS Requests

For SHAKEN authentication heartbeat messages, the system gets the values for the 'orig TN' and dest 'TN taken' from your sti-heartbeat-config configuration. The system gets the values for the 'origid' and 'attest' from your sti-server configuration.

The following is an example ATIS authentication heartbeat message.

POST /StirShakenWeb/resources/v1/signing HTTP/1.1
Host: stirshaken.oracle.com
Content-Type: application/json
X-RequestID: 4c7a2de8-1d8f-4b56-4ef5-0585fee32d15
Accept: application/json
Content-Length: 169

{"signingRequest":{"iat":1683545181,"attest":"B","ppt":"shaken","dest":{"tn":["7777777777"]},"orig":{"tn":"9999999999"},"origid":"00000000-0000-0000-0000-0000000f0abc"}}

For SHAKEN verification heartbeat messages, the system gets the values for the 'from TN' and the 'to TN' taken from your sti-heartbeat-config configuration, and uses the current time.

The following is an example ATIS verification heartbeat message.

POST /StirShakenWeb/resources/v1/verification HTTP/1.1
Host: stirshaken.oracle.com
Content-Type: application/json
X-RequestID: 67188cde-f7ea-434e-55dd-53b57af06333
Accept: application/json
Content-Length: 97

{"verificationRequest":{"time":1683538513,"to":{"tn":["7777777777"]},"from":{"tn":"9999999999"}}}

3GPP Requests

For SHAKEN and DIV authentication heartbeat messages, the system gets the values for the 'orig TN' and dest 'TN taken' from your sti-heartbeat-config configuration. The system gets the values for the 'origid' and 'attest' from your sti-server configuration. The 'iat' parameter is the current time.

The following is an example 3GPP SHAKEN Authentication heartbeat message.

POST /StirShakenWeb/resources/v1/signing HTTP/1.1
Host: stirshaken.oracle.com
Accept: application/json
Content-Type: application/json
Content-Length: 169

{"signingRequest":{"iat":1683544351,"attest":"B","ppt":"shaken","dest":{"tn":["7777777777"]},"orig":{"tn":"9999999999"},"origid":"00000000-0000-0000-0000-0000000f0abc"}}

The following is an example 3GPP DIV Authentication heartbeat message.

POST /StirShakenWeb/resources/v1/divSigning HTTP/1.1
Host: stirshaken.oracle.com
Accept: application/json
Content-Type: application/json
Content-Length: 121

{"signingRequest":{"iat":1683544351,"ppt":"div","dest":{"tn":["3333333333"]},"div":{"tn":"7777777777"},"orig":{"tn":"9999999999"}}}

For SHAKEN and DIV verification heartbeat messages, the system gets the values for the 'orig TN' and dest 'TN taken' from your sti-heartbeat-config configuration. The 'iat' parameter is the current time.

The following is an example 3GPP SHAKEN verification heartbeat message.

POST /StirShakenWeb/resources/v1/verification HTTP/1.1
Host: stirshaken.oracle.com
Accept: application/json
Content-Type: application/json
Content-Length: 95

{"verificationRequest":{"to":{"tn":"7777777777"},"time":1683544122,"from":{"tn":"9999999999"}}}

The following is an example 3GPP DIV verification heartbeat message.

POST /StirShakenWeb/resources/v1/divVerification HTTP/1.1
Host: stirshaken.oracle.com
Accept: application/json
Content-Type: application/json
Content-Length: 148

{"verificationRequest":{"time":1683543455,"from":{"tn":"9999999999"},"dest":{"tn":"3333333333"},"identityHeaders":["xyz"],"to":{"tn":"7777777777"}}}