Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Creating a distribution certificate for signing iOS apps

Updated on June 15, 2020

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: <organization name>
  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 articles

Previous - Generating mobile certificates for the iOS platformNext - Creating an App ID for application


Pega Platform 7.1.1 - 8.3.1 Mobile Communications and Media Consumer Services Financial Services Government Healthcare and Life Sciences Insurance Healthcare and Life Sciences Manufacturing Consumer Services Consumer Services

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us