A webhook integration allows you to send BloxOne Infoblox Platform notifications to a designated application by using a unique URL. When setting up your a webhook service, you can choose to use the default webhook template or construct a custom template for a specific payload for your webhook notification.  

In this dialog, you will be configuring a webhook integration that allows you to send BloxOne notifications to a designated application using a unique URL.

Complete the following to set up the webhook service 

Creating New Webhook Services

To set up a new webhook service, do the following:

1. Log in to Infoblox Portal.
2. Click the notification icon on the top right corner of the Portal (next to the global search icon).
3. In the Notifications panel, click the ellipse icon > View All/Settings.
4. Click the Service Integrations tab.
5. Click Add Service Integration and specify the following:

• Type: From the drop-down menu, select Custom to set up a webhook integration.
• Name: Enter the name of the webhook service. BloxOne Infoblox Platform uses this name on the Notification Settings page, for configuration purposes. For more information, see Configuring Notification Settings.
• URL: Enter the URL of the application to which you want BloxOne Infoblox Platform to send notifications. Email notifications in a standardized JSON format are sent to this URL.
• Authentication: From the drop-down menu, choose the authentication method for this webhook integration:
  
  • None: No authentication is required for this integration.
  • Basic: Enter the username and password for basic authentication.
  • Token: Enter the access token to be used for authentication.  

• Template: A template determines the output of your webhook notification. You can create a custom webhook template in the editor provided here.  BloxOne Infoblox Platform supports the Go template format: a standard template used to generate textual output. For information about Go templates, see https://pkg.go.dev/text/template. If you do not provide a custom template, BloxOne Infoblox Platform generates the payload according to the supported fields in the default template. For more information, see Default Webhook Template and Supported Keys.

• Webhook Context: Note the following when creating a custom webhook template:.
• You can include actions in your template by specifying user-defined key-value pairs in Webhook Context. When generating the payload,
 BloxOne
•  Infoblox Platform uses the keys and values you define.
 
• If you compose a valid template but have not defined any key-value pairs in Webhook Context, then
BloxOne
• Infoblox Platform obtains the values from the database, if the values exist. For the keys that do not have values, only the key names with empty values will appear in the payload.
• If you compose a valid template but do not include certain keys you have defined in Webhook Context,
BloxOne
• Infoblox Platform ignores those key-value pairs, so they will not appear in the payload.
• If your custom template includes supported keys from the default template, and if you have defined key-value pairs for them in Webhook Context, the user-defined values will override the default values, if applicable.

...

For more information about the default template and supported keys, see Default Webhook Template and Supported Keys.

You can also use the BloxOne Infoblox API to create a custom template. For more information about using the notification APIs, see BloxOne Cloud > Infoblox Platform > Notifications config in 
https://csp.infoblox.com/apidoc.

...

{

    "customer_name": “John Doe”,

    "application_name": "BloxOneUniversal DDI",

    "Authorization": ["Basic YWxhZGRpbjpvcGVuc2VzYW1l", "http-header:true"],

    "Content-type": ["application/xml", "http-header:true "]

	“actionable_redirect_action”: “https://actionable.redirect.url.com”,

	“actionable_redirect_label”: “actionable redirect link text”

}

...

Based on the examples given in the Template and Webhook Context fields, BloxOne Infoblox Platform generates the following:

 HTTP headers:

...

Click Validate after you complete the template and webhook context. BloxOne Infoblox Platform validates the JSON schema you have entered and sends an error if the template or webhook context is not in a valid JSON format.

...

Modifying Existing Webhook Services

If you need to modify an existing webhook service, you must first disable all notifications associated with the service. You can then make changes to the webhook service before enabling notifications again.

To modifying an existing webhook service, do the following:

1. Log in to Infoblox Portal.
2. Click the notification icon on the top right corner of the Portal (next to the global search icon).
3. n the Notifications panel, click the ellipse icon > View All/Settings
4. Click Admin Settings on the upper right-hand corner of the page.
5. In the Admin Settings dialog, expand the Service Integrations section.
6. Deselect all the notification check boxes for the respective webhook service to which you plan to make changes.
7. Click Save & Close.
8. Go to the Notifications > Service Integrations tab.
9. Click Edit on the webhook service you want to modify.
   
10. In the edit dialog, make the required changes, and then click Save & Close. See the Creating New Webhook Services section for more information.
    
11. Click Admin Settings on the upper right-hand corner of the page again.
    
12. In the Admin Settings dialog, expand the Service Integrations section.
13. Select the check boxes of the notifications that you want to enable for the modified webhook service.
14. Click Save & Close.