Skip to main content

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

  1. Sign in and open IAM → Members.
  2. Select a member to open their permissions page. You need iam:permissions:view to read the list.
  3. Change the member's role or add extra permissions with iam:permissions:manage.
  4. 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.

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.

English