---
title: Integrating Kargo with Okta on Akuity Platform
description: Different methods for configuring Okta SSO with Kargo when deploying through the Akuity Platform
---

[Skip to content](https://support.akuity.io/kb/reducing-namespace-event-ttl-and-its-impact-on-argo-cd#main-content)

English

Show submenu for translations

[![Akuity-Logo-Color-1](https://support.akuity.io/hubfs/Akuity-Logo-Color-1.svg)](https://akuity.io/)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.akuity.io/kb?hsLang=en)
2. [Kargo](https://support.akuity.io/kb/kargo?hsLang=en)
3. [Configuration](https://support.akuity.io/kb/kargo?hsLang=en#configuration)

# Integrating Kargo with Okta on Akuity Platform

## Different methods for configuring Okta SSO with Kargo when deploying through the Akuity Platform

When Kargo is deployed through the Akuity Platform, direct access to Helm charts or `values.yaml` is not available. However, Okta SSO integration is still fully supported through multiple methods.

**Options for Configuring Okta with Kargo**

**1. UI Configuration (Recommended for Most Users):**  
SSO integration with Okta can be added directly via the Akuity UI under **Kargo \> Settings \> Access**. This method is straightforward and does not require Terraform or file editing.

**2. Declarative Specs (For GitOps Users):**  
A declarative approach is supported using the [Akuity Declarative Specs](https://docs.akuity.io/reference/declarative-specs/kargo-spec). This allows defining the full configuration, including OIDC settings, in YAML.

To export the current configuration and modify it:

`akuity kargo export --organization-name <org-name> <kargo-instance-name>`

Example output includes:

`apiVersion: kargo.akuity.io/v1alpha1`  
`kind: Kargo`  
`metadata:`  
`  name: kargo-akuity`  
`spec:`  
`  oidcConfig:`  
`    dexConfig: |-`  
`      connectors:`  
`      - type: saml`  
`        id: okta`  
`        name: OKTA`  
`        config:`  
`          ssoURL: https://<your-okta-sso-url>`  
`          redirectURI: https://<your-kargo-subdomain>.kargo.akuity.cloud/dex/callback`  
`          usernameAttr: name`  
`          emailAttr: email`  
`          groupsAttr: group`  
`          caData: <your-cert>`  
`    dexEnabled: true`

> **Note:** The declarative method may not be supported on certain platform versions. A fix is under development to expand compatibility for older Kubernetes versions.

**3. Terraform Integration (Advanced Users):**  
Terraform can also be used to manage Kargo instances and SSO configurations. See the [Terraform provider documentation](https://registry.terraform.io/providers/akuity/akp/latest/docs/resources/kargo%5Finstance) for examples and supported fields.

#### Reference:

The latest instructions for configuring Kargo SSO on the Akuity Platform can be found here:  
[https://docs.akuity.io/kargo/Settings/access/oidc-config](https://docs.akuity.io/kargo/Settings/access/oidc-config)

- [Argo CD](https://support.akuity.io/kb/argo-cd?hsLang=en#main-content)

    - [App of Apps](https://support.akuity.io/kb/argo-cd?hsLang=en#app-of-apps)
    - [Configuration](https://support.akuity.io/kb/argo-cd?hsLang=en#configuration)
    - [ApplicationSet](https://support.akuity.io/kb/argo-cd?hsLang=en#applicationset)
- [Akuity Platform](https://support.akuity.io/kb/akuity-platform?hsLang=en#main-content)

    - [Audit Logs](https://support.akuity.io/kb/akuity-platform?hsLang=en#audit-logs)
    - [IP Allow Lists](https://support.akuity.io/kb/akuity-platform?hsLang=en#ip-allow-lists)
    - [Terraform](https://support.akuity.io/kb/akuity-platform?hsLang=en#terraform)
    - [Configuration](https://support.akuity.io/kb/akuity-platform?hsLang=en#configuration)
    - [Agents](https://support.akuity.io/kb/akuity-platform?hsLang=en#agents)
    - [Troubleshooting](https://support.akuity.io/kb/akuity-platform?hsLang=en#troubleshooting)
- [Kargo](https://support.akuity.io/kb/kargo?hsLang=en#main-content)

    - [Configuration](https://support.akuity.io/kb/kargo?hsLang=en#configuration)
    - [Warehouses](https://support.akuity.io/kb/kargo?hsLang=en#warehouses)
    - [Metrics](https://support.akuity.io/kb/kargo?hsLang=en#metrics)
- [Self-hosted Akuity Platform](https://support.akuity.io/kb/self-hosted-akuity-platform?hsLang=en#main-content)

    - [Configuration](https://support.akuity.io/kb/self-hosted-akuity-platform?hsLang=en#configuration)

[![Akuity-Logo-Color-1](https://support.akuity.io/hubfs/Akuity-Logo-Color-1.svg "Akuity-Logo-Color-1")](https://akuity.io/)

Akuity.io Help Center

Copyright © 2025, Akuity Inc.