- [Resource: LegacySoarUser](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#LegacySoarUser)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#LegacySoarUser.SCHEMA_REPRESENTATION)
- [UserType](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#UserType)
- [PermissionGroup](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#PermissionGroup)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#PermissionGroup.SCHEMA_REPRESENTATION)
- [AccountState](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#AccountState)
- [Methods](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#METHODS_SUMMARY)

## Resource: LegacySoarUser

Legacy SOAR users management.

| JSON representation |
|---|
| ``` { "name": string, "firstName": string, "lastName": string, "socRoles": [ integer ], "email": string, "avatar": string, "userType": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#UserType`), "environmentsJson": string, "permissionGroups": [ { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#PermissionGroup`) } ], "permissionGroupNames": [ string ], "accountState": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#AccountState`), "loginIdentifier": string, "providerName": string, "allowedPlatforms": [ string ], "displayName": string, "userFullName": string, "iamPrincipal": string, "lastLoginTime": string, "hasAllEnvironmentsAccess": boolean, "isDeleted": boolean } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The unique name(ID) of the LegacySoarUser. Format: projects/{project}/locations/{location}/instances/{instance}/legacySoarUsers/{legacySoarUser} |
| `firstName` | `string` Required. User first name. |
| `lastName` | `string` Required. User last name. |
| `socRoles[]` | `integer (https://developers.google.com/discovery/v1/type-format format)` Required. User's role in the SOC team. |
| `email` | `string` Required. User email. |
| `avatar` | `string` Optional. Avatar of the user in base 64 format. |
| `userType` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#UserType`)`` Required. User type. |
| `environmentsJson` | `string` Required. User logical environments (json). |
| `permissionGroups[]` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#PermissionGroup`)`` Output only. User permission groups (for GET/LIST). |
| `permissionGroupNames[]` | `string` Required. User permission group names (for POST/PATCH). |
| `accountState` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers#AccountState`)`` Output only. User account state. |
| `loginIdentifier` | `string` Required. User unique login identifier. Relevant for IDP |
| `providerName` | `string` Required. User identity provider provider name. |
| `allowedPlatforms[]` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. User allowed federated platforms. |
| `displayName` | `string` Required. User display name. |
| `userFullName` | `string` Required. User full name. |
| `iamPrincipal` | `string` Output only. The user's IAM principal. |
| `lastLoginTime` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. User last login time. |
| `hasAllEnvironmentsAccess` | `boolean` Output only. Determines if the user has all environments access. |
| `isDeleted` | `boolean` Output only. Determines if the user is deleted. |

## UserType

User type.

| Enums ||
|---|---|
| `USER_TYPE_UNSPECIFIED` | Unspecified user type. |
| `INTERNAL` | System managed user. |
| `EXTERNAL` | Identity provider managed user. |
| `SUPPORT` | Customer managed user. |

## PermissionGroup

Permission group dto (for GET/LIST).

| JSON representation |
|---|
| ``` { "name": string, "id": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. Permission group description. |
| `id` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Permission group name. |

## AccountState

User account state.

| Enums ||
|---|---|
| `ACCOUNT_STATE_UNSPECIFIED` | Unspecified account state. |
| `DISABLED` | Disabled users cannot login into the system. |
| `PENDING` | A state where users are invited into the system before their first login. |
| `ACTIVE` | A state where users are actively using the system. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/delete` | Permanently deletes a user account identified by their resource `name`. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/get` | Retrieves detailed information about a specific user identified by their resource name. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/getLocalization` | Gets the localization settings for a specific user. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/getNotificationSettings` | Gets the notification settings for a specific user. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/list` | Returns a paginated list of users within a SecOps instance. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/updateLocalization` | Updates the localization settings for a specific user. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.legacySoarUsers/updateNotificationSettings` | Updates the notification settings for a specific user. |