Table of Contents

Creating a distribution certificate for signing iOS apps

Generate and save a password-protected distribution certificate to your local computer to use it in the iOS certificate set when you build an iOS mobile app on Pega Platform™.

To distribute an iOS app by using the In-House model, you need an iOS Distribution signing certificate. Each Apple Developer Account can have only two certificates of this type. If your existing account already has distribution certificates, you can export a certificate as a .p12 file and skip this rest of this section. If your account does not have distribution certificates, you can create one and a certificate file that you export as a .p12 file.


Before you create a distribution certificate for signing iOS apps, ensure that you completed the following actions:

  • You are enrolled in the Apple Developer Program. For more information about available enrollment options, see Choosing a membership.
  • The Apple Developer account includes distribution certificates.
  • You have a Mac OS X operating system.

Verifying that your Apple Developer Account has distribution certificates

To check whether your Apple Developer account already has distribution certificates, complete the following steps:

  1. Go to and sign in to the Apple Developer Portal.
  2. Click Certificates, Identifiers and Profiles.
  3. Click Certificates > Production.
  4. Sort by the Type column.
  5. Locate certificates of the iOS Distribution type.

Creating a distribution certificate

If you do not find any distribution certificates in your Apple Developer Account, create a distribution certificate by completing the following steps:

  1. Sign in to the Apple Developer Portal and click Certificates > Production.
  2. Click the plus sign in the upper right corner.Certificates, Identifiers and Profiles screen
    Certificates, Identifiers and Profiles screen
  3. In the Production section, click In-House and Ad Hoc.Add iOS Certificate screen
    Add iOS Certificate screen
  4. Follow the guidelines on the Create a Certificate Signing Request (CSR) page and generate a file with a .csr extension.About Creating a Certificate Signing Request screen
    About Creating a Certificate Signing Request screen
  5. After you generate a .csr file on a Mac OS X operating system, on the Generate your certificate page, click Choose File to upload it.Generate Your Certificate screen
    Generate Your Certificate screen
  6. Click Continue. A confirmation page displays information about the generated *.cer file that you can now download.Your Certificate is Ready screen
    Your Certificate is Ready screen
  7. Click Download to download the .cer file to the same computer on which you generated the .csr file.
  8. Import the .cer file to your keychain by double-clicking it.
  9. Navigate to the Keychain Access application and find your certificate, which includes a private key. It should be in the following format:
    iPhone Distribution: <em><organization name></em>
  10. Expand your certificate to see a private key with the same value as was set in the Common Name field when you generated the .csr file. The key is shown as abcd in the following figure.iPhone Distribution screen
    iPhone Distribution screen
  11. Right-click the certificate and click Export “iPhone Distribution: …".
  12. Save the certificate to your computer as a .p12 file. You must provide a password to protect the exported file.iPhone Distribution screen
    iPhone Distribution screen
For more information, see iOS certificate set.

Related Content

Have a question? Get answers now.

Visit the Pega Support Community to ask questions, engage in discussions, and help others.