Contents x
    Third Party Access
    • 16 Nov 2021
    • 2 Minutes to read
    • Print
    • PDF
    Contents

    Third Party Access

    • Updated on 16 Nov 2021
    • 2 Minutes to read
    • Print
    • PDF
    Article Summary

    Accessing the dataset using dataset Reference

    image.png

    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 (More secured)

    image.png

    Download Reference : Click on generate to generate new reference id by the system and you can use it.
    Download Secret : Click on generate to generate new secrete id by the system and you can use it.
    Update : Click on update to generate link using that reference.
    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=&timestamp=&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

    image.png

    Download Reference : Click on generate to generate new reference id by the system and you can use it.
    Download Secret : Click on generate to generate new secrete id by the system and you can use it.
    Download IP : Provide ip address of the third party system and they can be separated by comma for multiple ip addresses.
    Update : Click on update to generate link using that reference.
    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.

    Was this article helpful?
    What's Next