User Involvement

Verifications

Events may include Recommendations of NOTIFY_USER_WITH_LINK type. This indicates that you should contact the user to close the loop on unrecognized activity.

These types of recommendations will include a template string with pre-written messaging that you can send directly to the user. Simply replace the {link} substring in the template with a link to a page where you can handle the verification.

Currently, if you choose to handle verifications yourself, you will leave DFend blind about the state of locations, devices, and other verifiable data fields on an Identity. We are expanding our API to support this type of feedback, but we can also get around this issue by handling verifications for you.

DFend verifications

Configure DFend to handle verifications by allowing your users to opt into DFend. When you enable this functionality, your Recommendations templates will come pre-populated with links to DFend co-branded verification pages. We will handle user feedback and send you related Events.

Our verifications system is robust. It includes a mechanism for handling timeout periods and supports sending escalated events when rejected items continue to present themselves in your system.

Enable in Dashboard under Setup > Policies.

Opt into DFend

To allow users to opt into DFend (and subsequently opt out, if desired) you will need to surface DFend in your UI. Use the convenience methods in our JS SDK.

  • Easily retrieve a user's current opt-in status with a single method call.

  • Easily generate links for opt-in and opt-out pages specific to a user.

Setup steps without the JS SDK

Find a user's current opt-in status by sending a request to our HTTPS API on the Identity Status endpoint.

Next, generate the correct link.

In your app under User Settings, surface the user's current opt-in status and add a button that sends the user to whichever page will change their current status.

Insert the values into the string using interpolation.

`https://dashboard.dfend.app/opt-in/k/${publishableApiKey}/u/${userId}`

Insert the values into the string using interpolation.

`https://dashboard.dfend.app/opt-out/k/${publishableApiKey}/u/${userId}`

We will send Events of type USER_OPTED_IN and USER_OPTED_OUT when a user's opt-in status changes in our system. In the case where a user opts out, you can continue to send Signals with their user ID--we will not contact them until they opt back in.

Last updated