1
0
mirror of https://github.com/minio/docs.git synced 2025-08-06 14:42:56 +03:00
Files
docs/source/reference/minio-mc-admin/mc-admin-user-info.rst
Daryl White 47c09b7d31 Change instances of --JSON flag to --json (#1149)
Continues the work of #1148 to change all other instances of `--JSON` to
`--json`.
2024-03-06 08:59:17 -05:00

3.9 KiB

mc admin user info

minio

Table of Contents

mc admin user info

Syntax

The mc admin user info command returns detailed information of a MinIO user <minio-internal-idp> on the target MinIO deployment.

To manage external Identity Provider users, see OIDC <mc idp openid> or AD/LDAP <mc idp ldap>.

EXAMPLE

The following command returns details of user myuser on the myminio MinIO deployment:

mc admin user info myminio myuser

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] admin user info      \
                            ALIAS     \
                        USERNAME

Parameters

ALIAS

The alias <mc alias> of a configured MinIO deployment to retrieve user information from.

USERNAME

The username to retrieve information for.

Global Flags

RELEASE.2023-05-26T23-31-54Z

mc admin user info --json output includes policies inherited from a user's group memberships in memberOf.

Examples

View User Details

Use mc admin user info to view detailed user information for a user on a MinIO deployment:

mc admin user info ALIAS USERNAME
  • Replace ALIAS <mc admin user info ALIAS> with the alias <mc alias> of the MinIO deployment.
  • Replace USERNAME <mc admin user info USERNAME> with the username of the user to display information for.

For the MinIO internal IDentity Provider (IDP) <minio-internal-idp>, the output resembles the following:

AccessKey: miniouser
Status: enabled
PolicyName: 
MemberOf: []
Authentication: builtin (miniouser)

For a third-party <minio-external-identity-management> identity service such as LDAP, the output resembles the following:

AccessKey: uid=dillon,ou=people,ou=swengg,dc=min,dc=io
Status: 
PolicyName: consoleAdmin
MemberOf: []
Authentication: ldap/localhost:1389 (uid=dillon,ou=people,ou=swengg,dc=min,dc=io)

View Policies from Group Membership

Use mc admin user info with --json <mc.--json> to view the policies inherited from a user's group memberships <minio-groups>:

mc admin user info ALIAS USERNAME --json
  • Replace ALIAS <mc admin user info ALIAS> with the alias <mc alias> of the MinIO deployment.
  • Replace USERNAME <mc admin user info USERNAME> with the username of the user to display information for.

The memberOf property in the output contains a list of groups the user is a member of, with the policies attached to each group. The output resembles the following:

{
 "status": "success",
 "accessKey": "myuser",
 "userStatus": "enabled",
 "memberOf": [
  {
   "name": "testingGroup",
   "policies": [
    "testingGroupPolicy"
   ]
 "authentication": builtin (myuser)
  }
 ]
}

Behavior

S3 Compatibility