Configuring Passcode Manager

Use the Passcode Manager to configure the Logon plugin as a passcode and datavault manager.

Passcode Manager is an initialization method you can use to set up the Logon plugin as a passcode and datavault manager; it does not register with a server.

The Logon plugin datavault is required by the Encrypted Storage plugin. For more information about the Encrypted Storage plugin, see Encrypted Storage Plugin.

To initialize and set up the Passcode Manager, use sap.Logon.initPasscodeManager. For example:

 sap.Logon.initPasscodeManager(successCallback, errorCallback, appID, null, passcodePolicy, context);

To initialize the Passcode Manager, define the following fields:

Variable	Description	Example
appID	The application's identifier. For example: "com.mycompany.storage"	`var appID = "com.mycompany.storage";`
passcodePolicy	The passcode policy for the datavault. For more information about passcode policies, see Application Passcode.	var passcodePolicy = { "expirationDays":"0", "hasDigits":"false", "hasLowerCaseLetters":"false", "hasSpecialLetters":"false", };
context	The connection parameters for the application. For more information about configuring the Logon plugin, see Logon Plugin	var context = { "serverHost": "10.X.XXX.XXX", "https": "false", "serverPort": "8080", "user": "i82XXXX", "password": "XXXXX", "communicatorId": "REST", "passcode": "password", "unlockPasscode": "password", "passcode_CONFIRM":"password", "ssoPasscode":"Password1" };

Variable

Description

Example

appID

The application's identifier.

For example: "com.mycompany.storage"

var appID = "com.mycompany.storage";

passcodePolicy

The passcode policy for the datavault.

For more information about passcode policies, see Application Passcode.

var passcodePolicy = {
    "expirationDays":"0",
    "hasDigits":"false",
    "hasLowerCaseLetters":"false",
    "hasSpecialLetters":"false",
};

context

The connection parameters for the application.

For more information about configuring the Logon plugin, see Logon Plugin

 var context = {
    "serverHost": "10.X.XXX.XXX",
    "https": "false",
    "serverPort": "8080",
    "user": "i82XXXX",
    "password": "XXXXX",
    "communicatorId": "REST",
    "passcode": "password",  
    "unlockPasscode": "password",
    "passcode_CONFIRM":"password",
    "ssoPasscode":"Password1"
};

Sample Code

function init() {
                if (sap.Logger) {
                    sap.Logger.setLogLevel(sap.Logger.DEBUG);  //enables the display of debug log messages from the Kapsel plugins.
                    sap.Logger.debug("Log level set to DEBUG");
                }
                keyTextField = document.getElementById("keyTextField");
                valueTextField = document.getElementById("valueTextField");
                resultsTextArea = document.getElementById("resultsTextArea");
                
                var appID = "com.mycompany.storage";
                var context = {
                        "serverHost": "10.X.XXX.XXX", //Place your SAP Mobile Platform 3.0 server name here
                        "https": "false",
                        "serverPort": "8080",
                        "user": "i82XXXX", //Place your user name for the OData Endpoint here
                        "password": "XXXXX",  //Place your password for the OData Endpoint here
                                              //Once set can be changed by calling sap.Logon.changePassword()
                        "communicatorId": "REST",
                        "passcode": "password",  //Note hardcoding passwords and unlock passcodes are strictly for ease of use during development
                                                 //Once set can be changed by calling sap.Logon.managePasscode()
                        "unlockPasscode": "password",
                        "passcode_CONFIRM":"password",
                        "ssoPasscode":"Password1"
                };
                
                var passcodePolicy = {
                        "expirationDays":"0",
                        "hasDigits":"false",
                        "hasLowerCaseLetters":"false",
                        "hasSpecialLetters":"false",
                        "hasUpperCaseLetters":"false",
                        "defaultAllowed":"true",
                        "lockTimeout":"0",
                        "minLength":"6",
                        "minUniqueChars":"0",
                        "retryLimit":"0"
                };
                
              sap.Logon.initPasscodeManager(successCallback, errorCallback, appID, null, passcodePolicy, context);
   
                createStore();
            }