Skip to content

Commit e2ff1d8

Browse files
authored
Document secured Superset - Trino connection (#773)
* document superset connection * improve wording consistency * improve root cert sentence
1 parent 1715cfb commit e2ff1d8

File tree

3 files changed

+35
-0
lines changed

3 files changed

+35
-0
lines changed
40.1 KB
Loading
52.2 KB
Loading

docs/modules/trino/pages/usage-guide/connect_to_trino.adoc

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,41 @@ It is typically secured via HTTPS with a certificated provided by a xref:secret-
2020
As most setups use a self-signed certificate, that cannot be verified without the CA certificate, the easiest way is to disable the Trino cert validation as the following guide does, however this is not secure!
2121
To use certificate validation instead, you need to extract the `ca.crt` file from the the SecretClass and provide it to the Trino client.
2222

23+
== Connect with Superset
24+
25+
In Superset, a `Database Connection` to Trino can be configured via the API or UI.
26+
Set the `SQLALCHEMY URI` in the `Basic` tab.
27+
28+
image::connect-with-superset-1.png[]
29+
30+
Stackable Trino clusters use HTTPS per default. Therefore additional settings must be configured.
31+
32+
=== Set `http_scheme`
33+
34+
In the `Advanced` tab under `Other` in the `ENGINE PARAMETERS` settings, set the `http_scheme` explicitly to `https`.
35+
36+
[source,json]
37+
----
38+
{"connect_args":{"http_scheme":"https"}}
39+
----
40+
41+
image::connect-with-superset-2.png[]
42+
43+
=== Set `ROOT CERTIFICATE`
44+
45+
Additionally, in the `Advanced` tab under `Security` in the `ROOT CERTIFICATE`, you may want to set a CA Bundle for e.g. self-signed certificates.
46+
47+
=== Skip TLS verification
48+
49+
WARNING: This deactivates TLS verification and should only be used for testing purposes and never in production!
50+
51+
In the `Advanced` tab under `Other` in the `ENGINE PARAMETERS`, set `verify` to `false`.
52+
53+
[source,json]
54+
----
55+
{"connect_args":{"verify":false,"http_scheme":"https"}}
56+
----
57+
2358
== Connect with trino-cli
2459

2560
Consult the {trino-cli}[official trino-cli docs] for details on how to connect to a running Trino cluster.

0 commit comments

Comments
 (0)