Stir/Shaken: STI-AS/VS Services

Bulk Solutions takes the complexity of Stir / Shaken away from services providers and makes available a very easy to use API to encrypt and decrypt identiy headers.


STI-AS (Authentication Service)

We will provide you the Stir/Shaken token needed to Digitally Sign your outbound calls.

Step 1: Your switch will send the following POST request to our STI-AS server at stir.bulkvs.com

curl -X POST 'https://stir.bulkvs.com/stir/v1/signing?id=(YOUR ID)&key=(YOUR KEY)' -H "X-RequestID: 4250sidf" -d '{  
"signingRequest":{
"attest":"A",
"dest":{
"tn":[
"+15165749696"
]
},
"orig":{
"tn":"+15512680608"
},
"iat":1623097808,
"origid":"564D81E9-1E01-0586-BEEC-BA755350AFA9"
}
}'
Step 2 (If Verification Passed):Our system will respond back with the following JSON.
Our system will respond back with the identity header you will put in your INVITE to your terminating carrier.


Step 2 (If Verification Fails):Our system will respond back with the following JSON.
Our system will not send a response.

 


STI-VS (Verification Service)

This is where we decode and verify an Inbound Call's Identity Header on your behalf.

Step 1: Your switch will send the following POST request to our STI-VS server at stir.bulkvs.com

 curl -X POST 'https://stir.bulkvs.com/stir/v1/verification?id=(YOUR ID)' -H "X-RequestID: 4250sidf" -d '{ 
"verificationRequest": {
"to": {
"tn": [
"(TO NUMBER)"
]
},
"time": (TIME),
"from": {
"tn": "(FROM NUMBER)"
},
"identity": "(IDENTITY HEADER RECEIVED FROM INBOUND INVITE)"
}
}'



Step 2 (If Verification Passed):Our system will respond back with the following JSON.

{ 
"verificationResponse": {
"attest": "A",
"origid": "(ORIG ID)",
"ppt": "shaken",
"verstat": "TN-Validation-Passed",
"fee": (COST FOR THE VERIFICATION)
}
}

Step 2 (If Verification Fails):Our system will respond back with the following JSON.

{ 
"verificationResponse": {
"reasoncode": 438,
"reasondesc": "Signature validation failed",
"verstat": "TN-Validation-Failed"
}
}



Supported Systems

We support all SoftSwitches which do not have built in mechanisms to preform the STI-AS and STI-VS functions for Stir/Shaken. One such SoftSwitch is Broadworks from Cisco Systems.