Managing Users and Teams
Managing users
To view, invite, and manage Gremlin users and their privileges within your company, select "Company Settings" from the drop-down menu at the top right. In the users tab on the page, you will find a list of users at your company as well as the teams they belong to.
To view more details about a specific user, select their name from the list, which will take you to a details page.
To view revoked or invited users instead of active users, select ... at the top right of the users table.
Inviting Users
To invite new users to your company, click the "Invite Users", and enter an email address, or a list of email addresses separated by commas. Below the list of emails is a list of teams to which you can add the invited users. Inviting a user will send them an email to create a Gremlin account and add them to the teams you selected.
Editing User Roles
To edit the privileges that a user has, you must edit the roles that are assigned to that user.
Select the user you wish to edit from the list of users. On the user's details page, you can edit their company or team roles by selecting ..., then selecting "Edit Company Roles" or "Edit Team Roles".
Removing a User From the Company
To remove a user from your Gremlin account, navigate to the "Users" tab in the "Company Settings". Select the user to view their details, then in the "Company" section of their user details, select "Revoke User" from the "..." menu.
Managing teams
To view a list of teams on your Gremlin account, create a new team, delete a team, invite users to a team, or manage a team's settings, select "Team Settings" from the drop down menu at the top right.
To take any action on behalf of a team, like running experiments, a user must be a member of that team and have the appropriate role to take that action.
Gremlin Agents, experiments, and reports belong to only 1 team. You must switch between teams to view these for another team. To switch between teams of which you are a member, select the dropdown menu in the top right hand corner, click "Switch Team," then choose the team you would like to view.
Creating a team
To create a team, select the "Create Team" button in the "Teams" tab on the "Company Settings" page. After giving the team a name, you will be taken to the team's details page.
Adding a user to a team
Select the team to add members to from the list of teams, then select "Add Member". From there you can add one or more members that are already a part of your Gremlin account, or you can invite new users to your company and they team.
Removing a user from a team
You can remove a user from a team 2 ways:
- Select the user you wish to edit from the list of users in the "Users" tab in "Company Settings". Select ... and remove them from the team.
- Navigate to the "Teams" tab on the "Company Settings" page, select the team you would like to view, and select ..., and "Remove From Team"
Team configuration and API keys
View a team's Team ID, reset their secret key for agent authentication, and download or edit the team's client certificates from the "Configuration" tab on the Team Settings page.
Manage the team's API key's from the "API Keys" tab on the team's Details page.
Changing a team name
As a Team Manager, you can change a team name to support organizational changes or because you just want something more fun. Changing team names used in SAML and OIDC claims will affect login attempts. See SAML claims for more information.
Deleting a team
To delete a team from your Gremlin account, go to "Company Settings", select the "Teams" tab, select the team you want to deleted, then select "Configuration", and "Delete This Team".