How Access Is Assigned in Cortx OS

Overview

Access in Cortx OS is resolved through a layered and deterministic model that separates authentication from authorization. While Identity Providers control how users are onboarded, access within the platform is governed through permissions, permission sets, roles, and user groups.
This model ensures that access is consistent, scalable, and auditable across the organization.

Access Resolution Flow

Access in Cortx OS is determined in the following order:

User → User Group → Role → Permission Set → Permissions → Effective Access

Each layer builds on the previous one to compute what a user can ultimately see and do within the platform.

How It Works

  • A user is onboarded into Cortx OS through an Identity Provider.

  • The user is added to one or more User Groups.

  • Roles are assigned to User Groups.

  • Each Role is composed of one or more Permission Sets.

  • Permission Sets contain individual Permissions defining allowed actions.

  • Cortx OS evaluates all applicable roles and permissions to determine the user’s effective access.

Managing Access

  • Access changes are made by updating User Groups, Roles, or Permission Sets.

  • Changes automatically propagate to all affected users.

  • Direct user role assignments can be used for exceptions.

  • Access is recalculated dynamically without manual intervention.

Best Practices

  • Assign access primarily through User Groups, not individual users.

  • Keep Permission Sets focused and reusable.

  • Avoid overlapping or conflicting roles.

  • Review access periodically to enforce least-privilege principles.

  • Separate identity onboarding from access authorization responsibilities.

Troubleshooting

Issue: User access does not match expectations
  • Resolution: Review:

    • User Group membership

    • Assigned Roles

    • Attached Permission Sets

    • Included Permissions

Following the access resolution order helps quickly identify where mismatches occur.

Was this article helpful?

On this page