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 sets values as follows:

  • iat is the current time.
  • attest uses the value of sti-attest in sti-server.
  • "orig":{"tn":"..."} uses the value from sti-orig-tn-number in sti-heartbeat-config.
  • "dest":{"tn":[ …] uses the value from sti-dest-tn-number in sti-heartbeat-config.
  • origid uses the value from orig-id in sti-server.

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 sets values as follows: gets the values for the 'orig TN' and dest 'TN taken' from your sti-heartbeat-config configuration.

  • iat is the current time.
  • "to":{"tn":"..."} uses the value from sti-dest-tn-number in sti-heartbeat-config.
  • "from":{"tn":[ …] uses the value from sti-orig-tn-number in sti-heartbeat-config.
  • identity uses the value from sti-identity in sti-heartbeat-config, if it is set. If it is not set, identity is not included in the request.

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"},"identity":<sti-identity>}}

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"},"identityHeaders":["xyz"],"to":{"tn":"7777777777"}}}