Adding Stir/Shaken Identity Header to Outbound Calls Using Tiltx

Owned by Kelli Higdon
Last updated: Mar 06, 2024
2 min read

Preamble

If you have a requirement to add a Stir/Shaken attestation to calls leaving a FreePBX/PBXact system and you have an account with Tiltx, you can use their callshaper API to add an S/S identity header to outbound calls. There are a few third party services that will assist with generating S/S attestations for SIP calls, the Tiltx callshaper API does not rely on an SBC or proxy between the PBX and the provider.

This information is current as of 2022-05-20. Subsequent developments in FreePBX, Asterisk or in Tiltx APIs may render it obsolete. Consult reference for additional info https://help.smartcarrier.io/portal/en/kb/articles/tiltx-call-shaper-module

Prerequisites

  • FreePBX/PBXact version 15/16 and Asterisk version 18/19. This dialplan requires support for the Asterisk dialplan function 'JSON_DECODE' 

  • Account with Tiltx configured for Stir/Shaken and and API key from Tiltx

PBX Config

Add the following code to the PBX in the file /etc/asterisk/extensions_custom.conf

[macro-dialout-trunk-predial-hook] ; history   2022-05-20 first commit ;           2022-07-08 Update for forwarded calls and check for valid API return value exten => s,1,Noop(Entering user defined context macro-dialout-trunk-predial-hook in extensions_custom.conf)   ; setup curlopts and curl API call with call params exten => s,n,Set(CURLOPT(httptimeout)=10)    ; give up if we don't get a reply from API in 10s exten => s,n,Set(CURLOPT(httpheader)=x-api-key: Tiltx-API-KEY)         ; substitute your actual Tiltx API key exten => s,n,Set(CURLOPT(httpheader)=Content-Type: application/json) exten => s,n,Set(response=${CURL(https://api.shaper.tiltx.com/Calls/shaper?ToNumber=${OUTNUM}&FromNumber=${CALLERID(num)})})   ; check if we get a header back from Tiltx and skip to end if not exten => s,n,GotoIf($["${JSON_DECODE(response,Identity)}"=""]?finish) exten => s,n,Set(IdentityHeader=${JSON_DECODE(response,Identity)})            ; JSON_DECODE requires recent Asterisk versions 16/18/19 exten => s,n,GoSub(func-set-sipheader,s,1(Identity,${IdentityHeader}))   exten => s,n(finish),MacroExit()   ; end macro-dialout-trunk-predial-hook

Substitute your Actual API key where indicated, save the file, and reload the dialplan.

Example outbound call

From the Asterisk Console, make an outbound call. If the dialplan is working correctly, there will be a section that looks like this:

-- Executing [s@macro-dialout-trunk-predial-hook:1] NoOp("PJSIP/7002-00000032", "Entering user defined context macro-dialout-trunk-predial-hook in extensions_custom.conf") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:2] Set("PJSIP/7002-00000032", "CURLOPT(httptimeout)=10") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:3] Set("PJSIP/7002-00000032", "CURLOPT(httpheader)=x-api-key: QQaUA3bSXa1ncE8vol0sV6bHIyEXSdfb2staWyQp") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:4] Set("PJSIP/7002-00000032", "CURLOPT(httpheader)=Content-Type: application/json") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:5] Set("PJSIP/7002-00000032", "response={"RequestGuid":"c19636d3-1c96-4efe-8112-45b8737fbeda","AccountGuid":"c88a4b90-86c5-4c35-8f53-7c860d3866bb","ToNumber":"<<redacted>>","FromNumber":"<<redacted>>","IPAddress":"<<redacted>>","Country":"US","IsDNC":"false","IsDIDManager":"false","IsDisconnected":"false","CallerIDToUse":null,"Identity":"long_Identity_string_shortened_for_clarity","CAID":"c19636d3-1c96-4efe-8112-45b8737fbeda","AttestationLevel":"B","SHAKEN_Server":"ca.shaken.tiltx.internal","IsInternallyFlagged":"false","RoutingNumber":"17159721948","LERGInformation":{"RequestGuid":"f188ce8b-a79b-4027-a16d-f3525c586767","NPANXX":1715972,"Block":"1","USState":"WI","AssignedTo":"BANDWIDTH.COM CLEC, LLC - WI","AssignedTo_OCN":"007F","Type":"CLEC","Ilec":"WISCONSIN BELL INC","Ilec_OCN":"9327","Lata":"350","RequestedAt":"2022-06-17T19:15:54.6658375Z","ElapsedMilliseconds":0},"DIDLERG":{"RequestGuid":"13ab720a-8258-440e-a3fe-cd7f8fe4b4c3","NPANXX":1920886,"Block":"8","USState":"WI","AssignedTo":"TDS METROCOM, INC. - WI","AssignedTo_OCN":"7804","Type":"CLEC","Ilec":"WISCONSIN BELL INC","Ilec_OCN":"9327","Lata":"350","RequestedAt":"2022-06-17T19:15:54.6776668Z","ElapsedMilliseconds":0},"DNCInformation":null,"TILTXID":"c19636d3-1c96-4efe-8112-45b8737fbeda","ServiceData":null,"RequestedAt":"2022-06-17T19:15:54.2442607Z","CompletedAt":"2022-06-17T19:15:54.8671704Z","ProcessingTime":"622.9097","ReturnCode":200,"ReturnStatus":"Attestation B assigned - Number not Found"}") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:6] Set("PJSIP/7002-00000032", "IdentityHeader=long_Identity_string_shortened_for_clarity") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:7] Gosub("PJSIP/7002-00000032", "func-set-sipheader,s,1(Identity,long_Identity_string_shortened_for_clarity)") in new stack -- Executing [s@func-set-sipheader:1] NoOp("PJSIP/7002-00000032", "Sip Add Header function called. Adding Identity = long_Identity_string_shortened_for_clarity") in new stack -- Executing [s@func-set-sipheader:2] Set("PJSIP/7002-00000032", "HASH(__SIPHEADERS,Identity)=long_Identity_string_shortened_for_clarity") in new stack -- Executing [s@func-set-sipheader:3] Return("PJSIP/7002-00000032", "") in new stack -- Executing [s@macro-dialout-trunk-predial-hook:8] MacroExit("PJSIP/7002-

Return to Documentation Home I Return to Sangoma Support