Rate this page:

What is Trust Onboard?

On October 31, 2022, support for Programmable Wireless Trust Onboard will end. On this date, Programmable Wireless Trust Onboard certificates will no longer be available for sync or download in Console. Trust Onboard certificates that have already been synced to your backend services can continue to be used to authenticate devices until the device certificates expire in 30 years’ time. Trust Onboard SIMs will continue to work for connectivity as regular Programmable Wireless SIMs, which can connect to T-Mobile USA’s network in the United States and their global connectivity partners around the world.

Trust Onboard provisions Programmable Wireless SIM cards with two X.509 client-side certificates. These certificates can be used to authenticate devices when they are making HTTPS connections. You can also authenticate with cloud providers such as Microsoft Azure, or with your own systems, using TLS.

No additional pre-shared keys (API tokens, passwords, request signing) are needed — only a Programmable Wireless SIM card with Trust Onboard. The SIM cards are manufactured with two unique certificates and key pairs. These certificates and keys have different capabilities which are described below.

Check out the guide Working withTrust Onboard to learn how to implement Trust Onboard in your IoT product.

Trust Onboard general use cases

Category Description
Device identity Device identity differentiation at the point of manufacture so that the device manufacturer does not need to install custom software or hardware
Device protection Software integrity
Secure communication API authentication and authorization

How Trust Onboard works

Twilio generates two sets of public and private keys, and two certificates per SIM card. The certificates and their associated keys are called Available and Signing.

The certificates are loaded onto the SIM card during SIM manufacture.

Twilio provides you with an ICCID-to-certificate mapping and the ability to sync certificates to your backend. The ICCID is the SIM card’s 19-digit identification number.

Using the Twilio Breakout SDK for Trust Onboard, you can use the certificates and keys on the SIM card to authenticate your device to your backend service and set up TLS connections.

The Trust Onboard certificates

The Available certificate is located on the SIM card but the text is freely available to the host device. Your code will also have access to the full text of the Available public and private keys. The Available entities are intended to be used with hardware that requires you to hand over this data for HTTPS communication. The Available entities are contained in a simple global platform applet that holds files with read-only permissions.

The Signing certificate and its associated keys are also located inside the SIM card but cannot be read directly. You must utilize TLS libraries such as mBed or OpenSSL that are able to ask the SIM card to sign requests and to perform request encryption. The SIM does so using the Signing entities. The Signing entities are intended for use cases where your hardware allows you to offload TLS communication to the SIM card. The Signing entities are contained in a global platform applet called mIAS that implements a full security suite similar to OpenSSL.

The lifetime of Trust Onboard certificates

Each SIM certificate has an expiration period of 30 years.

Available certificates, which are able to be extracted from the SIM into device memory, can never be replaced. The Available keys and certificate are stored in a location on the SIM card that is read only. For this reason, they are effectively permanent and the certificate should outlive the physical device.

Signing certificates have the same 30-year expiration period as Available.

Twilio Breakout SDK for Trust Onboard

The Twilio IoT Breakout SDK for Trust Onboard provides example code that demonstrate how to utilize the Available and Signing certificates on Trust Onboard-enabled SIM cards. The SDK can be built as a static or dynamic library and linked to your executable.

The guide Working withTrust Onboard shows you how to apply the Breakout SDK to utilize Trust Onboard.

The SDK is available on Github.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

Step 1

Get link

Get a free personal referral link here

Step 2

Give $10

Your user signs up and upgrade using link

Step 3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more