Only customising of one QR Code is available to all Partners.
Other branding features like Android Direct Install SHA Key will depend on your tier so please contact your account manager if you would like to learn more.
What is an Android Direct Install Branding (SHA Key)?
Our Android Direct Install Branding feature allows you to customise the user experience when customers install an eSIM on Android devices. By providing a SHA-256 certificate fingerprint (SHA key), you can enable a branded installation flow through your own Android app, ensuring a seamless and consistent brand presence throughout the eSIM activation process.
Passing us your SHA256 key as part of the order process will allow your android app to manage the installation and management of this eSIM as the key is used for validation.
So, by giving us your SHA key:
- the eSIM can be installed directly through your app.
- the customer has a smoother and more trusted experience.
- this is useful if you want the eSIM installation to feel like a natural part of your app instead of sending users somewhere else.
How does it work?
Android OS uses SHA (Secure Hash Algorithm) keys as part of its security mechanism to verify the integrity and authenticity of downloaded content, particularly for app installations. Here's how it works:
1. Digital Signatures: When developers create an Android app, they sign it with their private key. This creates a digital signature for the app package (APK).
2. SHA-256 Fingerprints: The public key certificate used for signing is then hashed using SHA-256 algorithms, creating a unique fingerprint.
3. Submission to eSIM Go: This fingerprint (SHA key) is submitted to us as part of an order for an eSIM.
4. Additon to eSIM: Our eSIM provider encodes this SHA key into the downloadable eSIM (it's part of the payload, not part of the QR code).
5. Verification Process: When your customer downloads an eSIM to their device, Android checks this fingerprint against the one associated with the app in the Play Store or other trusted sources.
6. Integrity Check: If the SHA fingerprints match, it confirms that the eSIM hasn't been tampered with since it was signed by the developer.
7. Security: Since Android has ensured the new eSIM is signed with the same key as the app (there is chain of trust) the app is able to directly install the eSIM without the user having to take any action (e.g. click on a link or scan a QR code)
Android Direct Install SHA Key Setup
To view and start creating your Android Direct Install SHA Key navigate to eSIM Branding in your Portal.
Enter your:
- Android Direct Install Fingerprint SHA Key in the first box below. It should be no longer than 128 characters.
- Chosen Package Name from your Android app
Click Save.