Getting Started with Client Hub Application Installation and Initialization

Install and initialize the Client Hub application.

Installing the Client Hub Application

Install Client Hub.


  1. Install SAP Mobile Platform Native SDK - Client Hub component.
    By default, SAP Mobile Platform SDK components are installed in the ..\SAP\MobileSDK<XXX> directory. In this guide, <SDK_HOME> represents the SAP Mobile Platform SDK installation directory, down to the MobileSDK<XXX> folder.
    Client Hub gets installed under the ClientHub directory, where the project files for Client Hub applications, used for registering applications on iOS devices is available.
  2. Ensure that you uncompress the file before importing the Client Hub project into Xcode.

Setting Up the Development Environment

The Client Hub application is shipped as a source code project. Set up the iOS Development Environment before registering your application using Client Hub.

Download Xcode from the Apple Developer Web site


  1. Download and install Xcode from the Apple Developers Web site: published on non-SAP site.
  2. Log in using your Apple Developer credentials.
  3. Download the appropriate Xcode.
  4. Navigate to folder <SDK_HOME> > ClientHub > src > xcode and open the project ClientHub.xcodeproj.

Download Xcode from the App Store


You can also download the latest version of Xcode using the App store. It is a free download that installs directly into the Applications folder. By default, Xcode downloads developer documentation in the background for offline reading, and automatically downloads documentation updates as well.


  1. Open the Mac App Store.
  2. Under categories, select App development.
  3. Select the Xcode Developer Tools and provide Install app.
  4. Enter your App Store credentials.
  5. Download Xcode.

Customizing or Branding the Client Hub User Interface

Open the ClientHub project in Xcode to customize the look and feel of the Client Hub application.

For example, the splash or welcome screen can be customized to include your company logo or image. Browse through ClientHub > Targets and replace the icons and launch image files compliant with iOS standards as per your requirement.

Client Hub Application Signing


  1. Create a certificate signing request file to use for authenticating the creation of the SSL certificate:
    1. Launch the Keychain Access application on your Mac (usually found in the Start of the navigation path Applications Next navigation step Utilities End of the navigation path folder).
    2. Select Start of the navigation path Keychain Access Next navigation step Certificate Assistant Next navigation step Keychain Access End of the navigation path.
    3. Enter your e-mail address and name, then select Save to disk and click Continue. This downloads the .certSigningRequest file to your desktop.
  2. Create a new App ID for the application:
    1. Go to the Apple Developer Member CenterInformation published on non-SAP site Web site, log in if required, and select Certificates, Identifiers & ProfilesInformation published on non-SAP site.
    2. Select Start of the navigation path Identifiers Next navigation step App IDs End of the navigation path, and click the +.
    3. Enter a name for your App ID, and, under App Service, select Push Notifications. This string should match the Bundle Identifier in your iOS app's Info.plist.
    4. Accept the default App ID prefix, or choose another one.
    5. Under App ID Suffix, select Explicit App ID, and enter your iOS app's Bundle ID. Verify that all the values are correct.
    6. Click Submit.
  3. Create a provisioning profile to authenticate your device to run the app you are developing:
    1. Navigate to the Apple Developer Member CenterInformation published on non-SAP site Web site, and select  Certificates, Identifiers & ProfilesInformation published on non-SAP site.
    2. From the iOS Apps section, select Provisioning File, and select the + button to create a new provisioning file.
    3. Choose iOS App Development as your provisioning profile type, then click Continue.
    4. From the drop-down, choose the App ID you created and click Continue.
    5. Select your iOS Development certificate in the next screen, and click Continue.
    6. Select which devices to include in the provisioning profile, and click Continue.
    7. Choose a name for your provisioning profile, then click Generate.
    8. Click Download to download the generated provisioning file.
    9. Double-click the downloaded provisioning file to install it. Xcode's Organizer opens in the Devices pane. Your new provisioning profile appears in the Provisioning Profiles section of your Library. Verify that the status for the profile is "Valid profile." If the profile is invalid, verify that your developer certificate is installed in your Keychain.
  4. Deploy the Client Hub application on the Device:
    1. In the Client Hub Xcode project, change the bundle identifier in your iOS app’s Info.plist to the App ID created in Apple Developer Member Center.
    2. In TARGETS>Build Settings>Code Signing, make sure that appropriate provisioning profile created in Step 3 is selected.


Setting the SSO Passcode in Client Hub Application

You must set your SSO passcode in the Client Hub application and use this passcode in all your applications.


By default, the SSO passcode must have least eight characters and contain at least one uppercase, lowercase, and numeric character. You can modify the minimum passcode length before compiling the Client Hub application by changing the MinLength value in the ClientHubPolicy.plist.


  1. Launch the Client Hub application on your device.
    The Create SSO Passcode window displays.
  2. Enter the SSO passcode, then reenter the passcode to confirm the change.
  3. Click Submit.
    A success message displays if the passcode is accepted and set correctly. Use this SSO passcode for all the applications.
  4. Exit the Client Hub application.

Resetting the Client Hub SSO Passcode

If you forget the SSO passcode, platform security prevents you from using the applications. You must reset your SSO passcode and use the new passcode in all your applications. Resetting the passcode deletes all data from the secure store.


  1. Click Reset, then click OK to confirm.
    An alert box is displayed for confirmation. If you click OK, you are redirected to the Set passcode screen.
  2. In the Create SSO Passcode screen, enter the new passcode, then reenter the passcode to confirm the change.
  3. Click Submit.

Next Steps

Use this new passcode for all the applications.