Tenant-only verification is a security feature for that keeps user verification separate for each workspace when provisioning users through SCIM and Ziflow API.
When a user is verified in one workspace, that verification only applies to that workspace. The user is not automatically verified in other workspaces associated with the same email address. It helps prevent unintended access between workspaces while continuing to support existing authentication methods such as SSO, MFA, Auth0, and social login providers.
With Tenant-only verification:
- Cross-workspace access is not automatically inherited.
- API-created memberships begin in a restricted state.
- Proof visibility is filtered until the user verifies themselves.
- Full workspace access is granted only after the user clicks a workspace-specific confirmation email or signs up directly through a trusted identity provider.
- Each workspace operates independently.
Authentication
Tenant-only verification does not replace or modify authentication methods. The feature only limits the scope of a verification event.
Tenant-only verification does not change:
- Auth0 authentication
- SSO
- MFA
- Password authentication
- Google or OAuth sign-in
- Workspace role permissions
Workspace access
Workspace access can exist in two states:
| State | Description |
|---|---|
| Narrow scope | Workspace access was verified through the API. Proof visibility is restricted until the user activates the workspace themselves. |
| Full scope | The user activated the workspace access directly through email confirmation or social signup. Full access applies only to that workspace. |
How workspace access is activated
Users can get workspace access in three ways.
API verification
A Ziflow administrator marks a user as verified through the public API (verified = true).
Result:
- The user becomes verified only for that workspace.
- Proof access remains restricted.
- Other workspaces are unaffected.
- The user still must activate the workspace themselves through email confirmation.
The API cannot directly grant full workspace access.
Email confirmation link
A user clicks a verification email tied to a specific workspace.
Result:
- Access to that workspace is activated.
- Other workspaces remain unchanged.
- Each additional workspace requires its own email and confirmation step.
Social identity provider signup
A user signs up through a trusted identity provider such as Google OAuth.
Result:
- The user's workspace access starts in full scope.
- The user's existing workspace access in other workspaces do not change.
- Other workspaces still require separate activation.
User scenarios
Tenant-only verification affects existing Ziflow users who already have access to one or more workspaces and are one of the following:
- Invited through the API with
verified: true - Added through SCIM provisioning
Scenario: Invited team member
- An admin invites a user to Workspace A.
- The user receives a confirmation email.
- The user clicks the confirmation link.
- The user resets their password if required.
Result:
- The user receives full access to Workspace A only.
- Any workspace access in other workspaces remain restricted until separately activated.
Scenario: API-created membership
- An admin verifies a user through the public API.
- The user's workspace access becomes verified in restricted scope.
Result:
- Proof access remains filtered.
- The user must still activate their workspace access in their Ziflow profile.
Scenario: Google signup
- A user signs up using Google OAuth.
- A new workspace is created.
Result:
- The user's new workspace access starts in full scope.
- The user's existing workspace access in other workspaces remain unchanged.
Scenario: User added to another workspace during an active session
- A user is already signed in to Workspace A.
- An admin adds the same user to Workspace B.
- The application displays a Verify prompt.
- The user requests a verification email.
- The user clicks the email confirmation link.
Result:
- Workspace B becomes fully activated only after email confirmation.
Common questions about Tenant-only verification
| Question | Answer |
|---|---|
| Will existing users lose access? | No. Existing workspace access remain unchanged. |
| Will users need to re-verify? | No. Only new verification events use the stricter behavior. |
| Does this affect SSO or MFA? | No. Authentication systems are unchanged. |
| Does activating one workspace unlock others? | No. Each workspace must be activated separately. |
Comments
0 comments
Please sign in to leave a comment.