Organizations
The Organization feature in VergeCloud allows users to collaborate in teams with clearly defined roles and access scopes. It serves as the foundational unit for managing access, billing, and user permissions across all VergeCloud services.
Overview
By default, every VergeCloud user starts with a personal organization. This is a private space that only the user can access. To collaborate with others, users can create an organization and invite team members with specific roles and access areas.
Organizations are essential for managing:
- Team-based access control across all VergeCloud services
- Centralized API key management
- Billing, plans, and payment methods
- Activity logs and security tracking
Creating an Organization
To create an organization:
- Navigate to the Organization section from the sidebar.
- If no organization exists, click "Create Organization."
- After creating an organization, you’ll become its Owner, with full access to invite others, configure settings, and manage usage.
Once an organization is created, additional features become available, such as:
- Members List
- API Keys
- Settings and Notification Preferences
- Audit and Activity Logs
Roles and Access
- Owners have full administrative control and can manage billing, invite users, and assign roles.
- Invited users gain access according to the roles and scopes assigned to them by an owner or admin.
- All invited users operate within the boundaries of their roles (e.g., Read-Only Admin, Security Manager).
Each role has predefined permissions that cannot be customized. Users with appropriate roles can also invite others, following the principle of delegated access.
Benefits of Using Organizations
- Collaboration: Easily manage teams, assign responsibilities, and track usage.
- Security: Define strict access controls with scopes and roles.
- Centralized Billing: Manage all billing and plan-related settings in one place.
- Scalability: Organizations support growth by allowing flexible role assignment and access expansion.
Considerations
- Email-based access: All user invitations are tied to unique email addresses and cannot be updated after sending.
- One user, multiple orgs: A user can belong to multiple organizations and switch between them from the sidebar selector.
- Initial setup: Creating an organization is a one-time action to unlock advanced team features.