Organisation administration · Public
Tenant permissions reference
Every IAM permission name, the pages it controls, and how wildcards and delegation limits work in practice.
Tenant permissions control what a member can do inside IAM. They attach to memberships, not to the ONE ID itself. When your account belongs to several tenants, permissions apply only to the tenant you have selected.
Roles are reusable permission templates. A member's effective access is the union of locked permissions from their assigned role plus any additional permissions added directly on the membership. See Tenant roles for how role assignment, locked grants, and role editing work.
View and edit grants
- Sign in and open IAM → Members.
- Select a member to open their permissions page. You need
iam:permissions:viewto read the list. - Change the member's role or add extra permissions with
iam:permissions:manage. - Remove unlocked extra permissions with
iam:permissions:delete, subject to the delegation rules below.
Permissions describe access. A member needs the right permission even when their role name sounds administrative.
How matching works
ONE checks permissions hierarchically. Permission names use colons as separators.
Some IAM routes also require a tenant type. A commercial tenant member cannot open enterprise-only pages even with the right permission name.
| Grant | Covers |
|---|---|
* |
Every tenant permission. |
| Exact name | Only that permission, such as iam:members:view. |
| Prefix wildcard | iam:* covers iam:members:view, iam:permissions:manage, iam:edit, and iam:import. |
| Namespace | iam alone covers any permission whose name starts with iam:. |
Delegation rules
Administrators can only grant permissions they already hold. When editing another member, you can add a permission only if your own membership includes that permission or a broader wildcard that covers it.
You can manage a member only when every permission on their membership is within your own grants. That includes locked permissions from the member's role and any additional permissions. That prevents handing out access you do not have yourself.
Passkey administration has the same delegation limit and also respects owner status. You cannot remove passkeys from a primary owner unless you are the primary owner, and you cannot manage members on the Owner role unless your own membership also has the Owner role.
The same limits apply when you edit role templates, create invites, import members from CSV, or run bulk actions on the members list:
- You can add a permission to a role only if you already hold it.
- You can remove a permission from a role, from an invite, or from a member only if you already hold it.
- You can assign a role only if every permission on that role is within your own grants.
- You can bulk-remove, bulk-assign a role, or bulk-add a permission only when you could perform that same action on each selected member individually.
Bulk actions cannot include your own membership, cannot remove the primary owner, and cannot move the primary owner off the Owner role.
Owners created during tenant setup receive the default Owner role with * automatically. Narrow that access by creating custom roles when you want separation of duties.
Permission values
Each permission record has an optional value. ONE stores the value and exposes it through CAS and SAPP, but IAM route checks look at the permission name only.
Use values when a connected application needs extra context, such as a scope label or feature flag. Values do not replace a missing permission name.
Full permission reference
Members
iam:members:manage is required to delete a membership. iam:edit and iam:import are separate enterprise paths for adding people in bulk or one at a time.
| Permission | Tenant types | What it allows |
|---|---|---|
iam:members:view |
Enterprise, commercial | Open the members list and see who belongs to the tenant. |
iam:members:manage |
Enterprise, commercial | Remove members from the tenant. Edit a member's profile from their permissions page, including password and Google Workspace sync when permitted. Bulk-remove selected members from the members list. |
iam:edit |
Enterprise | Create members through the new-member form. |
iam:import |
Enterprise | Import members from CSV. Updates existing members and creates new ones. |
Permissions administration
| Permission | Tenant types | What it allows |
|---|---|---|
iam:permissions:view |
Enterprise, commercial | Open a member's permissions page and read their grants. |
iam:permissions:manage |
Enterprise, commercial | Assign roles, add permissions to a member, and add extra permissions on invites. Bulk-assign a role or bulk-add a permission from the members list. |
iam:permissions:delete |
Enterprise, commercial | Remove unlocked extra permissions from a member. Role permissions cannot be removed here. |
Roles
Viewing the permissions page requires iam:permissions:view. Adding or removing rows on that page needs the matching manage or delete grant, plus the delegation rules above.
| Permission | Tenant types | What it allows |
|---|---|---|
iam:roles:edit |
Enterprise, commercial | Open IAM → Roles, create and rename custom roles, edit role permission templates, and delete unused custom roles. |
Security administration
iam:2fa manages passkey enforcement and subordinate passkey cleanup. It does not let an administrator register a passkey for someone else; passkey enrollment still requires the member's own device and browser ceremony.
Passkey enforcement can be configured in three scopes:
- Tenant-based: every member of the tenant must enroll a passkey. Configure this on the Passkeys tab in IAM → Organisation.
- Role-based: members assigned selected roles must enroll a passkey. Configure this on each role's edit page in IAM → Roles.
- Permission-based: members whose effective grants include selected permissions must enroll a passkey. Configure this on the Passkeys tab using the same permission catalog and delegation rules as role and member permission management.
When enforcement applies to a member who has no passkeys, ONE lets them sign in with their password and then routes them through passkey enrollment on auth.skyfallen.one or the organisation's custom hostname when custom domain is enabled. SAML and CAS authorisation are blocked until enrollment is complete. When enforcement applies and the member already has passkeys, enterprise sign-in requires the passkey step after the password step.
| Permission | Tenant types | What it allows |
|---|---|---|
iam:2fa |
Enterprise, commercial | Configure tenant, role, and permission based passkey enforcement. View and remove passkeys from subordinate members when delegation and owner-status checks allow it. |
Invites
| Permission | Tenant types | What it allows |
|---|---|---|
iam:invites:view |
Enterprise, commercial | Open the invites list and review outstanding invitations. |
iam:invites:manage |
Enterprise, commercial | Create invites, send them, and revoke invites before they are accepted. |
Workforce portal
| Permission | Tenant types | What it allows |
|---|---|---|
iam:apps |
Enterprise | Manage workforce portal apps and custom links: add or remove apps, upload icons, reorder the portal, and maintain link entries. |
Google Workspace
connections:google is enough to connect or disconnect. Sync and provisioning need connections:google:manage and an active connection.
| Permission | Tenant types | What it allows |
|---|---|---|
connections:google |
Enterprise | Open the Google Workspace connection page, start OAuth, complete the callback, and disconnect the integration. |
connections:google:manage |
Enterprise | Run directory sync. Provision or update Google users when creating or editing members. See Google Workspace status on the members list. |
Branding
| Permission | Tenant types | What it allows |
|---|---|---|
branding:edit |
Enterprise | Edit Workforce Identity branding: sign-in copy, default language, portal text, logo, and sign-in background. |
Account
| Permission | Tenant types | What it allows |
|---|---|---|
profile:email:edit |
Enterprise | Change the primary email address on the account Security page at my. Without this grant, the field stays read-only. The new address must use one of the organisation's verified domains and pass the same managed-domain checks used at sign-up. |
Tenant
| Permission | Tenant types | What it allows |
|---|---|---|
tenant:manage |
Enterprise, commercial | Open Organisation in IAM, review tenant details, change billing and technical contacts, manage lookup by email and password reset settings, and view executed legal agreements for the tenant. Passkey enforcement is configured separately on the Passkeys tab and on role edit pages, and requires iam:2fa. |
domains:manage |
Enterprise | Open Domains in IAM, add tenant domains, choose verification methods, change the primary tenant namespace, and retire non-primary domains. |
Legal agreements
Executed agreements open on the legal portal at the same URL used during signing. The document, attestations, signature, and audit fields appear in a locked read-only layout. Signing is required during tenant setup or when Skyfallen publishes a new revision.
The primary owner can transfer ownership without tenant:manage. Most organisation fields stay locked; use Request Help on that page to ask Skyfallen to change legal, registration, Workforce Identity, vanity domain, or SSO management settings.
The primary owner always keeps the * permission. ONE blocks removing * from the primary owner and restores it automatically when ownership transfers.
| Action | Who |
|---|---|
| Open Agreements in IAM and view executed agreements on the legal portal | Member with tenant:manage, or the member who signed the agreement (regardless of role or other permissions) |
| Sign pending agreements | Primary owner only |
Connected applications
| Permission | Tenant types | What it allows |
|---|---|---|
cas:auth |
Enterprise, commercial | Sign in to CAS connected applications and grant consent during the browser authorization flow. |
saml:auth |
Enterprise | Complete SAML service provider sign-in through Workforce Identity. |
SSO application management
Both permissions require the corresponding tenant feature toggle (Manage CAS Apps or Manage SAML Apps) to be enabled by Skyfallen administration.
| Permission | Tenant types | What it allows |
|---|---|---|
cas:manage |
Enterprise | Create, edit, and delete CAS applications from IAM when the tenant has CAS management enabled. |
saml:manage |
Enterprise | Create, edit, and delete SAML service provider applications from IAM when the tenant has SAML management enabled. |
Wildcard shortcuts
These broad grants are common in CSV imports and manual administration.
Combine narrower grants when you want read-only or operations-only access. For example, iam:members:view with iam:invites:view lets someone audit membership and invitations without changing either.
| Grant | Typical use |
|---|---|
* |
Full tenant administration. Default for owners at setup. |
iam:* |
All IAM permissions, including members, permissions, roles, invites, edit, and import. |
connections:google:* |
View the connection page and run sync or provisioning. |
Outside IAM
CAS sessions and SAPP membership reads return the member's role identifier, role name, and permission names as stored on the membership. Connected applications enforce their own rules against that list. See Tenant roles for the role fields returned by each API.
Custom permission names are valid. ONE will store them, include them in API responses, and apply them to IAM only when they match a name in this reference.