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 services||Description||Related 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|
|REST||Create 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|
|Connect 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|
|SAP||Supports connecting a SAP system to your Pega Cloud application through the use of SOAP web service protocols.||Service SAP rules|
|Java Messaging Service||Supports 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 MQ||Supports 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
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|
Pega applications running in Pega Cloud environments can request data or services from another system using the following industry-standard protocols.
|SOAP||Use SOAP connector rules when your Pega Cloud application needs to call an external web service.||Connect SOAP rules|
|HTTP||Use 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|
|REST||Use 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|
|SAP||Use Connect SAP rules in your Pega Cloud application to connect to an existing SAP SOAP web service||Connect SAP rules|
|DocuSign||Use this smart shape in a flow to send documents for electronic signatures by using the DocuSign service.||Flow shapes|
|Java Messaging Service||Use 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|