Run Commands


Learn how to authenticate with Okta.

If Okta® access management software is your preferred choice of IdP, you can configure Pachyderm to use Okta as an OpenID Connect (OIDC) identity provider using the following steps.


Before you can configure Pachyderm to work with Okta, log in or create an account at

Register Pachyderm with Okta #

For more detailed step by step instructions, follow this documentation.

  1. Sign in to your Okta organization with your administrator account.

  2. From the Admin Console side navigation, click Applications > Applications.

  3. Click Add Application.

  4. Click Create New App (or search for your existing app).

  5. Select Platform: Web and sign-on method OpenID Connect.

  6. Click Create.

  7. Type the name of your application, such as Pachyderm.

  8. Add the following Login redirect URI.


    Note: Your port number should be whatever is routing to the Identity Service:658.

    The IP address is the address of your Pachyderm host. For example, if you are running Pachyderm in Minikube, you can find the IP address by running minikube ip.

  9. Click Save

  10. Click Edit to change the General Settings pane. In the Allowed grant types section, enable Authorization Code and Refresh Token.

  11. Click Save

  12. On the Assignments tab, click Assign to assign the app integration to any user or group in your org. Click Done when the assignments are complete.

Set up an create an Idp-Pachyderm connector #

After you have configured a Pachyderm application in Okta, you need to create an OIDC connector config file with the Okta parameters. All the required parameters, such as client_id, client_secret, and others, are located on the App General tab.

To configure Pachyderm Auth, complete the following steps:

  1. Go to the terminal and forward the pachd pod to the OIDC port:

    1. Get the pachd pod ID:

      kubectl get pod

      Example system response:

      pachd-79f7f68c65-9qs8g      1/1     Running   0          4h2m
    2. Forward the pachd pod to the OIDC port:


      kubectl port-forward pachd-79f7f68c65-9qs8g 30657
  2. Enable Pachyderm authentication:

    pachctl auth activate --initial-admin=robot:admin

    Pachyderm returns a token.

    WARNING! You must save the token to a secure location to avoid being locked out of your cluster.

  3. Log in as the admin user with the token you received in the previous step:

    pachctl auth use-auth-token
  4. Set up the authentication config:

    pachctl auth set-config <<EOF
      "live_config_version": 2,
      "id_providers": [{
      "name": "okta",
      "description": "oidc-based authentication with Okta",
      "issuer": "https://",
      "client_id": "",
      "client_secret": "",
      "redirect_uri": "your redirect URI",
      ignore_email_verified: true

    You need to replace the following placeholders with relevant values:

    • issuer — The domain of your application in Okta. For example, {yourOktaDomain}/. Note the trailing slash.

    • client_id — The Pachyderm Client ID in Okta.

    • client_secret - The Pachyderm client secret in Okta.

    • redirect_uri - This parameter should match what you have added to redirect URI in the previous step.

  5. Log in as the user you have created in the Pachyderm application or sign in with Google:

    1. Run:

      pachctl auth login

      You should be prompted to a web-browser. Log in as the user you have previously created in Okta or sign in with Google.

    You should see the following message printed out in your browser:

    You are now logged in. Go back to the terminal to use Pachyderm!
  6. In the terminal, check that you are logged in as the Okta user:

    pachctl auth whoami

    Example of System Response:

    You are ""
    session expires: 07 Aug 20 14:04 PDT