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.