Skip to main content

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

Sending encrypted email

Updated on April 6, 2022

Configure outbound email from Pega Platform to use the standard S/MIME protocol, to send encrypted email messages to external email addresses. By sending encrypted email, you assure your recipients that your email messages are secure and authentic.

Before you begin:
  1. Make sure that Pega Platform is already configured to send plain, unencrypted emails. For more information, see Configuring outbound email in App Studio.
  2. Open your existing JKS keystore file and take note of the certificate alias from within that file. You need the certificate alias to create the keystore in Pega Platform.
  3. Obtain the keystore aliases for any email addresses that are in the keystore file. You need to specify the keystore aliases in the pyEmailCertificateMap decision table in Pega Platform.
  4. Create a keystore and upload the JKS file to Pega Platform.

    For more information, see Creating a keystore for application data encryption and Configuring a keystore by uploading a file.

  1. In the header of Dev Studio, search for and select the pyEmailCertificateMap decision table rule.
  2. On the pyEmailCertificateMap decision table rule form, click Save as and save the decision table in the Data-Admin-Security-Keystore class in a local ruleset.
    Note: Do not alter the Purpose or the Applies To class.
  3. Click Create and open.
  4. On the Table tab, edit the decision table to include the following information:
    • Email address: Specify the email address of the intended recipient of the encrypted message.
    • Keystore instance: Specify the keystore instance that you want to use for encryption.
    • Keystore alias: Specify the keystore alias for the email address.

    For more information, see Creating decision tables.

    pyEmailCertificateMap decision table
    Entering information in the pyEmailCertificateMap decision table
  5. To send the encrypted message, create an activity that calls the SendEmail automation.
    For more information, see Calling an automation from an activity and Pega-supplied automations.
    Example of calling the SendEmail automation
    Parameters for the SendEmail automation inputs and outputs
  6. To enable encryption, enter a parameter in the Encrypt message field.
  7. Click Save.
  8. Call the activity that you created in step 5 during flow processing to send the email by using the parameters that you provided.

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