This article explains how to use the Restrict reset password URL setting in Integration Hub to limit the resetUrl in Cleeng password reset emails to domains you allow, so that the reset links your customers receive open only on your own sites.
When a customer requests a password reset, your integration can pass a resetUrl: the page the reset link in the email opens. Turning on the restriction makes sure that link can only point to domains on your list. This prevents anyone from using your account to send your customers reset links that lead to another site.
Before you start
- You need access to the Cleeng dashboard.
- Know the domain of your password reset page, for example
account.example.com. - Check whether the restriction is already on. New accounts start with the restriction on. Their list contains Cleeng’s domain (
widgets.prod.cleeng.com) and the website entered at sign-up. Accounts created earlier have the restriction off until you turn it on.
Steps to turn on the restriction
- Log in to the Cleeng dashboard.
- Go to Admin & Tools > Integration Hub.
- In the Cleeng Configurations section, select Mediastore API.
- Switch on Restrict reset password URL.
- Under Allowed reset password URL domains, type your domain and select Add. Enter the domain only, without
https://or a path. Add each domain separately. -
Save the configuration.
- If the Mediastore API integration is already connected, select Save.
- If it’s not connected yet, select Connect Mediastore API to save the configuration and connect the integration. If you select Save instead, your settings are saved, but you can connect the integration later.The change can take a few minutes to take effect.
How domains are matched
- Enter the domain only, without
https://or a path. Forhttps://account.example.com/reset?lang=en, enteraccount.example.com. - The domain must match an entry exactly.
example.comdoes not allowwww.example.comoraccount.example.com. Add each domain you use separately. - The reset link must use
https. - The path, query string and port are not checked.
In these examples, your list contains account.example.com and example.com.
resetUrl sent
|
Result |
|---|---|
| https://account.example.com/reset | Email sent |
| https://example.com/password?token=… | Email sent |
| https://www.example.com/reset | No email (domain not on the list) |
| http://account.example.com/reset | No email (not https) |
| No resetUrl | Email sent with Cleeng’s default reset link |
Good to know
- A blocked request returns a success response, so the Reset password API doesn't reveal your settings. If customers report that they don't get reset emails, check that your reset page's domain is on the list.
- If you use Cleeng's hosted customer flows for password reset, keep the Cleeng domain that's already on the list.