Understanding the Root Cause

The root cause of this issue is often a misconfiguration of the named credentials used by the out of the box topic. Specifically, the dw-x-client-secret header is required for authentication, but is not included by default in the named credentials.

The named credentials are missing the required dw-x-client-secret header, causing the authentication to fail.

Resolving the Issue

To resolve this issue, teams need to update the named credentials to include the dw-x-client-secret header. This can be done by editing the named credentials and adding the header with the correct value.

named_credentials.json

{
  "headers": {
    "dw-x-client-secret": "your_client_secret_here"
  }
}

Once the named credentials are updated, the out of the box topic should be able to authenticate correctly and complete the flow without errors.

Best Practices

To avoid similar issues in the future, teams should verify that all named credentials are properly configured and tested before using them in out of the box topics.

Heads up: Always test your named credentials using a tool like Postman before using them in Agentforce.

Checklist

Configuring Named Credentials for Out of the Box Topics

• Verify that the named credentials are correctly configured and tested
• Include the dw-x-client-secret header in the named credentials
• Test the named credentials using a tool like Postman
• Update the named credentials in Agentforce with the correct values
• Verify that the out of the box topic is working correctly after updating the named credentials

Frequently Asked Questions

What is the dw-x-client-secret header?

The dw-x-client-secret header is a required header for authentication with certain external systems.

How do I obtain the dw-x-client-secret value?

The dw-x-client-secret value can be obtained from the external system’s documentation or support team.

Can I use a different header instead of dw-x-client-secret?

No, the dw-x-client-secret header is specifically required for authentication with certain external systems.

What if I am still having issues after updating the named credentials?

If you are still having issues, verify that the named credentials are correctly configured and tested, and that the out of the box topic is working correctly.