- Full attestation (A) — the service provider has authenticated its relationship with the customer making the call and the customer is authorized to use the calling number.
- Partial attestation (B) — the service provider has authenticated its relationship with the customer making the call, but cannot verify that the customer is authorized to use the calling number.
- Gateway attestation (C) — the service provider has authenticated that it has placed the call on its network, but has no relationship with the originator of the call (for example, a call received from an international gateway).
Outbound calling from Plivo’s network
For outbound calls, STIR verification may have three possible statuses:- Verified status applies to calls that obtain Full **attestation (A**). This means Plivo is able to validate the calling line identification (CLI) or the call originated from a rented DID on the Plivo platform. This DID should belong to the same Plivo account that originates outbound calls.
- Not Verified status applies to calls that have either Partial or Gateway (B or C) attestation or that are unsigned. This status indicates that Plivo lacks sufficient information for A-level attestation and the calling number is not a Plivo rented DID.
- Not Applicable indicates that STIR/SHAKEN doesn’t apply to this call, as is the case if a call is not addressed to a US number.
Plivo console logs
In the SIP response, Plivo sends a header called X-Plivo-Stir-Verification whose value is one of the aforementioned three states.Notes:
- Call signing logic is subjected to evolve as the STIR/SHAKEN ecosystem evolves.
- Since toll-free prefixes are the same across North America, some calls to non-US toll-free numbers may have the status “Verified” or “Not Verified,” but since STIR verification is applicable only to US calls, the actual status should be read as “Not Applicable.”
Example SIP traces
Inbound calling to Plivo’s network
Any inbound call that has an identity header as part of the SIP INVITE will be verified using a verification service, and a corresponding verification status will be presented in the custom SIP header X-Plivo-Stir-Verification. For inbound calls, STIR verification may have three possible statuses:- Verified, when the verstat received as part of the PAID header is TN-Validation-Passed
- Not Verified, when the verstat received as part of the PAID header is either No-TN-Validation or TN-Validation-Failed
- Not Applicable, when an identity header is not received as part of the SIP INVITE and thus the incoming call source couldn’t be verified
Plivo console logs
You can also see STIR verification values on the Zentrunk > Logs page of the console as part of CDR.Example SIP traces
Note:
Plivo is also working on sending in the P-Attestation-Indicator, to highlight the exact attestation level, and P-Origination-ID, for a traceback for robocalling.