Device Fingerprint

This document describes how to connect an external Fingerprint solution.

Portal supports sending a fingerprint through a blackbox field as a part of login process (through PAS API) and registration process (as a part of Open / Galaxy API).

Below are the steps on how to connect different Fingerprint providers.

Iovation

In order to connect Iovation to Portal, request two JS files from Iovation: config.js and loader_only.js.

Upload these files into a iovation folder in CMS -> Content Configuration -> Document and Media.

Include uploaded scripts in CMS -> Settings -> Embedded Code -> HTML to add before the </head>

<script src="/library/iovation/config.js"></script>
<script src="/library/iovation/loader_only.js"></script>

In case a reverse proxy is required, raise a request to Portal team in order to set up the reverse proxy for Iovation.

Generic

In order to connect some generic fingerprint solution, follow the integration guide of the fingerprint solution (e.g. include all necessary external scripts) and then create the following script in CMS -> Settings -> Embedded Code -> JavaScript to add on application initialization:

// set any global name
window.io_global_object_name = 'IGLOO';
window[window.io_global_object_name] = {
    getBlackbox() {
        // here should be the code that actually calls fingerprint API 
        // and returns the following construct as soon as it is ready:
        return {
            finished: true,
            blackbox: 'fingerprintToken'
        };
    }
};