Okera Portal UI Basics

The Okera Portal UI is the browser-based interface used for:

• Viewing your account information
• Finding and understanding datasets
• Getting Started with using a dataset
• Inspecting roles and checking permissions on any dataset

Tip

For advanced administrator features, see UI for Admins

Accessing the UI

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

Supported Browsers

The Okera UI 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 UI. The Login screen is configured to provide login options depending on your cluster configuration. These options include:

• Log in with credentials

  Select this option to authenticate using LDAP credentials. You can then enter your username and password. See Authenticate Using Lightweight Directory Access Protocol (LDAP).

• Log in with token

  Select this option to authenticate with JSON Web Tokens (JWTs). You will be prompted for the access token. See Authenticate Using JSON Web Tokens.

• Log in with OAuth

  Select this option to authenticate with OAuth. See Authenticate Using Open Authorization (OAuth).

• Log in with SAML

  Select this option to authenticate with SAML. See Authenticate Using Security Access Markup Language (SAML).

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 UI to be accessible to your browser. If, upon navigating to the UI, 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 UI 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 UI

Once you are logged in, the UI 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.

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.

System Information

The System item in the main navigation opens a page displaying the following information about your Okera cluster:

• UI version
• build hash
• Planner version
• Planner host/port
• Presto Endpoint
• JDBC URL (You can download the Okera Presto JDBC driver by selecting the Download JDBC driver link.)
• REST API endpoint
• authentication methods available

Copying Your Access Token

To obtain your access token, click your username at the bottom of the navigation menu and select Copy access token.

Logging Out

To logout, click your username and select 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.