Skip to main content
close Search
Close search


Deploying a mobile app for Pega Platform

3 Tasks

30 mins

Visible to all users
Beginner Pega Platform 8.2 English


The HR department wants to allow new employees to enroll in a health insurance plan on their first day of employment. To ensure that new employees can enroll in a plan before obtaining a company-issued laptop, the HR department plans to purchase a set of Apple iPads. During the orientation session, a new employee can complete a benefits enrollment case using an iOS app.

To build and deploy an iOS mobile app, you need an iOS mobile device, a certificate set for developing apps for the device, and HTTPS access to Pega Platform™. Due to the restrictions on certificate sets, Pega Academy cannot provide students with an iOS certificate. As a result, this exercise guides you through building an unsigned app.

The following table provides the operator credentials you need to complete the exercise.

Role Operator ID Password
Senior System Architect SSA@TGB rules

Your assignment

If your exercise environment is configured to support access through HTTPS, and you have access to valid certificates and provisioning files, you can build a signed app and download the app to your device. For more information about generating a certificate set using the Apple Developer Portal, see the Pega Community article Generating mobile certificates for the iOS platform.

Configure an unsigned iOS mobile app for the HRApps application.

  1. Create a certificate set for an unsigned iOS app.
  2. Configure a mobile channel interface for the HRApps application to build an iOS app. Configure the app to:
    1. Time out after three minutes
    2. Unlock after timing out with a device PIN
    3. Display custom branding
  3. Build the iOS app using the certificate set you create. Update the app version to 1.0.0.
Access credentials to the build server are available with a license for Pega Mobile Client. For this exercise, build server access is already configured.

Before you begin

Before you begin this exercise, download the following file that will enable you to complete branding for the mobile application you configure in this challenge: 


For information about how to customize branding assets for your application, refer to the help topic Preparing custom branding assets.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Detailed Tasks

1 Configure an iOS certificate set


  1. Log in to Pega Platform in the System Architect role as SSA@TGB using password rules.
  2. Switch to App Studio.
  3. In the Explorer panel, click Settings.
  4. Click Mobile certificates to open the certificate set manager.

    Mobile Certificates
  5. To the right of the certificate set manager, click Add certificate set to add a new certificate set.

    Certification set
  6. Below the Adding new certificate set section, click iOS to select the iOS platform.
    The selected platform has white text.
    ios SELECTED
  7. Expand Advanced to view the advanced configuration section.
  8. Select the Enable a simplified certificate set (unsigned application) check box to generate an unsigned app.
    iOS devices require a signed certificate for app access and installation. Pega Platform generates a Zip file that contains the app, which the developer downloads and signs locally.
  9. In the App ID (Bundle ID) field, enter com.pega.hrapp.
  10. Optionally, select an existing or upload a new push notification certificate.
  11. In the upper-right corner, click Save to save the unsigned application certificate set.
  12. In the upper-left corner, click the back arrow to return to the certificate set manager to confirm the certificate set is on the list.

    2 Configure the mobile channel interface

    1. From the Explorer panel, select Interfaces to view the Channels & Interfaces landing page.
    2. Below Create new channel interface, click Mobile to configure a new mobile app.
    3. On the Configuration tab, in the Mobile app name field, enter HRApp.
    4. Below Mobile app type, select Pega Mobile Client.
    5. Expand Security to configure the app security options.
      1. Click the Enable additional app protection check box.
      2. Click Enable device lock to allow the user to reestablish their session using their device unlock credentials.
      3. Select Enable interaction timeout so that the app times out after a determined period of inactivity.
      4. In the minutes field, enter 3 so that the app times out after three minutes of inactivity.
        Chanel config
    6. Click the Layout tab to configure the app appearance.
    7. In the App branding section, below Custom, click the Plus icon to upload a custom theme.
      layout theme
    8. Click Upload zip file to upload the branding package you downloaded at the beginning of the exercise. After the upload completes, an image replaces the Plus icon.
    9. In the Build your application section, under Select platforms, select the switch to the left of iOS to display the Certificate Set drop-down and the Build Now button.
      channel ios
    10. From the Certificate Set drop-down, select the certificate set you created earlier in the exercise.
    11. Expand App version to display the Version field.
      1. Clear the Auto-increment version with each build check box to modify the app version number.
      2. Change the version number to 1.0.0.
    12. Click Save to commit your changes.

    3 Confirm your work

    1. To the right of the iOS switch, click Build Now to open communication with the build server and begin the app build.
      build now

      The following are displayed while the build server builds your app.

      build in progress
      download in progress
    2. When the build is complete, an active Download link is displayed.
      ready to download

    If you are having problems with your training, contact Pega Academy technical support.

    Did you find this content helpful?

    50% found this content useful

    Want to help us improve this content?

    Suggest an edit

    We'd prefer it if you saw us at our best.

    Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

    Close Deprecation Notice