Skip to main content

Integrating Pega applications with external systems

Suggest edit Updated on June 2, 2022

When you integrate Pega Platform and Pega industry applications, you allow the Pega applications to interact with the applications and your external systems.

To integrate your Pega applications running in Pega Cloud services environments with your enterprise systems, use the following rule types:

  • Resources maintain the connection properties and other configuration data for your Pega applications integrations. They configure services to accomplish work, such as Pega file and email listeners that establish connectivity and processing work rules. It also allows you to add operational meta-data controlling how and when these services get executed.
  • Services are used to expose integration points into the application, such as REST APIs.
  • Connectors enable your Pega Cloud application (acting as a client) to request information from external systems (servers).

The following resources, services, and connectors are available for integrating Pega applications running in Pega Clouds environments with resources across your enterprise. As with any external system connectivity, ensure that you follow security best practices to mitigate attacks and prevent data loss such as:

  • Using strong authentication for all requests
  • Ensuring correct authorization of application users
  • Securing communications using TLS 1.2

Resources and services

Pega applications running in Pega Cloud environments support integrating with resources in your enterprise using the following industry-standard protocols.

Protocols or servicesDescriptionRelated information
SOAP Create secure SOAP service connections to your endpoint interfaces in Pega when your Pega application running in a Pega Cloud environment needs to act as a web service.Service SOAP rules
RESTCreate secure REST service connections to your endpoint interfaces in Pega when your Pega application running in a Pega Cloud environment needs to support interactions with external systems through web services.

As a best practice, use REST connectors instead of HTTP connectors when possible. Service HTTP rules are no longer being actively developed and are deprecated beginning in Pega Platform 8.7

Service REST rules
EmailConnect to your enterprise SMTP, IMAP, and POP3 mail server using the Pega Email service to manage your email in Pega applications.Integrating your application with an email provider
SAPSupports connecting a SAP system to your Pega Cloud application through the use of SOAP web service protocols.Service SAP rules
Java Messaging ServiceSupports sending messages using JNDI servers with the Java Messaging Service (JMS) standard. For details about using Pega Platform as a messaging service publisher and receiver, see Configuring enterprise messaging using JMS.Messaging service overview
IBM MQSupports interactions with external systems using the IBM WebSphere MQ middleware messaging standard. For details about Pega Platform support for and interoperability with IBM MQ, see Configuring enterprise messaging using IBM MQ.Configuring enterprise messaging using IBM MQ
Secure File Transfer (SFTP)The Pega Cloud SFTP Service provides Pega Cloud clients with simple, secure file transfers to and from their Pega Cloud applications. The service supports file exchanges between your enterprise and your Pega applications powered by Pega Cloud and uses the Pega Cloud File Storage repository for reliable and resilient storage.Pega Cloud

environments do not support using the SFTP connector rules in Pega Platform, because Pega Cloud does not support directly accessing files on the local filesystem of your environment.

Pega Cloud Services SFTP Service

Connectors

Pega applications running in Pega Cloud environments can request data or services from another system using the following industry-standard protocols.

ConnectorDescriptionRelated information
SOAPUse SOAP connector rules when your Pega Cloud application needs to call an external web service.Connect SOAP rules
HTTPUse HTTP connector rules when you want your Pega Cloud application to send XML or string data (text) as messages to an external system without the need to comply with messaging standards or protocols such as SOAP.About Connect HTTP rules
RESTUse REST connector rules in Pega Cloud applications to consume information exposed by REST web services (typically presented as JSON or XML).

As a best practice, use REST connectors instead of HTTP connectors when possible.
Connect REST rules
SAPUse Connect SAP rules in your Pega Cloud application to connect to an existing SAP SOAP web serviceConnect SAP rules
DocuSignUse this smart shape in a flow to send documents for electronic signatures by using the DocuSign service.Flow shapes
Java Messaging ServiceUse Java Messaging Service (JMS) rules in your Pega Cloud application to configure enterprise messaging while leveraging Pega Platform as a message publisher and receiver. For details about Pega Platform support for JMS, see Configuring enterprise messaging using JMS.Messaging service overview
IBM MQ Use Connect MQ rules in your Pega Cloud applications to configure enterprise messaging using the IBM MQ messaging standard. For details about Pega Platform support for and interoperability with IBM MQ, see Configuring enterprise messaging using IBM MQ.Connect MQ rules
Did you find this content helpful? YesNo

100% found this useful

Have a question? Get answers now.

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

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

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us