Allow External Access

On this page FAQ’s
  1. Accessing the dataset using dataset Reference
 
  1. Accessing the dataset using the timestamp and a hash which is a more secured way of accessing the data.
 
  1. Use IP Addresses to add a level of security to the above 2 types.
 

Accessing the dataset using dataset Reference

external_access_reference

  1. Download Reference : Click on generate to generate new reference id by the system and you can use it.
  2. Update : Click on update to generate link using that reference.
  3. Link : It is the link to download the dataset. Share this link to other you want give access to them for the dataset.
https://<SITE_URL>/Manager/ExportReport.aspx?ref=<Random text available in Download Reference field>

Above URL is using a non-secured way of access the dataset where ref is the dataset reference which is a unique key displayed in the below screenshot

Accessing the dataset using the timestamp and a hash which is a more secured way of accessing the data.

external_access_secrete

  1. Download Reference : Click on generate to generate new reference id by the system and you can use it.
  2. Download Secrete : Click on generate to generate new secrete id by the system and you can use it.
  3. Update : Click on update to generate link using that reference.
  4. Link : It is the link to download the dataset. Share this link to other you want give access to them for the dataset.
  • Download Secret value should be provided to the Third Party
  • Also they have to be provided by the Download Reference value.
  • Third party has to use the Secret key along with the timestamp (https://en.wikipedia.org/wiki/Unix_time) like the hash is created by applying the SHA256 algorithm to the concatenated values of:
  • timestamp value : dataset reference which will be the unique hash value
  • So with all the above the URL that the Third party will use to access the dataset is as follows:
  • …/Manager/ExportReport.aspx?ref=<Download Reference>&timestamp=<will be provided by Third party>&hash=<Generated in step 3 above>
https://<SITE_URL>/Manager/ExportReport.aspx?ref=<Report_Ref>&timestamp=1434648909&hash=c682150b0d3c603192346d50089ae147f8cd276b7ee26ce15382a66d8c68d37f

Note

Both the above types will give XML as an output.

Use IP Addresses to add a level of security to the above 2 types.

external_access_ip

  1. Download Reference : Click on generate to generate new reference id by the system and you can use it.
  2. Download Secrete : Click on generate to generate new secrete id by the system and you can use it.
  3. Download IP : Provide ip address of the third party system and they can be separated by comma for multiple ip addresses.
  4. Update : Click on update to generate link using that reference.
  5. Link : It is the link to download the dataset. Share this link to other you want give access to them for the dataset.
  • The access to the dataset can also be restricted by IP addresses in which case only the user with those IP address will be able to access the dataset. To use this feature the IP address of the machine that wants to access the dataset has to be entered into the field displayed in the below screenshot. This field can have multiple comma (,) separated IP Addresses.