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.
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
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
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.