How to set up Authenticated links

Authenticated links give you a way to see data on which Members are accessing your external content in the app. You can then tailor your content based on your Members' preferences.

You can embed existing web content from external systems in the Folder system. This allows Hosts with a web development team to implement additional functionality in the form of web apps.

 

When Authenticated links are enabled, every time a Disciple community loads content from your external system, it will pass through encrypted data that provides information on which Members is accessing your content.

 

What do I need to set up Authenticated links?

To set up your Authenticated links, request an Authenticated links secret key from your Customer Success Manager. They will enable the feature and send you the secret key that you need to decrypt the information we send.

 

Once the feature is enabled, you will see a new tick box when adding an archive link that's labelled Add encrypted ID. You'll find this under the Archive tab when you create a Folder in your Advanced settings.

 

Screenshot 2020-07-29 at 13.47.19

 

When you tick this box, all requests for this URL will have a _dm query string parameter included, just like this:

https://example.com/?_dm=ac8b52d84194a523ce6f25116109df8cac8b52d84194a523ce6f25116109df8c 

 

The extra param _dm is an encrypted JSON object:

{

"id": 1234,

"email": "johnny@example.com",

"link_created_at": "2019-01-01T00:00:00"

}

 

The link_created_at timestamp indicates the time at which the link was generated/the Member opened the link. This is for security reasons to ensure that link authorisation cannot be held indefinitely.

 

We have sample code and instructions on how to decrypt the data available in our sample code repository.