Customizing Passport

Localizing

The App SDK looks for localization strings and resources in the custom or main bundle when it needs to display the UI to the user. If strings are not found in the custom or main bundle, the framework gets the corresponding default English strings. For App SDK localization details, see Localizing in the iOS Developer Guide.

Adding a new localization to Passport app

1. Open the Passport App using Xcode. Select the project target and go to the Info tab. In the Localizations section, click the + (plus) sign to add new localized strings (see the following screenshot).

2. Select the localizable files from the dialog and click Finish.

3. Edit the newly created localizable files and translate the strings into the desired language.

4. Select the Localizable.strings folder and select the checkbox to enable the newly added language. Add the translated strings for your chosen language.

   

App icons

To change the application icons:

1. Prepare your iOS application icons and place them in a folder named Images.xcassets.

2. Delete the existing icons in NokNokPassport/NokNokPassport/Images.xcassets

In Xcode, right-click the folder NokNokPassport/NokNokPassport/Images.xcassets and choose Delete.

3. Select the folder NokNokPassport.

4. Right-click and choose Add Files to NokNokPassport, then navigate to the Images.xcassets folder.

5. Click Add to add your custom icons to the project at NokNokPassport/NokNokPassport/Images.xcassets.

Application name

To change the app's name from Passport:

1. Within the project hierarchy in Xcode, select the file
   NokNokPassport/Supporting Files/NokNokPassport-Info.plist.

2. Identify the Bundle display name key and change its value from Passport to your own name, for example NewApp.

About screen

Changing the text in the about screen

1. In Xcode, search the workspace for the text string “About Digipass”.
   The search returns two source files:

   1. Main.storyboard (Base)

   2. OneTimeAboutScreenViewController.m

2. Select the OneTimeAboutScreenViewController.m search result

3. In the source file, identify the line containing the text “About Digipass” under the //Set title comment

//Set title
self.navigationItem.title = NSLocalizedString(@"About Digipass", nil):

4. Replace the text with your own, for example, About New App

//Set title
self.navigationItem.title = NSLocalizedString(@"About New App", nil);

5. Identify the line containing the text Using two devices for authentication text under the //Set text for the first label comment

// Set text for the first label
label_1.text = NSLocalizedString(@"Using two devices for authentication…", nil):

6. Replace the text with your own, for example, Description 1

// Set text for the first label
label_1.text = NSLocalizedString(@"Description 1", nil);

7. Identify the line containing the First, scan a QR code text under the //Set text for the second label comment

// Set text for the second label
label_2.text = NSLocalizedString(@"First, scan a QR code…", nil):

8. Replace the text with your own, for example, Description 2

// Set text for the second label
label_2.text = NSLocalizedString(@"Description 2", nil):

Ensure that you make the above changes to the label_1.text and label_2.text entries in both the // iPad section as well as the // iPhone section.

Adding an authenticator

To add an authenticator to Passport App, refer to section Embedding an Authenticator in the iOS Developer Guide.

The client configuration file

You can further configure Passport App using the Client Configuration file, mfac_cfg.json. This file enables you to control features such as PIN length, number of PIN retry attempts, whether or not to prompt the user to select an authenticator, and so on. Place the file in the main bundle. For information about mfac_cfg.json, refer to section The Client Configuration File in the iOS Developer Guide.