Accounts
Managing teams and organizations
Using team accounts
Adding new users to your Cloud 66 account is a great way to work in a team, and access rights can be fine-tuned per application. Access levels range from no privileges on an application to full administrative privileges.
User roles and permissions
The account administrator is the only user who can invite other members and change access rights for these members (unless this privilege is granted to another user). There are three types of users - Finance users, Application (stack) users and Service Accounts (please read our separate guide on Service Accounts).
Finance users
Finance users only have access to your Payment page, and can change billing information. They will automatically receive email payment notifications (successful and unsuccessful payments) and invoices, but have no access rights to applications.
Finance users need Cloud 66 accounts
A finance user still needs to create a standard Cloud 66 account before they can access records or receive invoices and will be prompted via email to do so if they have not already.
You can also opt to simply cc other email addresses whenever invoices are sent to you. To do this:
- Open your Dashboard
- Click on your account avatar (top-right) and select Account Settings
- Click Organizations in the left-hand panel
- Click on the name of organization you wish to update
- Scroll down to the "Copy invoices to" field and add the addresses (separated by commas)
- Click Save
Application users
Application users have access rights to view and manage applications, and (depending on access level) to manage the entire Cloud 66 account.
There are two levels of permissions:
- Account-level permissions
- Application (AKA stack) level permissions
Account-level permissions
These permissions are focused on global account settings like managing users, adding or removing cloud providers and setting notifications.
To set these permissions for a user:
- Log into your Cloud 66 Dashboard
- Click your avatar and then Account Settings
- Click Teams (under Collaboration)
- Click Manage Team Members
- Click the edit icon next to the user in question
- Check or uncheck permissions as needed
- Click Save Changes
You can also use this page to manage application-level permissions (see below).
Application-level permissions and roles
Every user has a set of permissions explicitly assigned for applications, regardless of their account-level permissions. These are assigned when a user is added. If no permissions are added, the user will have no access to applications. Application permissions are set via roles.
You can specify the exact access rights you would like to grant a user per application by choosing a role for them. The available roles are:
- No role (i.e. not assigned to an app)
- Viewer
- Deployer
- Developer
- Operation
- Power user
- Administrator (has all permissions)
The owner of an account always has the maximum permissions for all applications and does not need to be assigned any roles.
The Administrator role has permissions to everything and the other default roles have the following permissions:
Role / Perms | Viewer | Deployer | Dev | Ops | Power |
---|---|---|---|---|---|
View App | |||||
Deploy App | |||||
Edit App | |||||
Shell to Servers | |||||
Delete App | |||||
App Admin | |||||
View service.yml | |||||
Edit service.yml | |||||
View manifest.yml | |||||
Edit manifest.yml | |||||
View Firewall Rules | |||||
Edit Firewall Rules | |||||
View Network Redirects Settings | |||||
Edit Network Redirects Settings | |||||
View Network Traffic Settings | |||||
Edit Network Traffic Settings | |||||
View ActiveProtect | |||||
View Environment Variables | |||||
Edit Environment Variables | |||||
View App Info | |||||
Edit App Info | |||||
View Deploy History | |||||
Revert Deployment | |||||
Edit Notification Channels | |||||
View Live Logs | |||||
Edit Stack Settings | |||||
Scale Stack | |||||
Download SSH Key | |||||
Download SSL Cert | |||||
Manage Containers | |||||
Access APN |
These roles can be edited, and custom roles can also be created. We recommend creating custom roles rather than editing the defaults. The account owner always has full access to all settings on all applications.
By definition, any user with access to an application will automatically be given the rights for the lower levels of permissions. For example, a user who can deploy an application will also be able to view the same application.
Assigning application roles to a user
To assign a user permissions for an application:
- Log into your Cloud 66 Dashboard
- Click your avatar and then Account Settings
- Click Teams
- Click the edit icon next to the user in question
- Scroll down to find the application in question and click on the multi-select box
- Choose the role you want the user to have for the application
- Click Save Changes
You can also quickly assign a user the same role on all your application by clicking on the Default Roles multi-select, selecting the desired role and then clicking the Copy roles to ALL existing Applications link. This will also set the user to use this default role for any new applications created on the account.
Creating and editing roles
You can customize the default permissions for the existing roles (not recommended) or create custom roles for your account.
To create a custom role:
- Log into your Cloud 66 Dashboard
- Click your avatar and then Account Settings
- Click Teams
- Click the Roles & Permissions tab (top of the main panel)
- Click the green + button to add a role
- Give it a name and click Save Role
To edit the permissions for a role:
- Follow 1 - 4 above
- Scroll down and use the dropdown to select the role to edit
- Check the boxes next to the permissions you wish to add (or remove)
Changing roles affects all assigned users
Editing the permissions for a role will change the permissions for all existing users assigned that role. Be cautious when doing so.
Add a new user (team member)
- Open your Dashboard
- Click on your account avatar (top-right) and select Account Settings
- You need to give your team a name before inviting other members. This is the same as your Company name on the Payments page. If you already have entered a company name, you will skip this part.
- Click on Team in the left-hand panel
- Click the + button in the top right corner. This will allow you to choose a user type (Application or Finance user), input an email address and set the users permissions and its default role for applications.
An email will be sent to the email address specified, giving this user the option to sign up for Cloud 66 with their specified email address. If the invited email already has a Cloud 66 account, they will be notified of the pending invitation. By accepting the invitation, they will join your team.
Deleting user accounts & teams
If you are the owner of an account you can remove (delete) secondary accounts from your (primary) organization and also delete any teams under that organization.
To delete users:
- Open your Dashboard
- Click on your account avatar (top-right) and select Account Settings
- Click Teams in the left-hand panel
- Click the red remove icon next to the users you want to remove (and confirm each one)
To delete teams:
- Follow steps 1 - 3 above
- Click the red remove icon next to the names of the teams you wish to delete
Creating and managing Groups
Groups allow you to create subsets of users within a team. This is useful for setting some users’ access tokens to expire within a specified time period. To add a Group:
- Open Account Settings
- Click on Groups in the Collaboration panel
- Click the + Add Group button (top right of the main panel)
- Name the the Group and add a description if needed
- Select the members of the team to add to the Group
- Set the expiry time for their access tokens (optional - leaving it empty will set tokens to never expire)
- Click Create Group
You can also edit Groups by clicking on their names in the list, or delete them by clicking the trashcan icon next to their names and confirming the deletion.
Switch organizations
If you are part of several organizations, you will have to switch organization to see applications that belong to a different organization.
To switch between organizations, click on your account avatar (top-right) and and select the name of the organization you would like to switch to.
Leave a team
To leave a team, visit the Account Settings page, then click Organizations. Next, find the organization you would like to leave, and click the Leave button.
You cannot leave your primary organization (the one you own).