adding content

pull/6380/head
meelahme 2025-08-22 12:52:39 -07:00
parent db8f70a26b
commit 8993037547
1 changed files with 111 additions and 1 deletions

View File

@ -24,4 +24,114 @@ Use the {{% product-name %}} Admin UI to manage users and control access to your
- [Invite a user](#invite-a-user)
- [Manage invitations](#manage-invitations)
- [User roles and permissions](#user-roles-and-permissions)
- [Limitations](#limitations)
- [Limitations](#limitations)
## Access the Users page
1. Access the {{% product-name %}} Admin UI at [console.influxdata.com](https://console.influxdata.com).
If you don't have login credentials, [contact InfluxData support](https://support.influxdata.com).
2. Log in using the credentials provided by InfluxData.
3. From the Account Management portal, select your cluster.
4. In the cluster resource management view, click **Users** in the navigation.
The Users page displays your account information and a table of existing users and invitations.
## View existing users
The Users page shows a comprehensive view of all users and pending invitations for your account:
- **Invite ID**: Unique identifier for each user invitation
- **Email**: Email address of the invited or existing user
- **Invited At**: Date and time when the invitation was sent
- **Status**: Current status of the invitation
- `accepted`: User has accepted the invitation and has access to the cluster
- `expired`: Invitation has expired and is no longer valid
- `revoked`: Invitation has been manually revoked by an administrator
Use the search functionality to quickly find specific users by email address or invitation details.
## Invite a user
Only users with the **Admin** role can send new invitations.
1. On the Users page, click **{{< icon "plus" >}} Invite Users**.
2. In the **Invite User** dialog:
- Enter the **email address** of the user you want to invite
- Select the appropriate **role** from the dropdown menu:
- **Admin**: Full read and write permissions on all resources
- **Member**: Read permission on certain resources and create permission for database tokens
- **Auditor**: Read permission on all resources without modification capabilities
3. Click **Send Invitation**.
An invitation email with an activation link is sent to the specified email address. The user must accept the invitation to gain access to your {{% product-name %}} cluster.
{{% note %}}
#### Invitation expiration
Invitations expire after a set period. If an invitation expires, you'll need to send a new invitation to the user.
{{% /note %}}
## Manage invitations
### Revoke an invitation
You can revoke pending invitations that haven't been accepted yet:
1. In the Users table, locate the invitation you want to revoke.
2. Click the **Actions** menu (⋮) for that invitation.
3. Select **Revoke Invitation**.
4. Confirm the revocation when prompted.
Revoked invitations can no longer be used to access your cluster. The invitation status will change to `revoked`.
### View invitation details
Click on any invitation in the table to view additional details, including:
- Complete invitation ID
- Exact timestamp of invitation creation
- Current status and any status changes
## User roles and permissions
{{% product-name %}} uses role-based access control to manage user permissions:
### Admin
- Full read and write permissions on all cluster resources
- Can create and delete databases, tables, and tokens
- Can send and revoke user invitations
- Can manage all aspects of cluster administration
### Member
- Read permission on databases and certain cluster resources
- Can create database tokens for data access
- Cannot delete or create databases
- Cannot manage other users or send invitations
### Auditor
- Read-only access to all cluster resources
- Can view databases, tables, and configuration
- Can see user invitations but cannot create or revoke them
- Cannot modify any resources or create tokens
{{% note %}}
#### Role assignment
User roles are assigned when sending invitations and cannot currently be changed through the Admin UI. To modify a user's role, [contact InfluxData support](https://support.influxdata.com).
{{% /note %}}
## Limitations
The current Admin UI user management feature has the following limitations:
- **Role modification**: User roles cannot be changed after invitation acceptance. Contact support to modify roles.
- **User deletion**: Users cannot be removed from accounts through the UI. Contact support for user removal.
- **Post-acceptance management**: After a user accepts an invitation, their role details are not visible in the UI.
### Alternative management methods
For operations not available in the Admin UI:
- **influxctl CLI**: Use the [`influxctl user list`](/influxdb3/cloud-dedicated/reference/cli/influxctl/user/list/) command to view comprehensive user information
- **Support requests**: Contact [InfluxData support](https://support.influxdata.com) for role changes, user removal, or other advanced user management tasks
---
The Admin UI provides essential self-service capabilities for day-to-day user management while InfluxData continues to expand functionality in future releases.