Skip to content

Conversation

@kushalshit27
Copy link
Contributor

@kushalshit27 kushalshit27 commented Nov 14, 2025

TODO: update node sdk released version

🔧 Changes

Add support for Connection Profiles and Express Configuration on Clients

  • Connection Profiles: Added new resource type connectionProfiles to manage application-specific configurations for use with the OIN Express Configuration feature
  • Express Configuration on Clients: Extended the clients schema to support the new express_configuration property

Examples

YAML format

Connection Profile:

connectionProfiles:
  - name: "Enterprise SSO Profile"
    organization:
      show_as_button: "required"
      assign_membership_on_login: "required"
    connection_name_prefix_template: "org-{organization_name}"
    enabled_features:
      - scim
      - universal_logout
    strategy_overrides:
      samlp:
        enabled_features:
          - universal_logout
      oidc:
        enabled_features:
          - scim
          - universal_logout

Client with Express Configuration:

clients:
  - name: "My Enterprise App"
    app_type: "regular_web"
    express_configuration:
      initiate_login_uri_template: "https://myapp.com/sso/start?org={organization_name}&conn={connection_name}"
      user_attribute_profile_id: "uap_xxxxxxxxxxxx"
      connection_profile_id: "cp_xxxxxxxxxxxx"
      enable_client: true
      enable_organization: true
      okta_oin_client_id: "0oa_xxxxxxxxxxxx"
      admin_login_domain: "login.myapp.com"
      linked_clients:
        - client_id: "client_id_of_mobile_app"

JSON format

Connection Profile:

{
  "name": "Enterprise SSO Profile",
  "organization": {
    "show_as_button": "required",
    "assign_membership_on_login": "required"
  },
  "connection_name_prefix_template": "org-{organization_name}",
  "enabled_features": ["scim", "universal_logout"],
  "strategy_overrides": {
    "samlp": {
      "enabled_features": ["universal_logout"]
    },
    "oidc": {
      "enabled_features": ["scim", "universal_logout"]
    }
  }
}

📚 References

  • TODO

🔬 Testing

  • unit test added

📝 Checklist

  • All new/changed/fixed functionality is covered by tests (or N/A)
  • I have added documentation for all new/changed functionality (or N/A)

- docs/resource-specific-documentation.md: add documentation for connection profiles and their properties
- examples/yaml/tenant.yaml: include connection profiles in tenant configuration example
- src/context/directory/handlers/index.ts: register connectionProfiles handler
- src/context/yaml/handlers/index.ts: register connectionProfiles handler
- src/tools/auth0/handlers/clients.ts: add express_configuration properties for connection profiles
- src/tools/auth0/handlers/index.ts: register connectionProfiles handler
- src/tools/constants.ts: add CONNECTION_PROFILES_DIRECTORY constant
- src/types.ts: extend Assets and AssetTypes to include connectionProfiles
- examples/directory/connection-profiles/Basic Connection Profile.json: add basic connection profile example
- examples/directory/connection-profiles/Enterprise SSO Profile.json: add enterprise SSO profile example
- src/context/directory/handlers/connectionProfiles.ts: implement connectionProfiles handler for directory context
- src/context/yaml/handlers/connectionProfiles.ts: implement connectionProfiles handler for YAML context
- src/tools/auth0/handlers/connectionProfiles.ts: implement connectionProfiles handler for Auth0 API
@kushalshit27 kushalshit27 changed the title feat: add connection profiles support feat: support new connection-profiles and express-configuration property on clients Nov 14, 2025
@kushalshit27 kushalshit27 changed the title feat: support new connection-profiles and express-configuration property on clients feat: Add support for Connection Profiles and Express Configuration on Clients Nov 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants