adding content
parent
db8f70a26b
commit
8993037547
|
|
@ -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.
|
||||
Loading…
Reference in New Issue