Documentation

mc admin user info

Syntax

The mc admin user info command returns detailed information of a MinIO user on the target MinIO deployment.

To manage external Identity Provider users, see OIDC or AD/LDAP.

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

mc admin user info myminio myuser

The command has the following syntax:

mc [GLOBALFLAGS] admin user info      \
                            ALIAS     \
                            USERNAME
  • Brackets [] indicate optional parameters.

  • Parameters sharing a line are mutually dependent.

  • Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS
Required

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

USERNAME

The username to retrieve information for.

Global Flags

This command supports any of the global flags.

Changed in version 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 with the alias of the MinIO deployment.

  • Replace USERNAME with the username of the user to display information for.

For the MinIO internal IDentity Provider (IDP), the output resembles the following:

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

For a third-party 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 to view the policies inherited from a user’s group memberships:

mc admin user info ALIAS USERNAME --json
  • Replace ALIAS with the alias of the MinIO deployment.

  • Replace 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

The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.