Skip to content

Latest commit

 

History

History
72 lines (55 loc) · 3.43 KB

create-okta-client.md

File metadata and controls

72 lines (55 loc) · 3.43 KB

Create An Application in Okta

Introduction

This example uses an Okta development account to create an application that will represent a Hopsworks client in the identity provider.

Prerequisites

Okta development account. To create a developer account go to Okta developer.

Step 1: Register Hopsworks as an application in your identity provider

After creating a developer account register a client by going to Applications and click on Create App Integration.

Okta Applications

Okta Applications

This will open a popup as shown in the figure below. Select OIDC as Sign-in-method and Web Application as Application type and click next.

Create New Application

Create new Application

Give your application a name and select Client credential as Grant Type. Then add a Sign-in redirect URI that is your Hopsworks cluster domain name (including the port number if needed) with path /callback, and a Sign-out redirect URI that is Hopsworks cluster domain name (including the port number if needed) with no path.

New Application

New Application

If you want to limit who can access your Hopsworks cluster select Limit access to selected groups and select group(s) you want to give access to. Here we will allow everyone in the organization to access the cluster.

Group assignment

Group assignment

Group mapping

You can also create mappings from groups in Okta to groups in Hopsworks. To achieve this you need to configure Okta to send Groups with user information. To do this go to Applications and select your application name. In the Sign On tab click edit OpenID Connect ID Token and select Filter for Groups claim type, then for Groups claim filter add groups as the claim name, select Match Regex from the dropdown and .* (dot star) as Regex to match all groups. See Group mapping on how to do the mapping in Hopsworks.

Group claim

Group claim

Step 2: Get the necessary fields for client registration

After the application is created go back to Applications and click on the application you just created. Use the Okta domain (Connection URL), client id and client secret generated for your app in the Identity Provider registration in Hopsworks.

Application overview

Application overview

!!! note

When copying the domain in the figure above make sure to add the url scheme (http:// or https://) when using it 
in the _Connection URL_ in the [Identity Provider registration form](../create-client).

Conclusion

In this guide you learned how to create a client in your Okta identity provider and acquire a client id and a client secret.