Integrating Cloud Protect with PPC (Protegrity Provisioned Cluster)

Concepts for integrating with PPC (Protegrity Provisioned Cluster)

This guide describes how to configure the Protegrity Policy Agent and Log Forwarder to connect to a Protegrity Provisioned Cluster (PPC), highlighting the differences from connecting to ESA.

Key Differences: PPC vs ESA

FeatureESA 10.2PPC (this guide)
Datastore Key FingerprintOptional/RecommendedRequired
CA Certificate on AgentOptional/RecommendedOptional/Recommended
CA Certificate on Log ForwarderOptional/RecommendedNot supported
Client Certificate Authentication from Log ForwarderOptional/RecommendedNot supported
IP AddressESA IP addressPPC address

Prerequisites

  • Access to PPC and required credentials.
  • Tools: curl, kubectl installed.

Policy Agent Setup with PPC

Follow these instructions as a guide for understanding specific inputs for Policy Agent integrating with PPC:

  1. Obtain the Datastore Key Fingerprint

    To retrieve the fingerprint for your Policy Agent:

    curl -k -H "Authorization: Bearer ${TOKEN}" -X POST https://${HOST}/pty/v2/pim/datastores/1/export/keys  -H "Content-Type: application/json" --data '{
      "algorithm": "RSA-OAEP-256",
      "description": "example-key-from-kms",
      "pem": "-----BEGIN PUBLIC KEY-----\nABC123... ...890XYZ\n-----END PUBLIC KEY-----"
    }'
    

    Sample Output:

    {"uid":"1","algorithm":"RSA-OAEP-256","fingerprint":"4c:46:d8:05:35:2e:eb:39:4d:39:8e:6f:28:c3:ab:d3:bc:9e:7a:cb:95:cb:b1:8e:b5:90:21:0f:d3:2c:0b:27","description":"example-key-from-kms"}
    

    Record the fingerprint and configure it as the value for PTY_DATASTORE_KEY in the Policy Agent function environment variable.

  2. Retrieve the PPC CA Certificate

    To obtain the CA certificate from PPC:

    kubectl -n api-gateway get secret ingress-certificate-secret -o jsonpath='{.data.ca\.crt}' | base64 -d > CA.pem
    

    Use the CA.pem that was returned as described in Policy Agent Installation.

  3. Configure the PPC Address

    Use the PPC fqdn in place of the ESA IP address wherever required in your configuration.

Log Forwarder Setup with PPC

  • The Log Forwarder will proceed without certificates and will print a warning if PTY_ESA_CA_SERVER_CERT is not provided.
  • No additional certificate or CA configuration is needed for PPC.


    Last modified : April 14, 2026