Okera Portal Basics¶

The Okera Portal (formerly Web UI) is the browser-based interface used for:

Viewing your account information
Finding and understanding datasets
Getting Started with using a dataset
Checking permissions on any dataset

Tip

For advanced administrator features, see Portal for Admins

Accessing the Portal¶

To access the Portal, browse to the URL provided by your Okera administrator.

Supported Browsers¶

The Okera Portal is supported on the latest versions of the following browsers:

Google Chrome
Mozilla Firefox
Microsoft Edge
Apple Safari

Logging In¶

Use the Login screen to access the Portal. The Login screen is configured to provide login options depending on your cluster configuration. The login options include:

token login

Authenticate with Okera, JWT, and SSO tokens.
username/password login

Authenticate using LDAP credentials.
OAuth login

Authenticate with OAuth.

Okera Login Screen
Example login screen with Active Directory and Token login

A note on SSL¶

If Okera is configured to run with SSL enabled using a self-signed certificate, the SSL certificate must be setup on your local system for the Portal to be accessible to your browser. If, upon navigating to the Portal, the browser warns that the site is not trusted, the SSL certificate may need to be installed.

Please note that even if you bypass your browser's certificate warning, the Okera Portal will likely continue to not work, with the Login screen reporting this message:

Could not contact server. Check your network connection and try again later.

If you see this message, it could mean you need to install the SSL certificate. Contact your Okera administrator.

Using the Portal¶

Once you are logged in, the Portal starts you off in your Okera Home page. From here, you can directly access most of your options.

You will see a quick access list of your recently starred datasets and your user tags. Clicking on one of the tags opens a list of your datasets with that tag.

Okera Home Page

Account Details¶

The Home page shows your account information:

your Okera username
the groups you belong to
the roles you have been granted
the groups granting you those roles
your access token, including expiry information

Tip

You can use Ctrl+F or Cmd+F (Mac) to quickly find a group or role name.

A modal is triggered by the About link at the top right corner next to your username.

Okera About Dialog

This dialog displays information about your Okera cluster:

UI version
build hash
Planner version
Planner host/port
Presto Endpoint
JDBC URL
REST API endpoint
authentication methods available

Copying Your Access Token¶

There are two places you can readily find your access token. It is available on your Home screen, or from any screen by way of the user menu (your username in the upper-right corner).

Click Copy adjacent to the access token on your home screen.

Okera Home Page with access token highlighted

Or choose the Copy Access Token menu option revealed by clicking your username.

Logging Out¶

To logout, click your username in the upper right part of the screen. Then click Logout.

Warning

Your credentials are saved in the browser until either your token expires, or you explicitly log out. Be aware of this security issue when sharing access to your computer.