This page explains how to configure this feature, for user-specific docs, please refer to this page.
Leveraging OpenID Connect (OIDC) protocol, users can login to Galaxy using their identity on Okta Infrastructure (AAI), without having to (explicitly) create a Galaxy user account. To enable this feature on your Galaxy instance, you would need to first register you Galaxy instance as an OIDC relying party (RP, or client) with your organization's Okta, and then use your registration information to configure Galaxy. These steps are described in details in the following sections.
Take the following steps to register your Galaxy instance (RP) to an Okta dev environment:
- Create a Okta developer account, if you do not already have it.
Login to your Okta developer account's admin panel and register a new application.
- Set the "Base URI", "Login redirect URIs", "Logout redirect URIs", "Group assignments" and "Grant type allowed.
- Click the green "Done" button at the bottom and make a note of all
the generated credentials that is made available to you. The
Client Secretfields will be used to configure Galaxy, and
Client Configuration URLand
Registration Access Tokenwill be needed to access the client registration in future.
- Use the returned information to setup Galaxy to receive authentication requests using Okta!
You would need to setup your Galaxy instance to leverage OIDC protocol.
This setup is common for all OIDC IdPs, and is
documented at this page.
Then you would need to add Okta-specific setters to the
matching the values you got from the client registration process, as well as the exact same
redirect_uri you specified (depending on your setup):
<?xml version="1.0"?> <OIDC> <provider name="Okta"> <client_id> ... </client_id> <client_secret> ... </client_secret> <redirect_uri>http://localhost:8080/authnz/okta/callback</redirect_uri> <api_url>https://organization.okta.com/oauth2</api_url> </provider> </OIDC>
Having set this configuration, restart Galaxy to have the option of login to Galaxy with your organization's Okta identity: