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

# Security

> Monitor security events and manage the IP blocklist for your organization.

The **Security Dashboard** gives you visibility into authentication and access
events across PayPunch, and lets you block abusive IP addresses. Use it to spot
failed-login spikes, rate-limit hits, and other suspicious activity.

<Frame>
  <img src="https://mintcdn.com/paypunchio/_OTBJVy9gfwbmkZA/images/admin/security.png?fit=max&auto=format&n=_OTBJVy9gfwbmkZA&q=85&s=573a88c0d389688430cf03a3a4d2de36" alt="Security dashboard" width="1440" height="900" data-path="images/admin/security.png" />
</Frame>

## The Security Dashboard

Open **Security** from the sidebar. Four cards summarize activity: **Total
Events**, **Critical Events**, **Blocked Events**, and **Failed Logins**. Click
**Refresh** to pull the latest.

## Recent security events

The **Recent Security Events** list shows each event's **severity** (Critical,
High, Medium, Low), **type**, whether it was automatically **BLOCKED**, the
**message**, the source **IP address**, the **endpoint**, and a timestamp.

Filter the list by **Severity** (All / Critical / High / Medium / Low) and by
**Type** (Failed Login, Rate Limit, Invalid Token, Auth Failed, CSP Violation).

## Block an IP address

<Steps>
  <Step title="Open the block form">
    Click **Block IP** to reveal the **Block IP Address** form.
  </Step>

  <Step title="Enter the details">
    Provide the **IP Address**, a **Reason**, and an optional **Duration** in
    minutes. Leave the duration blank for a permanent block.
  </Step>

  <Step title="Block">
    Click **Block IP**. The address is added to your **Blocked IP Addresses** list.
  </Step>
</Steps>

## Manage blocked IPs

The **Blocked IP Addresses** section lists each blocked address with its reason,
when it was blocked, and when the block expires. Click **Unblock** to remove an
address from the list.

<Warning>
  Blocking an IP prevents anyone behind it from reaching PayPunch. Double-check the
  address before applying a **permanent** block, and prefer a timed duration when
  you're unsure.
</Warning>
