Content Hub uses webhooks to communicate with the service, enabling your publisher and subscriber websites to communicate through the service as an intermediary. A webhook is an endpoint that the service knows about.
On a publisher or subscriber website, clicking the Update Public URL button in the interface creates a webhook. That registers your website, using the following format as the endpoint:
yourdomain.com/acquia-contenthub/webhook
A webhook defines the messaging endpoint. When information from the service sends to publishers or subscribers, the data sends as a POST request to the HMAC-authenticated endpoint. The Drupal module listens for those requests and performs actions based on the information in the request. Requests requiring actions may include entity creation (a new entity requires import), entity updates (content changes), or other changes.
Content Hub requires registering a valid webhook. If there is no registered webhook, some features do not work. Users may also see errors. Webhook registration failures often occur when the registering website is not publicly accessible, such as local development environments.
Changing webhooks
Users can change the webhook URL using the configuration form in the module. This may be necessary if you are working with Content Hub locally and need the public-accessible URL to be an ngrok tunnel.
Editing or deleting webhooks requires the Content Hub Publisher module.
Sign in to your Content Hub publisher website as an administrator.
Navigate to Configuration > Acquia Content Hub > Subscription Manager.
Under Administer webhooks:
Edit the URL field of an existing webhook
Use Add a new Webhook to add a new webhook
Remove the URL to delete a webhook
Click Save configuration.
Note
If your website does not have a valid SSL certificate, you must configure your webhooks using HTTP, not HTTPS.
They can also be updated through the Content Hub API, using a CRUD (create-read-update-delete) operation.
Updated webhooks register if the URL responds with a valid HMAC-authenticated response. You cannot register unauthenticated URLs such as example.com/acquia-contenthub/webhook.
Troubleshooting webhooks
If Content Hub cannot send webhooks to a subscribing website, it also cannot notify the subscribing website of a problem with the webhook. If a webhook fails or is unreachable for 72 hours, Content Hub suppresses the webhook for 12 hours. During the 12-hour window, the webhook does not receive any updates until it is manually enabled within the window or is unsuppressed after 12 hours.
After Content Hub suppresses a webhook, you can enable it again using one of the following methods:
Wait 12 hours for Content Hub to re-enable the webhook.
Content Hub uses webhooks to communicate with the service, enabling your publisher and subscriber websites to communicate through the service as an intermediary. A webhook is an endpoint that the service knows about.
On a publisher or subscriber website, clicking the Update Public URL button in the interface creates a webhook. That registers your website, using the following format as the endpoint:
yourdomain.com/acquia-contenthub/webhook
A webhook defines the messaging endpoint. When information from the service sends to publishers or subscribers, the data sends as a POST request to the HMAC-authenticated endpoint. The Drupal module listens for those requests and performs actions based on the information in the request. Requests requiring actions may include entity creation (a new entity requires import), entity updates (content changes), or other changes.
Content Hub requires registering a valid webhook. If there is no registered webhook, some features do not work. Users may also see errors. Webhook registration failures often occur when the registering website is not publicly accessible, such as local development environments.
Changing webhooks
Users can change the webhook URL using the configuration form in the module. This may be necessary if you are working with Content Hub locally and need the public-accessible URL to be an ngrok tunnel.
Editing or deleting webhooks requires the Content Hub Publisher module.
Sign in to your Content Hub publisher website as an administrator.
Navigate to Configuration > Acquia Content Hub > Subscription Manager.
Under Administer webhooks:
Edit the URL field of an existing webhook
Use Add a new Webhook to add a new webhook
Remove the URL to delete a webhook
Click Save configuration.
Note
If your website does not have a valid SSL certificate, you must configure your webhooks using HTTP, not HTTPS.
They can also be updated through the Content Hub API, using a CRUD (create-read-update-delete) operation.
Updated webhooks register if the URL responds with a valid HMAC-authenticated response. You cannot register unauthenticated URLs such as example.com/acquia-contenthub/webhook.
Troubleshooting webhooks
If Content Hub cannot send webhooks to a subscribing website, it also cannot notify the subscribing website of a problem with the webhook. If a webhook fails or is unreachable for 72 hours, Content Hub suppresses the webhook for 12 hours. During the 12-hour window, the webhook does not receive any updates until it is manually enabled within the window or is unsuppressed after 12 hours.
After Content Hub suppresses a webhook, you can enable it again using one of the following methods:
Wait 12 hours for Content Hub to re-enable the webhook.
Content Hub