What is Deep Linking?
Deep linking is a way to open a specific view (or page) within a mobile app using a link. This technique is similar to the way an http hyperlink allows you to open a specific page on a website (e.g., “http://example.com/path/page”). You can click a deep link from inside an email, a website or even another mobile app. Using deep links can make two mobile apps work together seamlessly.
What is the ID123 App Deep Link URI?
The ID123 app deep link URL is: id123://
What is “iid” and “ctid”?
| Variable | Description |
|---|---|
| iid | short for Institution ID |
| ctid | short for Card Template ID |
Where to find “iid” and “ctid”?
- “iid” (Institution ID) is located in the ‘Account Info’ located under ‘Settings’ in the IDMS.
- “ctid” (Card template ID) is located on the ‘Card Templates’ page in the IDMS. Click on the ‘Details’ link on the preferred template to see the template ID.
- NOTE: “IDMS” is short for ID Management System, which is the administrative web portal for account administrators where they issue and manage digital ID cards.
What Deep Link Views are Supported?
| View | Description |
|---|---|
| Profile | Launches the card holder’s Profile View |
| Selected Institution View | Launches the Selected Institution View with a specific institution selected. If the institution has only one card available, it will redirect the user to the Create Card View. If the institution has more than one card, the user will be asked to select a card offered by the institution. |
| Create Card View | Launches the Create Card View for a specific institution. If the template is Self-Issued, the user will need to fill out card details to create a card. If the template is Institution Issued – Self Provisioned, the user will only need to answer security questions to generate their card. |
| Launch Installed Card View | Launches the Card View of an existing card. If the card does not exist, it defaults to the dashboard screen. |
Profile View
URI:
Use Case:
This deep link will direct users to the My Identity View when the user is logged into the mobile app.
Selected Institution View
URI:
How to generate this link?
Log into your account in the IDMS, click on ‘Account Info’ located under the ‘Settings’ section, copy your Institution ID, and paste it into the deep link after “iid=” in place of ‘1b52a69bfa13537e4886a3f057f50f767be9ac1d’.
Use Case:
This deep link will display the Selected Institution View in the app. If there are multiple cards offered by the institution, then they will be prompted to select a card. If there is only one card available for the institution, then the user will be automatically forwarded to create the card. If they are not logged in, the next step will be registration.
Create Card View
URI:
How to generate this link?
- Log into your account in the IDMS, click on ‘Account Info’ located under the ‘Setting’ section, copy the Institution ID, and paste it into the deep link after “iid=” in place of ‘1b52a69bfa13537e4886a3f057f50f767be9ac1d’.
- Log into your account in the IDMS, Click on the ‘Details’ link on the preferred template in the Card Templates page, copy the Card Template ID, and paste it into the deep link after “ctid=” in place of ‘12345fsdadasd’.
Use Case:
This deep link will bring the user to the Create Card View for a specific card. If the template is Self-Issued, the user will need to fill out card details to create a card. If the template is Institution Issued – Self Provisioned, the user will only need to answer security questions to generate their card. This will only happen if the user is logged in, otherwise they will be redirected to the Register/Login page.
Launch Installed Card View
URI:
How to generate this link?
Log into your account in the IDMS, Click on the ‘Details’ link on the preferred template in the Card Templates page, copy the Card Template ID, and paste it into the deep link after ‘ctid=’ in place of ‘12345fsdadasd’.
Use Case:
This deep link will launch a previously installed ID card. This will only happen if the user is logged in, otherwise, they will be redirected to the Register/Login page.