Home Channels & Inboxes Secure the widget: allowed domains and identity validation

Secure the widget: allowed domains and identity validation

Last updated on Oct 04, 2026

Open Inbox → Configuration on a website inbox.

Allowed domains

Restrict which sites can embed your widget. Enter your domains separated by commas (for example example.com, www.example.com). Leave it empty to allow all, which is not recommended in production. If you also embed the widget in a mobile app, tick the option that allows it, because apps don't send a domain.

Identity validation

Use it when your own site knows who the user is. Your server signs the user's identifier with the inbox's secret key (HMAC) and passes it to the widget. VoxelEon then trusts that the person is who you say. Turn on Require identity validation to reject conversations without a valid token.

Rotating the secret key

Rotate revokes the current key instantly with no overlap and it can't be restored. Update your servers first; anyone still signed with the old key fails verification, and if validation is required they can't start a conversation.