Plugin Settings
The OCMLabs Content Bridge for Magento plugin settings page is at WordPress Admin > Settings > OCMLabs Content Bridge for Magento.
Settings
API Key
A randomly generated key used to authenticate requests from Magento to WordPress. The key is sent as the X-OC-Bridge-Key header with every API request.
- Generated automatically on plugin activation
- Click Regenerate to create a new key (you must update Magento’s configuration if you do this)
- Copy this value and paste it into Magento Admin > Stores > Configuration > OCMLabs > WordPress Integration > Connection > API Key
Magento Webhook URL
The full URL to the Magento webhook endpoint that receives cache purge notifications.
- Example:
https://your-magento-store.com/wordpress/webhook/cachepurge - Leave empty to disable webhooks
- Must be reachable from the WordPress server
Webhook Secret
Optional secret used to sign cache purge webhooks with HMAC-SHA256 (X-OC-Bridge-Signature header).
- Leave empty to sign webhooks with the API key
- If you set it, enter the same value in Magento Admin > Stores > Configuration > OCMLabs > WordPress Integration > Cache > Webhook Secret
How Authentication Works
All oc-bridge/v1 REST endpoints use a custom authentication callback that checks the X-OC-Bridge-Key header against the stored API key using PHP’s hash_equals() function for timing-safe comparison.
If the header is missing or does not match, the endpoint returns a 403 Forbidden response. If no API key is set in WordPress, it returns 503.
See also
Related pages
- Where the API key goes in Magento
- What the webhook URL is used for
- Turn on webhook cache purge in Magento