Genius Cayan Root Certificate Installation

Home/Developers / Knowledge Base / Genius Cayan Root Certificate Installation

 

Genius version 5.0 and later supports a HTTPs interface in addition to its traditional HTTP interface. Only the protocol scheme (https vs. http) and port (8443 vs 8080) differ from traditional Genius implementations. All other details regarding how your POS communicates with the terminal are unchanged - all API calls, URIs, messages, and request/response payloads are identical, excepting the protocol scheme and port. For more details, please see Alternate Device Communication Methods in our Genius documentation.

Genius supports a HTTPS interface so users can communicate with the CED using TLS to secure the connection. Combined with Genius's CORS support, this feature is especially useful for partners who have developed browser based Points of Sale. The terminal will generate appropriate certificates as required in order to serve the TLS connection, and all certificates generated by the CED will be signed by the Cayan CA.

This means that if merchants install the Cayan CA, then their client machines will trust the certificates that are served by the terminal.

Installing the Cayan CA

The Cayan Root Certificate can be downloaded from http://cayan.com/Site/Media/Cayan/Cayan.crt. Instructions differ between Operating Systems and Browsers, but installation is generally straight forward. Generally, you just need to download the certificate, double click it, and follow the prompts on your screen.

Installation instructions are provided below for some major Windows-based browsers. Firefox appears to use its own local certificate store, while Internet Explorer and Chrome appear to use the standard Windows certificate store. This means that if your POS is a desktop application, you will probably need to follow the Internet Explorer / Chrome installation instructions.

firefox

Go to http://cayan.com/Site/Media/Cayan/Cayan.crt

If you see:

Certificate-Alert.png

Then you've already got the Cayan CA installed and you don't have anything further to do. Otherwise, you'll see:

Certificate-Installation-(1).png

Ensure that "Trust this CA to identify websites" is checked, then click "OK", and you're done.

Internet Explorer / Chrome

Go to http://cayan.com/Site/Media/Cayan/Cayan.crt and you'll be offered to download the Cayan.crt file, download it and save it somewhere on your hard drive.

Locate the file on your hard drive and right-click on it and choose "Install Certificate".

Follow the resulting prompts, and when asked "Windows can automatically select a certificate store, or you can specify a location for the certificate", choose "Place all certificates in the following store" and hit "Browse":

Certificate-IE-Install-(1).png

When prompted, choose "Trusted Root Certification Authorities" and click "OK":

Certificate-Trust.png

Then click "Next" then "Finish" to complete the installation and you should see:

Certificate-Success.png