Sites With an HTTPS Console¶
A site carries out what the Hub sends it by replaying each request to its own console, on the same machine (127.0.0.1, on the console's port). Every request that arrives over the site's tunnel is handled this way: proxied console pages, console sign-in through the Hub, job steps and AI calls through the Hub.
How the Site Replays Over HTTPS¶
When the site's console runs on HTTPS (qie.secureConsole is on; see Securing the QIE Web Console (HTTPS)), the site replays the Hub's requests over HTTPS too. Nothing has to be set at the Hub, and nothing beyond the console's own options at the site.
The site trusts exactly the certificates of the key entries in the keystore named by qie.consoleKeyStore, opened with qie.consoleKeyStorePass: the certificates the console itself serves. Any other certificate is refused, whoever signed it. The replay goes to 127.0.0.1, which the console's certificate does not name, so the site does not check the host name.
Opening the Hub Over HTTPS¶
Open the Hub over HTTPS to stay signed in to a site whose console uses HTTPS. Such a site marks its session cookie Secure, and the Hub passes that mark on to the browser. A browser discards a Secure cookie that arrives over plain HTTP. Some browsers make an exception for a Hub opened at localhost, so a sign-in there can hold while the banner shows. Through a Hub opened at an http:// address, the site's sign-in therefore does not hold, and the site shows its login page again.
This applies when Connect signs the person in (see Console Sign-In Through the Hub), and to a sign-in on the site's own login page. With subdomain routing, the Hub marks every cookie a site sets as Secure (see HTTP Proxy). A Hub opened over HTTP then cannot keep a person signed in at any site, whatever the site's console uses.
While the Hub is open over HTTP, the Sites Dashboard and the Hub Configuration page show a red banner that says so. To serve the Hub over HTTPS, see step 3 of the Hub's installation steps.
When the Keystore Cannot Be Used¶
If qie.consoleKeyStore is not set, the keystore cannot be read, or it holds no key entry with a certificate, the site cannot replay over HTTPS. It answers each request the Hub forwards with HTTP 502 and writes the reason to its log. In the browser, a site opened through the Hub shows the 502 error instead of the console.
Check the site's three console options, and that the site's own console opens over HTTPS, then try again.