Skip to main content
Version: v2.10.0

Workspace JDBC, Access Management, and Secrets

We cover the last three tabs of a Workspace here: JDBC, Access Management, and Secrets.

JDBC

The JDBC tab lists the ready-to-paste Hive JDBC connection strings for the clusters in the Workspace, together with the credentials you authenticate with.

Route:

/workspace/<id>/jdbc?page=1&limit=20

Workspace JDBC tab with the Download Drivers button, JDBC USERNAME and JDBC TOKEN cards, and the cluster URL table

Toolbar

ControlDescription
Search By Cluster NameFilters the table by cluster name.
Download DriversA download link for the standalone Hive JDBC driver JAR (hive-jdbc-3.1.3-standalone.jar) matching the Yeedu release.
JDBC USERNAMEA read-only card showing the signed-in user's email address, with a copy-to-clipboard icon.
JDBC TOKENA read-only card showing the token masked as dots, with reveal and copy icons.
note

Use the value in the JDBC USERNAME card as the connection username and the value behind the JDBC TOKEN card as the password when your SQL client prompts for credentials.

Columns

ColumnDescription
Cluster NameName of the cluster, rendered as a link to the cluster. Sortable.
UrlThe full Hive JDBC connection string for that cluster. Sortable.
ActionsA single copy icon that copies that cluster's JDBC URL to the clipboard.

URL shape

Each URL is a standard jdbc:hive2 string whose httpPath encodes both the Workspace and the cluster:

httpPath=/api/v1/workspace/<workspaceId>/cluster/<clusterId>/thrift

A complete URL looks like this:

jdbc:hive2://demo.yeedu.io:8080/default;ssl=true;transportMode=http;httpPath=/api/v1/workspace/298/cluster/364/thrift;reuseSameConn=true;ignoreHttpVerify=true;maxJobStartTimeout=5;

Because the cluster id is part of the path, the table shows one row per cluster in the Workspace. The list is paginated, with page controls and a page-size dropdown in the footer.

Access Management

The Access Management tab grants Workspace-level permissions to groups and to individual users.

Route:

/workspace/<id>/workspace-access-management?workspaceId=<id>

Workspace Access Management tab with the Groups panel on the left and the Users panel on the right

The tab is split into two side-by-side panels — Groups on the left and Users on the right. Each panel has its own add row and its own save button, so we save group and user grants independently.

Permission model

Each panel exposes four permission columns — Manage, Edit, Run, and View. They're rendered as radio buttons, so a principal holds exactly one level; the levels are mutually exclusive, not additive.

LevelMeaning
MANAGEEverything EDIT allows, plus updating the Workspace itself, making it Active or Inactive, and managing its access.
EDITEverything RUN allows, plus creating, updating, activating and inactivating Jobs and Notebooks, and importing into the Workspace.
RUNEverything VIEW allows, plus running and stopping Jobs and Notebooks.
VIEWRead Job and Notebook configurations and run history.

This is the same permission enumeration we use for tenant-level access management.

Groups panel

The add row consists of a Select Groups dropdown, a permission dropdown that defaults to MANAGE, and an Add button. Pick a group, choose its permission level, and click Add to place it in the table below.

ColumnDescription
GroupsName of the group. Sortable.
Group TypeType of the group. Sortable.
ManageRadio button granting MANAGE.
EditRadio button granting EDIT.
RunRadio button granting RUN.
ViewRadio button granting VIEW.
Group MailMail address associated with the group. Sortable.
ActionsDelete icon that removes the group's access.

When no groups have been granted access the table shows No Groups Found. Click Update Groups at the foot of the panel to save your changes.

Users panel

The add row consists of a Select Users dropdown, a permission dropdown that defaults to MANAGE, and an Add button.

ColumnDescription
UsersUsername of the user. Sortable.
ManageRadio button granting MANAGE.
EditRadio button granting EDIT.
RunRadio button granting RUN.
ViewRadio button granting VIEW.
Display NameDisplay name of the user. Sortable.
Email IDEmail address of the user.
ActionsDelete icon that removes the user's access.

The Users panel is paginated, with page controls and a page-size dropdown in the footer. Click Update Users at the foot of the panel to save your changes.

note

Adding, changing, or deleting a row only takes effect once you click Update Groups or Update Users for that panel.

Secrets

The Secrets tab is the Workspace-scoped secrets list, pre-filtered to the current Workspace.

Route:

/workspace/<id>/secrets

Workspace Secrets tab listing workspace-scoped secrets with their secret types

It's the same component as Secrets ▸ Workspace at tenant level, with the Workspace selector pinned to the Workspace you're in. It has the same info bar, the same Search By Name box, and a + Secret button at the top right of the toolbar. The row Actions kebab carries exactly two entries, Edit and Delete, the same two it carries on the tenant-level list, and the seven columns below are the same seven as well.

ColumnDescription
NameName of the secret. Sortable.
Secret TypeThe secret's type, rendered verbatim — for example ENVIRONMENT VARIABLE, AWS ACCESS SECRET KEY PAIR, or DATABRICKS UNITY TOKEN.
Created ByUser who created the secret. Sortable.
Modified ByUser who last modified the secret. Sortable.
Created TimeCreation timestamp. Sortable.
Modified TimeLast-modification timestamp. Sortable.
ActionsKebab menu with exactly two entries — Edit and Delete.