Skip to main content


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

Creating a secure connection with the Pega Process Fabric Hub by configuring OAuth 2.0 authentication

Updated on November 9, 2021

Provide a secure connection between the applications that your Pega Platform system hosts and the Pega Process Fabric Hub by creating an OAuth 2.0 client registration. As a result, you receive a secure ID and password so that you can ensure that the communication between your applications and the Pega Process Fabric Hub is safe.

Before you begin: Ensure that the Pega Process Fabric Hub can communicate with your applications. For more information, see Providing access rights for the Pega Process Fabric Hub by editing a service package.
By using the OAuth 2.0 protocol, the Pega Process Fabric Hub can communicate securely with your applications over HTTPS. You define OAuth 2.0 client registration data instances so that the Pega Process Fabric Hub can access Pega Platform REST services. When you define the OAuth 2.0 client registration, you receive a client ID and a client secret that you use when you register your application in Pega Process Fabric Hub to create a secure connection. Client IDs and client secrets are unique to every operator in your system. After you create the client ID and client secret, you can use these credentials to register multiple applications that your operator can then access as an administrator.
  1. Create a new OAuth 2.0 client registration:
    1. In the header of Dev Studio, click CreateSecurityOAuth 2.0 Client Registration.
    2. In the Short description field, provide some descriptive information for your client registration.
    3. In the Client Name field, provide a client name for your OAuth 2.0 client registration.
    4. Click Create and open.
  2. On the Client information tab, in the Client Credentials section, in the Type of client parameter, select Confidential.
  3. In the Supported grant types section, select the JWT bearer check box.
    Note: Ensure that you clear the remaining check boxes.
  4. In the Identity mapping field, enter PPFConnect.
    For example: The following figure shows correct configurations of supported grant types and identity mapping:
    Security configurations for connection with the Pega Process Fabric Hub
    Configurations that provide a secure connection with the Pega Process Fabric Hub.
  5. In the Client information section, click View & download.
    Result: The View & download window opens and displays your client secret.
  6. In the View & download window, click Download credentials.
    For example: The following figure shows how to view and download the secure credentials:
    Obtaining client ID and password
    The dialob box that you use to view and download client ID and password.
  7. In the Save As dialog box, select a secure location to save the file that stores your credentials, and then click Save.
  8. Click Save.
Result: You use the client ID and the client secret to register every application that you associate with a current operator.
What to do next: Register your application directly in the Pega Process Fabric Hub. For more information, see Activating applications in the Pega Process Fabric Hub.
    • Previous topic Configuring synchronization with the Pega Process Fabric Hub
    • Next topic Activating applications in the Pega Process Fabric Hub

    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.

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

    Close Deprecation Notice
    Contact us