ResendWebhookSettings - System Parameter
Easily enable secure, self-service resubmission of business transactions with the Nodinite ResendWebhookSettings System Parameter. Empower your team to repair and resend Log Events using Webhooks, automate business recovery, and ensure compliance with flexible, role-based permissions.
✅ Enable secure, auditable resubmission of Log Events using Webhooks
✅ Automate business process recovery and message repair
✅ Fine-tune permissions for self-service and compliance
✅ Integrate with custom endpoints for advanced automation
The System Parameter ResendWebhookSettings controls user options for resending Log Events via one or more Webhooks. This feature is available in Log Views when the appropriate Roles permissions are granted.
A Log Event must have the Context value ExtendedProperties/1.0#EndPointUri
set for the Webhook option to be available for repair and resubmission. For more details, see the Context Options user guide.
The diagram displays examples where a Webhook is used to repair and resend Log Events.
System Parameter Name | Data Type | Values/Example | Comment |
---|---|---|---|
ResendWebhookSettings | json | JSON object as exemplified later on this page |
This feature was introduced in version 5.4.1.8, with new security features added in 6.1.0.40 and 7.x.
End-users can repair and resend logged business transactions (Log Events) using the Nodinite Web Client when the following conditions are met:
- The AllowResubmit System Parameter is set to true
- The AllowRepair System Parameter is set to true
- For applicable Log Views: The Role is assigned the Allow Resend permission
- For applicable Log Views: The Role is assigned the Allow Repair permission
Tip
To develop a custom Webhook, use the free webhook.site service to test and capture the result from the resend operation.
JSON Structure and Examples
Property | Data type | Example | Description |
---|---|---|---|
Enabled | boolean | true | When true, the Webhook option is allowed in the Nodinite Web Client, otherwise, when false it is not. |
EditableURI | boolean | true | When true, the user is allowed to enter any URI for the Webhook; when false, the user cannot. |
ExtractContextValues | json | [{"MessageTypeIds": [],"KeyRegEx": "ExtendedProperties\/1\.0\#(EndPointUri)","KeyGroup": 1}] |
Populate and use the named context properties as default for the set of MessageTypeIds. |
Webhooks | array | The array of Webhook entries. |
Webhook object
Property | Data type | Example | Description |
---|---|---|---|
Enabled | boolean | false | When true, the Webhook entry is available in the Nodinite Web Client, otherwise, when false it is not. |
DisplayName | string | The Webhook | The user-friendly name of the Webhook entry as presented to the end-user. |
Description | string | Use your custom built Webhook to resend Log Events | A user-friendly description of this Webhook entry. |
URI | string | https://127.0.0.1 | The address of the Webhook. |
Order | int | 0 | Enter the index to manage the display order when you have multiple Webhook entries. |
Example (Non-secure Webhook)
New 5.4
{
"Enabled": true,
"EditableURI": true,
"ExtractContextValues": [
{
"MessageTypeIds": [],
"KeyRegEx": "ExtendedProperties\/1\.0\#(EndPointUri)",
"KeyGroup": 1
},
{
"MessageTypeIds": [],
"KeyRegEx": "x-ms-client-tracking-id",
"KeyGroup": 0
}
],
"Webhooks": [{
"Enabled": false,
"DisplayName": "The Webhook",
"Description": "Use your custom built Webhook to resend Log Events",
"URI": "https://127.0.0.1",
"Order": 0
}]
}
This feature is available from Nodinite version 5.4.1.12
Example v7 (Secure Webhook with OAuth 2.0 and Basic Authentication)
New 7.x
With Nodinite v7, enhanced security features for Webhooks include support for OAuth 2.0 and Basic Authentication. Client secrets and passwords are securely stored using the same encryption mechanism as described in the Secret Management and Automated Certificate Handling in Nodinite documentation.
When you start, the ClientSecret and Password fields will be encrypted and prefixed with PROTECTED_1.
indicating that they are securely stored. You do not need to change these values unless you want to update the credentials.
{
"Enabled": true,
"EditableURI": true,
"ExtractContextValues": [
{
"MessageTypeIds": [],
"KeyRegEx": "ExtendedProperties\/1\.0\#(EndPointUri)",
"KeyGroup": 1
},
{
"MessageTypeIds": [],
"KeyRegEx": "x-ms-client-tracking-id",
"KeyGroup": 0
}
],
"Webhooks": [
{
"Enabled": true,
"DisplayName": "OAuth Webhook Example",
"Description": "Use a custom built Webhook with OAuth 2.0 authentication to resend Log Events",
"URI": "https://localhost/secure",
"Order": 0,
"Authentication": {
"Enabled": true,
"Type": "client_credentials",
"ClientId": "webhook",
"ClientSecret": "PROTECTED_1.WindowsCertificateStore.BCEBB8FD5C77E8E58853E03F6015A9A4223BC9C6.AES256-RSA-OAEP.DAAAALBXkv5l0w7kbWVMSAABAADBm/8qKQZY93TQOWK2EBP5K1ZdsR199rnUadX7ZoBda530VXN4aw+KN/SBxJXjcUcU+jfLCZYzHLHTdOJCGV0R+Ca9jKsUAF2puJADvAOJrMzR78k75vUo3TUFWkAK0ivjf9HLGtobeorc/KvDGIyT1+WK5IVp7aUmeOKaLnFMwMqoZUt6y0HRyYrwdfy/FaNvzr5bgsP8lmwaWEKtZ+2jWJ5xUtYZxHbKbYSG+xQhGZ+t6cWQvre8jr7E+Zdi/UEGde1EFYWqrbDaSytbG+vRW3TmqzjvjpFYS9U7fSZD8GBLweKgqBeoscoYhdowVrty4XYIJtlFSdTSWSXE+JxBEAAAAAVkvYYFhbNn9RGIzNZSGr60RLuMuMNuP6Hqvg==",
"OpenIdEndpointConfiguration": "http://localhost:8080/auth/realms/dev/.well-known/openid-configuration",
"Scope": null
}
},
{
"Enabled": true,
"DisplayName": "Basic Authentication Webhook Example",
"Description": "Use a custom built Webhook with basic authentication to resend Log Events",
"URI": "https://127.0.0.1",
"Order": 1,
"Authentication": {
"Enabled": true,
"Type": "basic",
"Username": "DaUserName",
"Password": "PROTECTED_1.WindowsCertificateStore.BCEBB8FD5C77E8E58853E03F6015A9A4223BC9C6.AES256-RSA-OAEP.DAAAAAo3DuY6Q+2WGHqLBgABAACtLhSApGWYjo94p7/ua1EVAOI2u45A3BPKY3I4EbgCeuapFybQju1+B0Ew3vUuTzEbQ/GHNjj3qX45oyeDQTHQ/RJMQbzdzVepsKThM2znyXCM6GdmPmTKTM8IbxZBKFr7gL8OcRa5yfP9CSpmD+H36SdWBQP8P9fwbm3dkLoow7KcVRTQLLiQHarTKE4GCntWMe3qdfdMqFjBzAaPTSXoeyWAMCY8qprv6ZtFkuOteahQ888JMC0RERewWyiOHXA8jI0lg3qgyAb9lMSMbKKjDeun6waNQoVmbDmAznq5tvMYBMv5tV5SKpJUWWdqM6LztaWtIcjvg91ajARqiNzHEAAAAJ6wrFDR+mz7Qm3MxnlWe7xIGb7DQlAoWYbxNg=="
}
}
]
}
Example v6 (Secure Webhook)
When you start, the Protected attribute should be false
, and the Password and ClientSecret should be in clear text. When you save the entry, the client secret is encrypted and the protected attribute changes to true
.
NOTE1: If you change the Protected attribute from
true
tofalse
without passing the client secret in clear text, the ClientSecret will be double encrypted and render this Webhook target inoperable.
New 6.1
{
"Enabled": true,
"EditableURI": true,
"ExtractContextValues": [
{
"MessageTypeIds": [],
"KeyRegEx": "ExtendedProperties\/1\.0\#(EndPointUri)",
"KeyGroup": 1
},
{
"MessageTypeIds": [],
"KeyRegEx": "x-ms-client-tracking-id",
"KeyGroup": 0
}
],
"Webhooks": [
{
"Enabled": true,
"DisplayName": "OAuth Webhook Example",
"Description": "Use a custom built Webhook with OAuth 2.0 authentication to resend Log Events",
"URI": "https://localhost/secure",
"Order": 0,
"Authentication": {
"Enabled": true,
"Protected": false,
"Type": "client_credentials",
"ClientId": "webhook",
"ClientSecret": "DaPassword!",
"OpenIdEndpointConfiguration": "http://localhost:8080/auth/realms/dev/.well-known/openid-configuration"
}
},
{
"Enabled": true,
"DisplayName": "Basic Authentication Webhook Example",
"Description": "Use a custom built Webhook with basic authentication to resend Log Events",
"URI": "https://127.0.0.1",
"Order": 1,
"Authentication": {
"Enabled": true,
"Protected": false,
"Type": "basic",
"Username": "DaUserName",
"Password": "DaPassword!"
}
}
]
}
This feature is available from Nodinite version 6.1.0.40
Frequently asked questions
Find more solutions and answers in the Nodinite System Parameters FAQ and the Troubleshooting user guide.
How do I change the value?
Changing a value for the pre-defined System Parameters is described in the generic 'How do I change the System Parameters' article.