From 8993037547b70f428d49daa98d2a6655a7dbf82b Mon Sep 17 00:00:00 2001 From: meelahme Date: Fri, 22 Aug 2025 12:52:39 -0700 Subject: [PATCH] adding content --- .../cloud-dedicated/admin/users/admin-ui.md | 112 +++++++++++++++++- 1 file changed, 111 insertions(+), 1 deletion(-) diff --git a/content/influxdb3/cloud-dedicated/admin/users/admin-ui.md b/content/influxdb3/cloud-dedicated/admin/users/admin-ui.md index 36ea31fba..3e43f4943 100644 --- a/content/influxdb3/cloud-dedicated/admin/users/admin-ui.md +++ b/content/influxdb3/cloud-dedicated/admin/users/admin-ui.md @@ -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) \ No newline at end of file +- [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. \ No newline at end of file