¶ UsersManagementClient

Authing User ManagementClient

This client is used to manage Authing users. It can create, query, update and delete users, refresh user token, manage user's group, user's role, user's policy and perform other operations.

¶ Create a user

UsersManagementClient().create(userInfo)

An administrator can use this interface to create a user and the this process does not need to perform security checks such as SMS code verification and other verifications.

¶ Parameter

• userInfo <CreateUserInput> User information
• userInfo.email <string> Email, unique in the user pool
• userInfo.emailVerified <boolean> Whether the email is verified
• userInfo.phone <string> phone number
• userInfo.phoneVerified <boolean> Whether the phone number is verified
• userInfo.unionid <string> For the social login user, this field is the unique ID of the user in the third-party social login identity provider
• userInfo.openid <string> The openid returned by WeChat login
• userInfo.password <string> password
• userInfo.registerSource <string> Registration source, you can choose multiple
• userInfo.username <string> username
• userInfo.nickname <string> nickname
• userInfo.photo <string> avatar
• userInfo.company <string> company
• userInfo.browser <string> browser
• userInfo.loginsCount <number> The number of login times. This field can be set when you migrate from the original user system to Authing.
• userInfo.lastLogin <string> Last login time, a time string conforming to the ISO8601 format. (E.g. "2017-06-07T14:34:08.700Z", "2017-06-07T14:34:08.700 or "2017-06-07T14:34:08+04:00")
• userInfo.lastIP <string> The last login (or other activity) IP of the user
• userInfo.signedUp <string> Registration time, a time string in ISO8601 format. (E.g. "2017-06-07T14:34:08.700Z", "2017-06-07T14:34:08.700 or "2017-06-07T14:34:08+04:00")
• userInfo.blocked <boolean> Whether the account is disabled
• userInfo.isDeleted <boolean> whether the account is deleted
• userInfo.device <string> device
• userInfo.lastIP <string> Last log in IP
• userInfo.name <string> Name
• userInfo.givenName <string> Given Name
• userInfo.familyName <string> Family Name
• userInfo.middleName <string> Middle Name
• userInfo.profile <string> Profile Url
• userInfo.preferredUsername <string> Preferred Name
• userInfo.website <string> personal website
• userInfo.gender <string> Gender, M means male, F means female, U means unknown
• userInfo.birthdate <string> birthday
• userInfo.zoneinfo <string> timezone
• userInfo.locale <string> language
• userInfo.address <string> address
• userInfo.streetAddress <string> street address
• userInfo.locality <string>
• userInfo.region <string> region
• userInfo.postalCode <string> zipcode
• userInfo.city <string> city
• userInfo.province <string> province
• userInfo.country <string> country

¶ Example

var email = "test@example.com";
var password = "123456";
var user = managementClient.Users.Create(new CreateUserInput()
{
  Email = email,
  Password = password,
})

¶ Update user information

UsersManagementClient *().update(id, updates)

Update user information

¶ Parameter

• id <string> user ID
• updates <UpdateUserInput> Modified user information
• updates.email <string> email
• updates.emailVerified <boolean> whether the email is verified
• updates.phone <string> phone number
• updates.phoneVerified <boolean> Whether the phone number is verified
• updates.unionid <string> For the social login user, this field is the unique ID of the user in the third-party social login identity provider
• updates.openid <string> The openid returned by WeChat login
• updates.password <string> password
• updates.registerSource <string> Registration source, you can select multiple
• updates.tokenExpiredAt <string> The token expiration time, a time string in the ISO8601 format. (Such as "2017-06-07T14:34:08.700Z", "2017-06-07T14:34:08.700 or "2017-06-07T14:34:08+04:00"). Set the field to be earlier than the current time can make the user's token invalid.
• updates.username <string> username
• updates.nickname <string> nickname
• updates.photo <string> avatar
• updates.company <string> company
• updates.browser <string> browser
• updates.loginsCount <number> The number of logins. This field can be set when you migrate from the original user system to Authing.
• updates.lastLogin <string> Last login time, a time string in the ISO8601 format. (E.g. "2017-06-07T14:34:08.700Z", "2017-06-07T14:34:08.700 or "2017-06-07T14:34:08+04:00")
• updates.lastIP <string> The IP of the user's last login (or other activity)
• updates.signedUp <string> Registration time, a time string in the ISO8601 format. (E.g. "2017-06-07T14:34:08.700Z", "2017-06-07T14:34:08.700 or "2017-06-07T14:34:08+04:00")
• updates.blocked <boolean> Whether the account is disabled
• updates.device <string> device
• updates.lastIP <string> Last login IP
• updates.name <string> Name
• updates.givenName <string> Given Name
• updates.familyName <string> Family Name
• updates.middleName <string> Middle Name
• updates.profile <string> Profile Url
• updates.preferredUsername <string> Preferred Name
• updates.website <string> personal website
• updates.gender <string> Gender, M means male, F means female, U means unknown
• updates.birthdate <string> birthday
• updates.zoneinfo <string> timezone
• updates.locale <string> language
• updates.address <string> address
• updates.streetAddress <string> street address
• updates.locality <string>
• updates.region <string> region
• updates.postalCode <string> zipcode
• updates.city <string> city
• updates.province <string> province
• updates.country <string> country

¶ Example

¶ Get user details

UsersManagementClient.Users.Detail("userId")

Get user details by user ID. If you want to get user details by token, please use AuthenticationClient SDK.

¶ Parameter

• userId <string> user ID

¶ Example

var user = await UsersManagementClient.Users.Detail("userId");

¶ Get user defined value

UsersManagementClient.Users.getUdfValue("userId", "default")

Get user defined value

¶ Parameter

• userId <String> User ID

¶ Example

UsersManagementClient.Users.getUdfValue("userId", "default")

¶ Batch get user defined value

UsersManagementClient.Users.getUdfValueBatch(userIds)

Batch get user defined value

¶ Parameter

• userIds <List<String>> User ID list

¶ Example

managementClient.users().getUdfValueBatch("userId", "default").execute();


## Delete a user
```csharp
UsersManagementClient.Users.delete(userId)

Delete a user

¶ Parameter

• userId <string> user ID

¶ Example

var message = await managementClient.Users.Delete("userId");

¶ Batch delete users

UsersManagementClient().deleteMany(userIds)

Batch delete users

¶ Parameter

• userIds <string[]> user ID list

¶ Example

var message = await managementClient.Users.DeleteMany(new string[] { "userId" });

¶ Batch get users

UsersManagementClient().batch(userIds)

Batch get user details by ID.

¶ Parameter

• userIds <string[]> User ID list

¶ Example

var users = await managementClient.Users.Batch(new string[] { "userId" });

¶ Get user list

UsersManagementClient().list(page, limit)

Get the user list in the user pool.

¶ Parameter

• page <number> Page number, starting from 1. The default value is: 1.
• limit <number> The number of users per page. The default value is: 10.

¶ Example

var users = await managementClient.Users.List();

¶ Find a user

UsersManagementClient().find(options)

Find a user by username, email, and phone number.

¶ Parameter

• options <Object>
• options.username <string> username, case sensitive.
• options.email <string> The email, which is not case sensitive.
• options.phone <string> phone number

¶ Example

¶ Search users

UsersManagementClient().search(query, options, page, limit)

Search users based on keywords.

¶ Parameter

• query <null> search content
• options <string[]> options
• options.fields <string[]> Search user fields. If not specified, the default will be fuzzy search from username, nickname, email, phone, company, name, givenName, familyName, middleName, profile and preferredUsername fields. If you need a precise search, please use the find method.
• page <number> The default value is: 1.
• limit <number> The default value is: 10.

¶ Example

var users = await managementClient.Users.Search("test");

¶ Refresh user token

UsersManagementClient().refreshToken(id)

Refresh user token

¶ Parameter

• id <string> user ID

¶ Example

var token = await managementClient.Users.RefreshToken("userId");

¶ Get user group list

UsersManagementClient().listGroups(userId)

Get user group list

¶ Parameter

• userId <string> user ID

¶ Example

¶ Join a group

UsersManagementClient().addGroup(userId, group)

Add a user to a group.

¶ Parameter

• userId <string> user ID
• group <string> group code

¶ Example

¶ Quit a group

UsersManagementClient().removeGroup(userId, group)

Remove the user from a group.

¶ Parameter

• userId <string> user ID
• group <string> group code

¶ Example

¶ Get user role list

UsersManagementClient().listRoles(userId)

Get the user's role list.

¶ Parameter

• userId <string> user ID

¶ Example

var roles = await managementClient.Users.ListRoles("userId");

¶ Add roles

UsersManagementClient().addRoles(userId, roles)

Add roles to the user.

¶ Parameter

• userId <string> user ID
• roles <string> role code list

¶ Example

var message = await managementClient.Users.AddRoles("userId", new string[] { "roleId" });

¶ Remove roles

UsersManagementClient().removeRoles(userId, roles)

Remove roles from the user.

¶ Parameter

• userId <string> user ID
• roles <string> role code list

¶ Example

var message = await managementClient.Users.RemoveRoles("userId", new string[] { "roleId" });