QR Code Login for iOS | Authentication, Security, and Identity in Mobile Apps | Mobile SDK Development Guide

To configure QR code login for an iOS app, follow these steps.

Create an App by Using iOSNativeSwiftTemplate

The iOSNativeSwiftTemplate includes sample code for setting up QR code login. Find iOSNativeSwiftTemplate in Mobile SDK’s GitHub repository: github.com/forcedotcom/SalesforceMobileSDK-Templates.

To create an app by using the template, see Creating an iOS Project with Forceios.

Configure Your App to Open Links from a QR Code

To configure your app to open the login link when a user scans the QR code in the camera app, see the Apple documentation.

Configure Camera Usage for In-App QR Code Scanning

To request camera access and scan QR codes on your app, update the camera app’s usage description according to Apple’s documentation: NSCameraUsageDescription | Apple Developer Documentation

Enable App QR Code Login Features

In iOSNativeSwiftTemplate, QR code login features are labeled by this comment: “Log in via Salesforce UI Bridge API generated QR codes.”

To enable QR code login features in iOSNativeSwiftTemplate, modify these files.

AppDelegate.swift

To configure the QR code login setup to run on app initialization, go to the init method and uncomment the call to setupQrCodeLogin.

1override init() {
2
3  // Uncomment when enabling log in via Salesforce UI Bridge API generated QR codes.
4  self.setupQrCodeLogin()
5
6  ...
7
8 }

To customize the QR code login’s URL format, use the sample code provided in SceneDelegate.useQrCodeLoginUrl(_: ).

When using a QR code login URL generated by the UI Bridge API, you can choose between Mobile SDK’s reference format or a custom format.

1internal  var  isQrCodeLoginUsingReferenceUrlFormat  =  true

If you’re using our reference format, make sure to fill in these variables.

1internal var qrCodeLoginUrlScheme = "YOUR_QR_CODE_LOGIN_URL_SCHEME"
2internal var qrCodeLoginUrlHost = "YOUR_QR_CODE_LOGIN_URL_HOST"

If you’re using a custom format, set isQrCodeLoginUsingReferenceUrlFormat to false, and then provide the URL handling logic in SceneDelegate.useQrCodeLogInUrl. To modify the QR code login URL format, you can customize the values in setupQrCodeLogin by following the comments provided in the source code.

1private func setupQrCodeLogin() {
2
3  SalesforceLoginViewController.qrCodeLoginUrlPath =
4  "YOUR_QR_CODE_LOGIN_URL_PATH"
5
6  SalesforceLoginViewController.qrCodeLoginUrlJsonParameterName =
7  "YOUR_QR_CODE_LOGIN_URL_JSON_PARAMETER_NAME"
8
9  SalesforceLoginViewController.qrCodeLoginUrlJsonFrontdoorBridgeUrlKey =
10  "YOUR_QR_CODE_LOGIN_URL_JSON_FRONTDOOR_BRIDGE_URL_KEY"
11
12  SalesforceLoginViewController.qrCodeLoginUrlJsonPkceCodeVerifierKey =
13  "YOUR_QR_CODE_LOGIN_URL_JSON_PKCE_CODE_VERIFIER_KEY"
14
15  ...
16
17}

SceneDelegate.swift

To allow your app to receive QR code login links from external QR code readers, uncomment the calls to useQrCodeLogInUrl in the scene(_: openURLContexts:) and scene(_: willConnectTo: options:) methods.

1func scene(_ scene: UIScene,
2               openURLContexts urlContexts: Set<UIOpenURLContext>)
3    {
4
5        // Uncomment when enabling log in via Salesforce UI Bridge API generated QR codes.
6        if let urlContext = urlContexts.first {
7            useQrCodeLogInUrl(urlContext.url)
8        }
9
10    ...
11
12    }
13
14    ...
15
16    func scene(_ scene: UIScene,
17               willConnectTo session: UISceneSession,
18               options connectionOptions: UIScene.ConnectionOptions)
19    {
20
21        // Uncomment when enabling log in via Salesforce UI Bridge API generated QR codes.
22        if let urlContext = connectionOptions.urlContexts.first {
23            useQrCodeLogInUrl(urlContext.url)
24        }
25
26    ...
27
28    }

We've Moved

Welcome to the new home of the Mobile SDK Developer Guide! For now, the Japanese guide can be found in PDF form.

Configure QR Code Login for iOS