Skip to content



User-definitions in Auth0 is out of scope for this guide. Add them directly in Auth0 database, use an enterprise registry, or "social login". Note: all users have access to all Auth0 defined apps unless you restrict access via configuration - keep this in mind if argo is exposed on the internet or else anyone can login.

Registering the app with Auth0

Follow the register app instructions to create the argocd app in Auth0. In the app definition:

  • Take note of the clientId and clientSecret values.
  • Register login url as https://your.argoingress.address/login
  • Set allowed callback url to https://your.argoingress.address/auth/callback
  • Under connections, select the user-registries you want to use with argo.

Any other settings are non-essential for the authentication to work.

Adding authorization rules to Auth0

Follow Auth0 authorization guide to setup authorization. The important part to note here is that group-membership is a non-standard claim, and hence is required to be put under a FQDN claim name, for instance http://your.domain/groups.

Configuring argo

Configure OIDC for ArgoCD

kubectl edit configmap argocd-cm

  url: https://your.argoingress.address
  oidc.config: |
    name: Auth0
    issuer: https://<yourtenant>.<eu|us>
    clientID: <theClientId>
    clientSecret: <theClientSecret>
    domain_hint: <theDomainHint>
    - openid
    - profile
    - email
    # not strictly necessary - but good practice:
    - 'http://your.domain/groups'

Configure RBAC for ArgoCD

kubectl edit configmap argocd-rbac-cm (or use helm values).

  policy.csv: |
    # let members with group someProjectGroup handle apps in someProject
    # this can also be defined in the UI in the group-definition to avoid doing it there in the configmap
    p, someProjectGroup, applications, *, someProject/*, allow
    # let the group membership argocd-admins from OIDC become role:admin - needs to go into the configmap
    g, argocd-global-admins, role:admin
  policy.default: role:readonly
  # essential to get argo to use groups for RBAC:
  scopes: '[http://your.domain/groups, email]' 

Storing Client Secrets

Details on storing your clientSecret securely and correctly can be found on the User Management Overview page.