> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Block Users

> Syteca lets you block users on Windows Clients — manually while viewing their session, or automatically when an alert triggers — with a configurable forced-logout window, custom warning message, and central Blocked Users list.

## When detection isn't enough — stop the activity in 15 seconds

Detecting an incident is necessary; *stopping* it is harder. Most monitoring tools alert you when a user does something forbidden — at which point the user is still doing it, and your security team has to manually call IT to disable the account, while the data is already on its way out the door. By the time the response chain completes, the damage is done.

Some platforms support automated response, but they mostly require a separate SOAR product and a workflow that crosses two or three vendors. **Syteca user blocking** is the same idea, built into the same Client you're already running. Block manually while watching a session in progress (with a 15-second warning the user sees on their screen), or configure any alert to **automatically block on trigger**. The user is forcibly logged out across all Clients, can't log back in, and stays on the Blocked Users list until an admin manually removes them. No second product.

<Info>
  **Use Syteca user blocking when you need to:**

  * Cut off **insider threats in real time** — credential abuse, privileged data theft, evidence destruction in progress.
  * Stop **session-level incidents** instantly while you investigate — no waiting on IT to disable the AD account.
  * Build **automated response into your alert rules** — define what triggers immediate blocking (specific file uploads, prohibited applications, time-of-day violations) and have it happen without human latency.
  * Enforce **emergency access revocation** for contractors, terminated employees, or compromised accounts across every Client at once.
  * Document **a complete incident-response audit trail** — who blocked whom, when, why, and from which Client.

  **Pair it with [Alerts](/docs/session-monitoring/alerts)** — alerts detect the trigger, blocking is the response. Together they're the full detect-and-stop pipeline.
</Info>

<Warning>
  **Windows Clients only.** User blocking is not currently supported on macOS or Linux Clients.
</Warning>

<Note>
  Blocking users requires the [administrative Client Installation and Management permission](/docs/administration/users/administrative-permissions). The **Block User** button is disabled for users already on the Blocked Users list and for administrators without this permission.
</Note>

## How blocking works

When you block a user — manually or via alert — three things happen:

1. **A warning message appears** on the user's Client desktop (for live sessions), and the desktop is blocked.
2. **After a configurable forced-logout time** (default: 15 seconds for live sessions), the user is forcibly logged out.
3. **The user is added to the [Blocked Users list](#the-blocked-users-list)**, either for the current Client only or for all Clients in the system.

If the user tries to log in again, they see: *"You have been blocked. Contact your system administrator."*

<Note>
  The Blocked Users list is stored on the Application Server. When you edit the list, every Client receives the update immediately. If a Client is offline at the time, it doesn't enforce blocking for new entries until the connection re-establishes — at which point it receives the latest list.
</Note>

## Block a user manually

<Frame caption="The Block User dialog from the live session — pick the blocking scope, set the forced-logout countdown, and optionally provide a custom message and reason.">
  <img src="https://mintcdn.com/syteca/FKrkO8bEqEQ6WSgs/images/session-monitoring/block-user-dialog.png?fit=max&auto=format&n=FKrkO8bEqEQ6WSgs&q=85&s=d71f76d183b966c0ae4da5dec1917ecc" alt="Block User pop-up showing On all computers / On the computer options, Forced logout time field, Message and Reason fields" width="1902" height="895" data-path="images/session-monitoring/block-user-dialog.png" />
</Frame>

Manual blocking is for the moment you're watching a session and need to stop what you're seeing — either it's live and you intervene in real time, or it's a finished session and you want to prevent the user from doing it again.

<Tabs>
  <Tab title="While viewing a live session">
    <Steps>
      <Step title="Open the live session">
        On the **Activity Monitoring** page, click the live session to open it in the [Session Viewer](/docs/session-monitoring/player/overview).
      </Step>

      <Step title="Click Block User">
        In the main **Session Player** pane, click the red **Block User** button at the top.
      </Step>

      <Step title="Set the blocking scope and options">
        In the **Block User** pop-up, configure:

        | Option                   | Effect                                                                            |
        | ------------------------ | --------------------------------------------------------------------------------- |
        | **On all computers**     | Block this user on every Client in the system. User is logged out of all of them. |
        | **On the computer**      | Block only on the current Client.                                                 |
        | **Forced logout time**   | Seconds before the forced logout. Default: 15 seconds.                            |
        | **Message** *(optional)* | Custom message displayed on the user's screen before logout.                      |
        | **Reason** *(optional)*  | Free-text reason for the block, shown on the Blocked Users list.                  |
      </Step>

      <Step title="Confirm">
        Click **Block**. The warning message and blocked desktop appear on the Client immediately; the forced logout follows after the configured time.
      </Step>
    </Steps>
  </Tab>

  <Tab title="While viewing a finished session">
    <Steps>
      <Step title="Open the session">
        On the **Activity Monitoring** page, click the session to open it in the Session Viewer.
      </Step>

      <Step title="Click Block User">
        In the **Session Player** pane, click the red **Block User** button at the top.

        <Note>
          If the user is currently logged in to a Client computer, the blocking process is the same as for live sessions — they see the warning, get the configurable forced-logout window, and are logged out.
        </Note>
      </Step>

      <Step title="Set the blocking scope">
        In the **Block User** pop-up:

        * **On all computers** — block on every Client in the system. The user is logged out of all of them.
        * **On the computer** — block only on the current Client.
      </Step>

      <Step title="Confirm">
        Click **Block**. The user is added to the Blocked Users list.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Block automatically when an alert triggers

The more powerful pattern: configure an [alert rule](/docs/session-monitoring/alerts) to automatically block the user the moment it triggers. No human latency — the response happens at machine speed.

<Steps>
  <Step title="Open the Alerts page">
    Sign in to the Management Tool as a user with the [Client Installation and Management permission](/docs/administration/users/administrative-permissions), then click **Alerts** in the left navigation.
  </Step>

  <Step title="Add or edit the alert">
    Click **Add Alert** in the top right, or click the **Edit Alert** icon next to an existing alert.
  </Step>

  <Step title="Assign Clients">
    On the **Edit Alert** page, scroll to the **Assigned Clients** (or **Assigned Client Groups**) section and add the Clients the alert applies to.
  </Step>

  <Step title="Configure the warning">
    Scroll to the **Actions** section. Select **Show warning message to user**, and optionally edit the warning text shown to the user.
  </Step>

  <Step title="Enable automated blocking">
    In the **Additional Actions** drop-down, select **Block user on all computers**.

    <Tip>
      "Block user on all computers" applies the broadest possible block — useful for high-confidence alerts. For lower-confidence cases, consider notification-only first, then add blocking once the rule is well-tuned to minimize false positives.
    </Tip>
  </Step>

  <Step title="Save">
    Click **Finish** in the bottom right.
  </Step>
</Steps>

Now, whenever a user on the assigned Client(s) triggers this alert, they're automatically blocked across all Clients — no human intervention required.

## What the user sees on a secondary-authentication Client

If a Windows Client has [secondary user authentication](/docs/administration/access/two-factor-authentication) enabled, the system blocks the **primary-secondary user combination**, not just the primary user.

The flow:

1. The user logs into the Client with their primary credentials normally.
2. The Secondary User Authentication login window appears.
3. The user enters their blocked secondary credentials.
4. The system rejects the secondary credentials with: *"You have been blocked. Contact your system administrator."*

The block applies only to that specific primary-secondary user combination — other secondary users using the same primary credentials (or vice versa) are unaffected unless they're also explicitly blocked.

## The Blocked Users list

<Frame caption="The Blocked Users list — central record of every block in effect, including the secondary-authentication primary(secondary) format and the Blocked By audit trail.">
  <img src="https://mintcdn.com/syteca/FKrkO8bEqEQ6WSgs/images/session-monitoring/blocked-users-list.png?fit=max&auto=format&n=FKrkO8bEqEQ6WSgs&q=85&s=90b911dd6cdb35c5b4567e3ce6378d89" alt="Blocked Users list grid showing user entries with domain, scope, who blocked them, date, reason, and per-row Remove icons" width="1495" height="406" data-path="images/session-monitoring/blocked-users-list.png" />
</Frame>

The Blocked Users list is the central record of every block in effect across your deployment — who's blocked, where, when, by whom, and why.

### Open the Blocked Users list

Click **Clients** in the left navigation, then click the **Clients** drop-down arrow at the top of the page and select **Blocked Users List** from the menu.

### The grid

| Column                           | Shows                                                                                                                                                            |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **\[Windows] User**              | The blocked user — formatted as `<Domain>\<User_name>`, or `<Domain>\<Primary_user_name>(<Secondary_user_name>)` for Clients with secondary user authentication. |
| **Blocked On**                   | A specific computer name, or "all computers".                                                                                                                    |
| **Blocked By**                   | The Syteca user who applied the block.                                                                                                                           |
| **Date**                         | When the block was applied.                                                                                                                                      |
| **Reason**                       | The reason text entered when blocking (if provided).                                                                                                             |
| **Remove** *(icon, per row)*     | Unblock this specific user.                                                                                                                                      |
| **Remove All** *(column header)* | Unblock every user on the list.                                                                                                                                  |

### Unblock users

When the user is unblocked, they can immediately log back into Clients again.

<Tabs>
  <Tab title="Unblock one user">
    <Steps>
      <Step title="Find the user">
        On the Blocked Users list, find the row for the user.
      </Step>

      <Step title="Click Remove">
        Click the **Remove** icon next to the user.
      </Step>

      <Step title="Confirm">
        Click **Remove** in the confirmation message.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Unblock all users">
    <Steps>
      <Step title="Click Remove All">
        In the column header on the right, click **Remove All**.
      </Step>

      <Step title="Confirm">
        Click **Remove** in the confirmation message.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Related

<CardGroup cols={2}>
  <Card title="Alerts" icon="bell" href="/docs/session-monitoring/alerts">
    Define the alert rules that can trigger automated blocking.
  </Card>

  <Card title="Alerts events tab" icon="siren" href="/docs/session-monitoring/alerts-events">
    Triage and update the status of every alert event.
  </Card>

  <Card title="Two-factor authentication" icon="smartphone" href="/docs/administration/access/two-factor-authentication">
    Secondary user authentication — how blocking applies to the primary-secondary combination.
  </Card>

  <Card title="Session Viewer" icon="play-circle" href="/docs/session-monitoring/player/overview">
    Where manual blocking starts — from the live or finished session you're viewing.
  </Card>
</CardGroup>
