SSO Technical Details | Developer Instructions

Add the following JavaScript snippet in header/footer. This code will add “iframe.js” file from Online Review Manager website to your website.

(function(d, s, id) {
    var js, fjs = d.getElementsByTagName(s)[0];
    if (d.getElementById(id)) return;
    js = d.createElement(s);
    js.id = id;
    js.src = "//online-review-manager.com/assets/sso/js/iframe.js";
    fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'sso-jssdk'));

In the location you want to render the iframe, add a div with the following attributes:

  • id="sso_login"
  • data-key="login-hash" - used to authenticate the user
  • data-width="1000px" - defines the width of the iframe
  • data-height="1000px" - defines the height of the iframe

Eg: <div id="sso_login" data-key="{your-login-hash}" data-width="1000px" data-height="1000px" id= "sso_login"></div>

Building Your Login Hash

To build your login hash, you need to hash (sha256) the user's email address and join it to your ORM AppId.

Your ORM AppId (64 character string) can be obtained by asking your account rep.

Eg: data-key="f3273dd18d95bc19d51d3e6356e4a679e6f13824497272a270e7bb540b0abb9d-91eebb3af09ae11a9f0f71ce0016a1165d466ba09ac254d17006a47df5440f6c"

Note: The 2 fields are joined with a hyphen ("-")

Additional Setup

Before the SSO iframe will render correctly, you need to ensure that the hosting domain and/or IP Addresses are configured on the Online Review Manager platform.

The hosting domain should be specified under White Label Options in your Agency settings. The Online Review Manager allows only for a single domain.

The hosting IP Address should be specified under API Options in your Agency settings. Multiple IP Addresses can be provided, separated by a comma.

Note: When doing local testing, the IP Address that should be added in the Online Review Manager portal is your local private IP, not 127.0.0.1

Cookies

Note: SSO requires users' browsers to have cookies enabled.