# Users

## Overview

Servoy Cloud Application Users are users allowed to authenticate into Servoy Cloud Applications that use the Servoy Cloud Authenticator method.

These users can be assigned to roles, granting them specific permissions within Servoy Cloud applications.

## Create User

To create a user for Servoy Cloud Applications, follow these steps:

1. **Navigate to Users**:
   * Use the menu to go to `User Management -> Users`.
2. **Create a New User**:
   * Click the `Create User` button to open the user creation dialog.
3. **Define User Details**:
   * Enter the required details for the new user in the provided fields.
4. **Save User**:
   * Save the user information. You will be automatically redirected to the User Details page.

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-bae05e4addf0bab975f590bf724a41fe29592ba8%2Fccc_auth_create_user.png?alt=media" alt=""><figcaption><p>Create Application User Dialog</p></figcaption></figure>

{% hint style="success" %}
You have successfully created a User for your Servoy Cloud applications. The user will receive an email requesting account verification.
{% endhint %}

{% hint style="warning" %}
**Important Note**: The account verification email has limited validity. Without completing the account verification, the user will not be able to log into the Servoy Cloud Application.
{% endhint %}

## User Details

The User Details Overview page provides detailed information about a Servoy Cloud Application User. This page contains the following tabs:

* Details
* User Roles
* User Permissions
* Login History

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-27d86013f3d120f60ad7a5857f72b329f1279461%2Fccc_auth_user_details_tabs.png?alt=media" alt=""><figcaption><p>User details tabs</p></figcaption></figure>

### Details

The Details tab refers to the following User Details:

<table><thead><tr><th width="221">Key</th><th width="115">Editable</th><th>Details</th></tr></thead><tbody><tr><td>First name</td><td>true</td><td>By default, first name is set as the email</td></tr><tr><td>Last name</td><td>true</td><td>No default value</td></tr><tr><td>Email</td><td>false</td><td></td></tr><tr><td>Registered</td><td>false</td><td>The user creation date</td></tr><tr><td>User status (verification status)</td><td>false</td><td><p>Displayed under the email field, indicates the user status. Can have the following values:</p><ul><li><strong>Pending Verification</strong> - The user is <strong>not active</strong> The account has not been verified using the email sent at the time of user creation.</li><li><strong>Verified</strong> - The user is <strong>active</strong> The account has been successfully verified.</li></ul></td></tr><tr><td>Latest Login</td><td>false</td><td>The last login date of the user or empty if no login registered</td></tr><tr><td>IP Address</td><td>false</td><td>The IP Address registered at the last login date</td></tr><tr><td>Authentication Source</td><td>false</td><td><p>Currently can have the following values:</p><ul><li><strong>Database:</strong> refers to users created using CCC</li></ul></td></tr></tbody></table>

### Roles

The **Roles** tab on the User Details page of an Application user displays a list of roles assigned to the user. From this tab, you can only view or remove roles. To assign a user to a role, see[#assign-user-to-role](https://docs.servoy.com/reference/servoy-cloud/cloud-control-center/security-roles#assign-user-to-role "mention")

#### Remove role from user

To remove the user from a role group:

1. **Identify the Role**: Locate the role you wish to remove from the list.
2. **Delete the Role**: Click on the delete icon next to the corresponding role.

Once the role is removed, the user will lose all associated permissions.

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-cf4e92d7405f66219b5eb9d09e89d7eb0faf87a0%2Fccc_auth_user_remove_role.png?alt=media" alt=""><figcaption><p>Remove role assigned to User from User Details page</p></figcaption></figure>

### Permissions

The **Permissions** tab on the User Details page of an Application user displays a list of all the permissions the user has, along with the applications where these permissions are applied.

#### Creating and Assigning Permissions

* To create permissions, see [security](https://docs.servoy.com/reference/servoy-cloud/cloud-control-center/application-overview/applications/security "mention")
* To assign permissions to roles, see [security-roles](https://docs.servoy.com/reference/servoy-cloud/cloud-control-center/user-management/security-roles "mention")

### History

The **History** tab on the User Details page of an Application User shows the user's login history with the following details:

* Login Date
* IP Address

## Actions

### Delete User

{% hint style="info" %}
This feature is only available for users who are pending account verification. Verified users cannot be deleted; they can only be locked. To lock a user, see[#change-lock-status](#change-lock-status "mention")
{% endhint %}

To delete a ServoyCloud Application User:

1. Navigate to `User Management -> Users` using the menu.
2. Navigate to `User Details` by clicking the context menu <img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-3df0de25b2437a3b22fc27ea72a16d73af2c7ac4%2Fccc_context_menu.png?alt=media" alt="" data-size="line"> of the chosen user
3. Click the `Actions` button on the top right of the page
4. Click the `Delete User` button and confirm the deletion.

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-d80726fe630d1a1bfaf5b8fcba0a77830c05c9c2%2Fccc_auth_user_delete.png?alt=media" alt=""><figcaption><p>Delete Application User</p></figcaption></figure>

### Re-send Verification Email

{% hint style="warning" %}
This feature is only available for users which are pending account verification
{% endhint %}

Users must verify their account to become active users capable of logging into Servoy Cloud Applications. The initial verification email has limited validity; if expired, users will be redirected to an error page.

To re-send user verification email:

1. Navigate to `User Management -> Users` using the menu.
2. Navigate to `User Details` by clicking the context menu <img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-3df0de25b2437a3b22fc27ea72a16d73af2c7ac4%2Fccc_context_menu.png?alt=media" alt="" data-size="line"> of the chosen user
3. Click the `Actions` button on the top right of the page
4. Click the `Resend Verification email` button. The user will receive an email to verify their account

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-a309c3905a49dd1ef9af9bc5d768c189099077fd%2Fccc_auth_user_resend_email.png?alt=media" alt=""><figcaption><p>Re-send User Verification Email</p></figcaption></figure>

### Change Lock Status

{% hint style="info" %}
This feature is only available for verified users.
{% endhint %}

#### To change the lock status of an user:

1. Navigate to `User Management -> Users` using the menu.
2. Navigate to `User Details` by clicking the context menu <img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-3df0de25b2437a3b22fc27ea72a16d73af2c7ac4%2Fccc_context_menu.png?alt=media" alt="" data-size="line"> of the chosen user
3. Click the `Actions` button on the top right of the page
4. Click the `Change lock status` button, which prompts a dialog
5. Toggle the chosen lock status
6. Save the changes

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-9b1fd1be93c9953a6d459389181b74b906601f9d%2Fccc_auth_user_change_lock_status.png?alt=media" alt=""><figcaption><p>Application User Lock Status</p></figcaption></figure>

#### Lock status indicators:

* **Users List Overview** - Displays the `Locked` text along with a lock icon for the corresponding locked user
* **User Details Page** - Displays a greyed-out username along with a lock icon.

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-aaa1ad301909633bb059ee3abcb14c54b4a22e57%2Fccc_auth_user_locked.png?alt=media" alt=""><figcaption><p>Locked Application User</p></figcaption></figure>

### Reset Password

{% hint style="info" %}
This feature is only available for verified users.
{% endhint %}

#### To reset the password of an Application User:

1. Navigate to `User Management -> Users` using the menu
2. Navigate to `User Details` by clicking the context menu <img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-3df0de25b2437a3b22fc27ea72a16d73af2c7ac4%2Fccc_context_menu.png?alt=media" alt="" data-size="line"> of the chosen user
3. Click the `Actions` button on the top right of the page
4. Click the `Reset password` button, which prompts a dialog
5. Fill in the required fields
6. Save the changes

<figure><img src="https://3933488479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjpWd52BKwABWxF2lScUK%2Fuploads%2Fgit-blob-4c50e809d9d26d4a8465cd02e2d4d52f2f512939%2Fccc_auth_user_reset_password.png?alt=media" alt=""><figcaption><p>Reset password of Application User</p></figcaption></figure>
