Getting information about a specific user

Ops Center Common Services REST API Reference Guide

Version
10.7.x
File Size
577 KB
Audience
anonymous
Part Number
MK-99OPS003-03
The following request gets information about a specific user.

Execution permission

You must be a system administrator or a security administrator.

Request line

GET base-URL/security/v1/users/object-ID-of-the-user

Request message

Object ID of the user

Specify the value of id acquired by using the request for getting information about a list of users.

Attribute

Type

Description

id

string

(Required) Object ID of the user

Query parameters
None.
Body
None.

Response message

Body
{
    "id": "a010279b-ae66-4c1d-b066-c45d50c9f75a",
    "username": "sysadmin",
    "firstName": "firstName",
    "lastName": null,
    "email": "sysadmin@example.com",
    "dn": null,
    "description": "Built-in user",
    "enabled": true,
    "builtin": true,
    "federatedIdentities": [
        {
            "alias": "dummy_alias",
            "displayName": "DUMMY DISPLAY NAME"
        }
    ]
}

Attribute

Type

Description

id

string

Object ID of the user

username

string

Username

firstName

string

First name of the user

lastName

string

Last name of the user

email

string

Email address

dn

string

Distinguished Name

If the user is not an Active Directory user, the value null is always returned.

description

string

Description of the user account

enabled

boolean

Whether the user account is enabled

  • true: The user account is enabled.
  • false: The user account is disabled.

builtin

boolean

Whether the user is a built-in user

  • true: The user is a built-in user.
  • false: The user is not a built-in user.

federatedIdentities

string[]

Identity provider information

If the user is not an identity provider user, null is always returned.

alias

string

Alias name that identifies the identity provider

This is displayed when the user is an identity provider user.

displayName

string

Display name of the identity provider

This is displayed when the user is an identify provider user.

Coding example

curl -v -X GET -s "https://example.com:443/portal/security/v1/users/a010279b-ae66-4c1d-b066-c45d50c9f75a" -H "Authorization:Bearer eyJhbxxx"
Tip: Because this request uses SSL communication, you must either run the curl command with the root certificate of the Common Services server certificate specified for the --cacert option, or run the command with the -k option specified. (The -k option runs the command by ignoring SSL errors.)