API Connector Security Considerations and Limitations

Security considerations

  • Use HTTPS target endpoints wherever possible.
  • Keep credentials only in the Platform API configuration. Do not place credentials in destination headers or in the JSON payload template.
  • Import self-signed or internal CA certificates into Java truststore.
  • Rotate client secrets and passwords periodically, and update the Platform API configuration whenever you do.
  • Restrict access to the Platform configuration area where API connector credentials are stored.

Limitations

  • Only JSON payloads are supported.
  • Only HTTP POST is supported for publishing events.
  • Only three authorization types are supported: no authorization, basic authentication, and bearer token with client ID and client secret. API keys and other OAuth flows are not supported.
  • Each event is sent as an individual HTTP request rather than in a batch, so high-volume destinations may encounter the downstream API's own rate limits (HTTP 429).