This article describes how to set up Smart ID Mobile App, or an app based on the Smart ID Mobile SDK, to start from another application on the same device. 

...

Prerequisites

The app that is intended to start Smart ID Mobile App must have registered a url-scheme, as described in the article.

...

Add code to start app on idle screen

To open Smart ID Mobile App on the idle screen, waiting for requests:

...

...

1. Add the following code to start Smart ID Mobile App directly from another app on the same device:

   Code Block
   language text
   <URL-Scheme>://start?<Parameter>=<Value>

   For parameter options, see Personal protocol specification.

   Example with a title and a redirect to my-redirect-URL://:

...

...

1. Example: start app with title and redirect

   Code Block
   language text
   personal://start?title=My+title&redirect=my-redirect-URL%3A%2F%2F

...

Add code to start app for provisioning

To open Smart ID Mobile App for provisioning a new mobile virtual smart card for a user:

1. Add the following code to start Smart ID Mobile App directly from another app on the same device:

   Code Block
   language text
   <URL-Scheme>://<Link to message>?<Parameter>=<Value>

   For parameter options, see Personal protocol specification.

   Example with a <link to message>, a title and a redirect to my-redirect-URL://:

...

...

1. Example: start app for provisioning with title and redirect

   Code Block
   language text
   personal://<my-hermod-host>/hermod/rest/ms/ee2fec93-5daf-436f-b7d2-32a7ff86fe75/0573a28d-ecfa-480d-ade6-11d2144953a8?title=My+title&redirect=my-redirect-URL%3A%2F%2F

...

Examples

Example: Link in html

<a href="bank-app://<my-hermod-host>/hermod/rest/ms/ee2fec93-5daf-436f-b7d2-32a7ff86fe75/0573a28d-ecfa-480d-ade6-11d2144953a8?title=My+title&redirect=<my-redirect-URL>">Open with Bank App</a>

Example: Link in JavaScript

var startURL = 'bank-app://start'
window.location.replace(startURL);

Example: Link in Swift 3 for iOS 8-10

let redirect = "bank-app://start".addingPercentEncoding(withAllowedCharacters: .alphanumerics)!
let scheme = "bank-app://start?redirect=\(redirect)"

if let url = URL(string: scheme) {
    if #available(iOS 10, *) {
        let options = [UIApplicationOpenURLOptionUniversalLinksOnly : true]
        UIApplication.shared.open(url, options: options, completionHandler: {
            (success) in
            print("Open \(scheme): \(success)")
            // handle error or success contitions
        })
    } else {
        let success = UIApplication.shared.openURL(url)
        print("Open \(scheme): \(success)")
        // handle error or success contitions
    }
}

Personal protocol specification

...

General syntax

The general syntax to start Smart ID Mobile App is the following: 

<URL-Scheme>://<Message>?<Parameter1>=<Value1>[&<Parameter2>=<Value2>]

<URL-Scheme>

The available values for <URL-Scheme> are described in this table:

...

<Message>

The available values for <Message> are described in this table:

...

personal://<my-hermod-host>/hermod/rest/ms/ee2fec93-5daf-436f-b7d2-32a7ff86fe75/0573a28d-ecfa-480d-ade6-11d2144953a8?title=My+title&redirect=<my-redirect-URL>

...

...

...

<Parameter>=<Value>

The available values for

...

<Parameter> and

...

<Value> are described in this table. Two parameters can be used, separated by '&':

...

...

...

...