nebula.js/commands/serve/web/components/Hub/SelectEngine/ConnectionGuid.jsx

import React from 'react';
import Link from '@mui/material/Link';
import Collapse from '@mui/material/Collapse';
import Typography from '@mui/material/Typography';

const ConnectionGuid = ({ showGuid }) => (
  <Collapse in={showGuid}>
    <Typography variant="h6" gutterBottom style={{ marginTop: '1rem' }}>
      WebSocket URL
    </Typography>
    <Typography variant="body2" paragraph>
      The development server needs to connect to and communicate with the Qlik Associative Engine running within any of
      Qlik&apos;s product offerings. The connection is done through the WebSocket protocol using a WebSocket URL format
      that differs slightly between products. Enter the WebSocket URL that corresponds to the Qlik product you are
      using.
    </Typography>

    <Typography variant="subtitle1" gutterBottom>
      Qlik Cloud Services
    </Typography>
    <Typography variant="body2" paragraph>
      <b>Web integration id format:</b>
      There are two ways in order to connect through WebSocket:
      <br />
      1. <code>qlik-web-integration-id</code>
      <br />
      2. <code>qlik-client-id</code>
      <br />
      <br />
      <b>Web integration id:</b>
      <br />
      <code>wss://&lt;tenant&gt;.&lt;region&gt;.qlikcloud.com?qlik-web-integration-id=&lt;web-integration-id&gt;</code>
      <br />
      Example: <code>wss://qlik.eu.qlikcloud.com?qlik-web-integration-id=xxx</code>
      <br />
      <br />
      For more info, visit{' '}
      <Link
        color="secondary"
        underline="always"
        href="https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-adminster-web-integrations.htm"
      >
        Managing web integrations
      </Link>
      .
    </Typography>
    <Typography variant="body2" paragraph>
      <b>OAuth Client ID URL format:</b>
      <br />
      <code>wss://&lt;tenant&gt;.&lt;region&gt;.qlikcloud.com?qlik-client-id=&lt;client-id&gt;</code>
      <br />
      Example: <code>wss://qlik.eu.qlikcloud.com?qlik-client-id=xxx</code>
      <br />
      Redirect URL form: <code>http://localhost:8000/auth/login/callback</code>
      <br />
      The <code>qlik-web-integration-id</code> <b>OR</b> <code>qlik-client-id</code> must be present in order for QCS to
      confirm that the request originates from a whitelisted domain.
      <br />
      <br />
    </Typography>
    <Typography variant="subtitle1" gutterBottom>
      Qlik Sense on Windows
    </Typography>
    <Typography variant="body2" paragraph>
      WebSocket URL format: <code>wss://&lt;sense-host.com&gt;/&lt;virtual-proxy-prefix&gt;</code>
      <br />
      Example: <code>wss://mycompany.com/bi</code>
      <br />
      <br />
      Note that for the Qlik Sense Proxy to allow sessions from this webpage,
      <code>{window.location.host}</code> needs to be whitelisted in QMC in your Qlik Sense on Windows deployment. In
      addition, you need to enable <i>Has secure attribute</i> and set <i>SameSite attribute</i> to <i>None</i>.
      <br />
      Also some &quot;Additional reponse headers&quot; needs to align with the whitelisted domain:
      <ul>
        <li>
          Access-Control-Allow-Origin: <code>{window.location.host}</code>
        </li>
        <li>Access-Control-Allow-Credentials: true</li>
        <li>Access-Control-Expose-Headers: qlik-csrf-token</li>
      </ul>
      Make sure you are logged in to Qlik Sense in another browser tab.
    </Typography>
    <Typography variant="subtitle1" gutterBottom>
      Qlik Sense Desktop
    </Typography>
    <Typography variant="body2" paragraph>
      WebSocket URL format: <code>ws://localhost:4848</code>
    </Typography>
  </Collapse>
);

export default ConnectionGuid;