SSO Permissions Mapping

This feature requires Quilt stack version 1.54.0 or higher

Overview

This feature allows Quilt admin to configure what roles and admin flag value are assigned to the user who logs in via SSO based on the user's ID token claims.

The configuration can be set with quilt3.admin.sso_config.set() or with admin UI.

admin UI for setting SSO permissions mapping

Note: Roles used by configuration can't be removed or renamed.

Note: The user who sets the configuration will never have their admin flag revoked.

Note: After configuration is set, any user who logs in via SSO can't be manually assigned roles or admin permissions.

Configuration

The configuration file is to be written in YAML and is defined by this JSON Schema which includes descriptions of all the fields.

Warning: In schemas don't forget to add claims you want to check to required, because otherwise the schema will match any ID token even if these claims are missing.

Example

version: "1.0"
default_role: ReadQuiltBucket
mappings:
  - schema:
      type: object
      properties:
        email:
          const: [e-mail]
      required:
        - email
    roles:
      - ReadWriteQuiltBucket
    admin: true
  - schema:
      type: object
      properties:
        groups:
          type: array
          contains:
            const: rw
      required:
        - groups
    roles:
      - ReadWriteQuiltBucket

1. user with email [e-mail] will have ReadWriteQuiltBucket role and admin flag set to true

2. user with group rw will have ReadWriteQuiltBucket role and admin flag set to false (except the user with [e-mail] email)

3. all other users will have ReadQuiltBucket role

Note: Unrecognized users will have their role set to the default_role, but their admin flag will be unchanged.