Quickstart: iOS WKWebView

1
// Create the web view and show it
2
private lazy var webView: WKWebView = {
3
  let config = WKWebViewConfiguration()
4
  // allowsInlineMediaPlayback is required, as it defaults to false on some devices like iPads.
5
  // If unset, will cause the camera capture flow to be fullscreen instead of inline.
6
  config.allowsInlineMediaPlayback = true
7
8
  let webView = WKWebView(frame: .zero, configuration: config)
9
  return webView
10
}()
11
webView.navigationDelegate = self
12
webView.allowsBackForwardNavigationGestures = false
13
webView.scrollView.bounces = false
14
// Add the web view and set up its contstraints
15
view.addSubview(webView)
16
webView.translatesAutoresizingMaskIntoConstraints = false
17
NSLayoutConstraint.activate([
18
    webView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
19
    webView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
20
    webView.topAnchor.constraint(equalTo: view.topAnchor),
21
    webView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
22
])
23
24
// Add the Persona configuration options as query items.
25
// See the Persona docs (<http://documentation.withpersona.com)> for full documentation.
26
var components = URLComponents(string: "<https://withpersona.com/verify")>
27
components?.queryItems = [
28
    URLQueryItem(name: "is-webview", value: "true"),
29
    URLQueryItem(name: "environment-id", value: "<your template ID starting with env_>"),
30
    URLQueryItem(name: "template-id", value: "<your template ID starting with itmpl_>"),
31
    URLQueryItem(name: "reference-id", value: "myReference"),
32
    URLQueryItem(name: "redirect-uri", value: "<https://myRedirectUri.com>"),
33
    // optional - specify theme for new inquiry
34
    // URLQueryItem(name: "theme-id", value: "the_Z7S2Ltor9fp2oEGXMLXBPsHa"),
35
]
36
37
// Create and load the Persona URL request
38
guard let urlString = components?.string, let url = URL(string: urlString) else { return }
39
let request = URLRequest(url: url)
40
webView.load(request)

1
extension MyViewController: WKNavigationDelegate {
2
3
    /// Handle navigation actions from the web view.
4
    func webView(_ webView: WKWebView, 
5
        decidePolicyFor navigationAction: WKNavigationAction, 
6
        decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
7
        
8
        // Check if we are being redirected to our `redirectUri`. This happens once verification is completed.
9
        guard let redirectUri = navigationAction.request.url?.absoluteString, redirectUri.starts(with: "<https://myRedirectUri.com")> else {
10
            // We're not being redirected, so load the URL.
11
            decisionHandler(.allow)
12
            return
13
        }
14
15
        // At this point we're done, so we don't need to load the URL.
16
        decisionHandler(.cancel)
17
18
        // Get the inquiryId from the query string parameters.
19
        guard let queryParams = parseQueryParameters(url: navigationAction.request.url),
20
            let inquiryId = queryParams["inquiry-id"] else {
21
22
            // If we do not have an inquiry ID we know we have failed verification.
23
            // You will likely want to transition the view here to show this.
24
            return
25
        }
26
27
        // If we have an inquiry ID we know we have passed verification.
28
        // You will likely want to transition the view here to show this.
29
    }
30
}