By default, the Imply Cloud Manager proxies connections between Pivot users' browsers and Pivot. Alternatively, you can configure direct access for Pivot. In this mode, Pivot users access Pivot directly, from within the VPC in which the Imply cluster runs.
Why use direct-access mode?
Direct access mode offers a few advantages over standard access with Imply Cloud. The Pivot APIs are available in direct access mode, but not when in the default, proxied mode.
Also, in direct access mode, traffic between a Pivot user's browser and the Druid cluster does not need to traverse public networks.
On the other hand, in direct access mode, functions that the Imply Cloud Manager performs in proxy mode, such as user authentication, need to be provided for separately.
Enabling direct access mode
Direct access is not available by default. You need to contact the Imply support team to have the feature enabled for your account.
Once direct access mode is enabled by Imply support, you need to perform some additional configuration steps in the Imply Manager, as described here. Note that the UI settings described here are not visible in Imply Manager unless direct access mode has been enabled for the account.
After direct access mode is enabled, follow these configuration steps:
Select how to manage Pivot users when switching to direct access mode:
- From the Imply Manager home page, click the Manage link for the cluster you are setting to direct access mode.
- Click Setup and expand the Advanced config settings.
- From the Access mode menu under the Pivot settings, choose native, OIDC, or LDAP as the Pivot user authentication option:
Note that proxied is the default option. Choosing one of the other three options effectively puts Pivot into direct access mode.
Optionally, set the URL for Pivot Access field to a published domain name to which Pivot users can go to access Pivot (e.g.,
Setting this field enables access options for opening Pivot from the Cloud Manager UI, that is, the Open button next to the cluster in the cluster list view.
For LDAP or OIDC, specify the role authority for users, Pivot or the external authentication mechanism. Also provide user options, if needed. See Using LDAP in Pivot or Using OIDC in Pivot for more information.
In the AWS account, set a DNS mapping between the Pivot URL you entered and the load balancer. Druid clusters created by Imply have two load balancers associated with them. One serves as an internal load balancer (for internal VPC access) and the other serves as an external load balancer (for public internet access).
Depending on which one you want to map the Pivot URL to, you need to put that into your DNS mapping Route table. For example:
Pivot.customercompany.com → internalELB.amazonaws.com:9095
Note that you can find the load balancer hostname in the API page for the cluster, as shown:
Note the following caveats:
- The load balancers are deleted or removed when you terminate or stop the cluster; when you restart your cluster, make sure that you retrieve the new hostname from the page and add it into the route table.
- Rolling upgrades will not change the load balancer’s hostname and won’t impact the route table.
- In standard proxied mode, Imply Manager manages the Imply Pivot license. When you switch to direct access mode, Imply Manager generates a license and installs it as a local Pivot license. It resumes license management if switched back to proxied mode.
Provide a public CA certificate in the load balancer. Imply has a self-signed certificate stored on all Imply cluster nodes and load balancers, but as it is self-signed, most browsers will deem this insecure and throw warnings when being redirected to the Pivot URL you configured. To avoid this, you must put a public CA certificate in the load balancer whose hostname is mapped to the Pivot URL you intend for end users to visit.
The same caveats of the load balancer apply when a cluster is stopped or terminated.
Users can now access Pivot on port 9095 of the load balancer URL, as listed on the cluster's API tab. The Pivot UI is no longer accessible at the usual URL for Cloud Imply,