Docs: Org, Team, and User Admin (#30756)
* Update _index.md * Update _index.md * Create server-admin-manage-users.md * content updates * Update server-admin-manage-users.md * content update * testing single sourcing * Update server-admin-manage-users.md * deleted index, updated sharing command * Update server-admin-manage-users.md * added index files to folders * Update _index.md * added task lists * Update server-admin-manage-users.md * working on single sourcing tests * content updates * Update server-admin-manage-users.md * Update server-admin-manage-users.md * Update server-admin-manage-users.md * add server admin manage orgs file * Update _index.md * Update _index.md * Content updates * Update server-admin-manage-orgs.md * Update server-admin-manage-users.md * Delete menu.yaml * Update _index.md * Update server-admin-manage-users.md * deleted old files * Update _index.md * temporarily removed some files * Update server-admin-manage-users.md * Made two relref changes to this branch. * Merge branch 'master' into docs-update-manage-users * Update server-admin-manage-orgs.md * Update server-admin-manage-users.md * add snippets and content changes * Content updates * Update server-admin-manage-users.md * Update server-admin-manage-orgs.md * added folders * content updates * Update server-admin-manage-users.md * Update server-admin-manage-users.md * testing step format * updated and clarified titles of snippets * Update server-admin-manage-users.md * Update server-admin-manage-users.md * Update _index.md * Update _index.md * Update _index.md * Update _index.md * Update server-admin-manage-users.md * Update server-admin-manage-users.md * content edits * Update _index.md * Update _index.md * Update _index.md * deleted old files * Update _index.md * Update _index.md * Update change-your-password.md * Update _index.md * Update _index.md * Update _index.md * moved files * Added user account profile topic * Update _index.md * Update _index.md * minor edits * update shortcodes * minor updates * Delete view-server-user-list-list.md * testing and updating shortcodes * edited content for single sourcing * Update example.md * added new snippet * updated content * Update _index.md * Added links * Content updates * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: Ursula Kallio <73951760+osg-grafana@users.noreply.github.com> * Update docs/sources/manage-users/_index.md Co-authored-by: Ursula Kallio <73951760+osg-grafana@users.noreply.github.com> * Update _index.md Co-authored-by: achatterjee-grafana <aparajita.chatterjee@grafana.com> Co-authored-by: Robby Milo <robbymilo@gmail.com> Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Co-authored-by: Ursula Kallio <73951760+osg-grafana@users.noreply.github.com>
This commit is contained in:
co-authored by
achatterjee-grafana
Ursula Kallio
achatterjee-grafana
Robby Milo
parent
c24a4c1803
commit
ec9c3230eb
@@ -0,0 +1,98 @@
|
||||
+++
|
||||
title = "Org admin tasks"
|
||||
weight = 200
|
||||
+++
|
||||
|
||||
# Manage users as an Org Admin
|
||||
|
||||
An _organization_ is a group of users on a Grafana server. Each user can belong to more than one organization. Every member of the organization has a _role_ in that organization that grants them a certain level of permissions. For more information, refer to [Organization roles]({{< relref "../../permissions/organization_roles.md" >}}).
|
||||
|
||||
Organization Admins, also called Org Admins, can manage users in their organization. Some of their tasks overlap with the [Server Admin tasks]({{< relref "../server-admin/_index.md" >}}).
|
||||
|
||||
> **Note:** You must have Admin permissions in an organization in order to perform the tasks described in this page.
|
||||
|
||||
## View organization user account list
|
||||
|
||||
See a complete list of users with accounts in your Grafana organization. If necessary, you can use the search field to filter the list.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
|
||||
Grafana displays all user accounts on the server, listed in alphabetical order by user name. The following information is displayed:
|
||||
- **Login -** The value in the **Username** field of the account.
|
||||
- **Email -** The email associated with the user account.
|
||||
- **Name -** The value in the **Name** field of the account.
|
||||
- **Seen -** How long ago the user logged in. If they have never logged in, then the default longest time (10y) is displayed.
|
||||
- **Role -** The organization role currently assigned to the user.
|
||||
|
||||

|
||||
|
||||
## Manage organization invitations
|
||||
|
||||
Organization Admins can invite users to their Grafana organizations and manage invitations. When an invited user signs in to Grafana, a user account is created for them if one does not already exist.
|
||||
|
||||
### Invite user to organization
|
||||
|
||||
Invite or add an existing user account to your organization.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
1. Click **Invite**.
|
||||
1. Enter the following information:
|
||||
- **Email or Username -** Either the email or username that the user will use to sign in to Grafana.
|
||||
- **Name -** (Optional) The value in the **Name** field of the account.
|
||||
- **Role -** Click the organization role to assign this user. For more information, refer to [Organization roles]({{< relref "../../permissions/organization_roles.md" >}}).
|
||||
- **Send invite email**
|
||||
- **Yes -** If your organization has SMTP set up, then Grafana sends an email to the user inviting them to log in to Grafana and join your organization.
|
||||
- **No -** The user is not sent an invitation, but they can sign in to the Grafana server with the email or username that you entered.
|
||||
1. Click **Submit**.
|
||||
|
||||

|
||||
|
||||
### View pending invitations
|
||||
|
||||
Review invitations of users that were invited but have not signed in.
|
||||
|
||||

|
||||
|
||||
> **Note:** The button is only visible if there are unanswered invitations.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
1. Click **Pending Invites**.
|
||||
|
||||
Grafana displays a list of pending invitations. If necessary, you can use the search field to filter the list.
|
||||
|
||||

|
||||
|
||||
### Copy invitation
|
||||
|
||||
SME - What does this do? I see the button, but it does not seem to do anything.
|
||||
|
||||
### Cancel invitation
|
||||
|
||||
Revoke the invitation of a user that was invited but has not logged in.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
1. Click **Pending Invites**.
|
||||
1. Click the red **X** next to the invitation that you want to cancel.
|
||||
|
||||
## Change organization role
|
||||
|
||||
Every user account is assigned an [Organization role]({{< relref "../../permissions/organization_roles.md" >}}). Organization admins can change the role assigned to a user in their organization.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
1. Find the user account for which you want to change the role. Use the search field to filter the list if necessary.
|
||||
1. Click the **Role** list in the user account that you want to change. Grafana displays the list of available roles.
|
||||
1. Click the role that you want to assign.
|
||||
|
||||
## Remove user from organization
|
||||
|
||||
Remove a user account from your organization. This prevents them from accessing the dashboards and data sources associated with the organization, but it does not remove the user account from the server.
|
||||
|
||||
1. Hover your cursor over the **Configuration** (gear) icon in the side menu.
|
||||
1. Click **Users**.
|
||||
1. Find the user account that you want to delete. Use the search field to filter the list if necessary.
|
||||
1. Click the red **X** next to remove the user from your organization.
|
||||
Reference in New Issue
Block a user