> For the complete documentation index, see [llms.txt](https://gsfcorp.gitbook.io/macula/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gsfcorp.gitbook.io/macula/monitor-guide-v1.33.0/security-systems.md).

# Security Systems

{% hint style="danger" %}
Starting with the Macula 1.30, Access Controls are extended and replaced with Security Systems.
{% endhint %}

#### Overview

The extended interface includes the following:

* **Events**: Allow you to search through *Events*
* **Cardholders**: Show a list of imported *Cardholders* and allow you to review related *Events*
* **Doors**: Display imported *Doors*, show their state, and enable you to send commands
* **Zones**: Display information about imported *Zones*, show their state, and enable you to send commands
* **Partitions**:  Display information about imported *Partitions*, show their state, and enable you to send commands
* **Outputs**:  Display information about configured *Outputs*, show their state, and enable you to send commands
* **System**: Display connected *Security Systems*, their status, and connected events.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FyIQd2OGtu77013CYbN0u%2Fimage.png?alt=media&amp;token=827b2cf6-8ee7-44e1-a567-e5315f47aa91" alt="" width="563"><figcaption></figcaption></figure>

#### Events

The *Events* section under the *Security Systems* tab allows you to review, filter, and investigate through the security system-generated events. Section interface consists of:

* The Main subsection with the *Events list*
  * Display search results in a table format with columns:
    * Time
    * Event
    * Source
    * Cardholder
  * It allows you to select a particular entry and review its details in the right panel.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FKc0a0f1CZBCnCXQw0iEx%2Fimage.png?alt=media&amp;token=82f16739-38d0-41ba-8720-e453bc9fd015" alt="" width="563"><figcaption></figcaption></figure>

* The Right panel with the details of a selected entry
  * Provides information about the selected event on:
    * The connected *Channel* screenshot (if the channel is attached and has recordings)
    * *Cardholder* Image (if any) and connected *Events*
    * *Event Source*
    * *Event Type*
    * *Event Time*
  * The Button *View cardholder events* under the *Cardholder information* displays an *Event list* connected with the particular *Cardholder* entry.
  * The Button *View source events* under the *Time information* will bring all the *Events* connected with the particular *Item*.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FnPHg9dGlkPiZj0w2o5xl%2Fimage.png?alt=media&amp;token=530ec1aa-76d2-4210-bf52-9a6ee909dbde" alt="" width="225"><figcaption></figcaption></figure>

* The *Bottom panel* with the Search options:
  * The *Source* dropdown allows you to filter events by their source
  * The *Event* field is a free-form search by the event name
  * The *Cardholder* field is a free-form search by the Cardholder’s name
  * The *Search interval* field allows you to filter *Events* in two ways:
    * You can provide a *Relative time range* in days or hours
    * You can Provide a *Date and Time Interval* by adding start and end date and time

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FhmAFZxktiJziaI0nFHie%2Fimage.png?alt=media&amp;token=e038e580-91fe-4329-a970-0b7b670750a3" alt="" width="563"><figcaption></figcaption></figure>

After search is complete and you select particular event, you can export selected event by clicking the *Export* button.

Available options for the export format: XLS, PDF, CSV

#### Cardholders

The Cardholders section will:

* Show you a list of imported Cardholders inside the **Main subsection**.
* You can select particular Cardholders, review their information in the **Right panel**, and view all the connected **Cardholder** events by clicking the *View cardholder events* button.
* You can refresh the *Cardholders* list by clicking the *Refresh* button at the **Bottom panel**.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Fv6SiwGgAOhBoLb8YsbJs%2Fimage.png?alt=media&amp;token=10b51ca3-f24c-44a4-a9c4-fb7d5f90417c" alt="" width="563"><figcaption></figcaption></figure>

#### Doors, Zones, Partitions, and Outputs

*Doors, Zones, Partitions,* and *Outputs* sections provide similar functionality. You can:

* Review the list of *Source* items and their status inside the **Main subsection**.
  * Items statuses can be color-coded by setting corresponding statuses on the server side inside the Macula Console app
* Review and interact with the particular Item (door, zone, etc.) inside the **Right panel**:
  * At the top of the *Right panel*, you will see the Channel screenshot if it is attached to the item and has recordings
  * *Lock/unlock, Arm/Disarm,* etc., by clicking corresponding buttons under the *Channel* screenshot, depending on the selected item
  * Review selected Item *Source, Status, Last Updated time*
  * View all the events connected to the selected item by clicking the *View events* button at the bottom of the **Right panel**.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2Fcz50dLnJA7v7BhSbP5Hx%2Fimage.png?alt=media&amp;token=963cdc22-190a-4cec-8274-13c732616a38" alt="" width="563"><figcaption></figcaption></figure>

#### System

The *System* section has very similar functionality but reviews the configured *Security systems*.

* Inside the **Main subsection**, you can see the list of configured *Security systems* under the *Source* column and *Security system status* (Connected, Disconnected, etc.) under the *Status* column.
* The **Right panel** Provides:
  * Connected channel screenshot (if assigned)
  * Contextual buttons if the system allows any requests
  * Information about the particular system *Source, Status,* and *Last update time*
  * The *View Events* button will bring the list of all the connected events.

<figure><img src="https://412599993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeNXnJx0OpvxnmpWqOBNm%2Fuploads%2FU3vDpeEXeL60DWBWX1NR%2Fimage.png?alt=media&amp;token=db723895-83e8-42ac-aa6e-8862c219a95c" alt="" width="563"><figcaption></figcaption></figure>

#### Maps

Apart from the dedicated *Security systems* sections in Macula Console and Macula Monitor applications, it is also possible to place *Security Item Markers* onto *Maps* – either regular ones or geo maps. *Markers* on the map reflect available Security system's *Item* state. If such maps have been configured on the server, they will be available in the corresponding section on the left, in the *Resources* panel.

In the Macula Monitor application, place your *Map* into one of the *Viewports* either by dragging and dropping it or by pressing the … button next to the map *Title* and choosing the destination display.

Each Security system's *Item* Marker will reflect status according to the settings defined in the map configuration. Also, **every Security Item Marker can be left-clicked** to bring up a drop-down menu with associated *Item* actions, that will depend on your Security system capabilities and configuration.