Velocity Integration with Bosch Intrusion Detection System (IDS)

Bosch Intrusion Detection System

The Bosch IDS plugin acts as an interface to the following models such as B4512, B5512, B6512, B8512, and B9512. It fetches panel information, executes panel/area/point/output commands, monitors events/alarms, and displays the same in Velocity.

Bosch IDS Panel System Requirements in Velocity

The following lists the required configuration:

Software

Version

Software

Version

Velocity

3.8.3.3284 or higher

Velocity IDS Framework

1.0.0.146

Bosch IDS Plugin

1.0.3.198

Licensing

Licensing Velocity Integration and Bosch IDS Plugin

Prerequisites

To obtain a Bosch IDS plugin license, you will need a licensed Velocity 3.8.6 and a personal computer with email access so you can provide Identiv with information about your Velocity system and receive a license key.

  1. Contact the Identiv Sales department to purchase a license for “Velocity IDS Plugin - Bosch”

  2. They should ask you to send them an email message containing the Server ID of your Velocity Server (exchanging this information via email instead of by phone ensures receiving the license key). The Server ID is obtained from the Velocity License Manager.

    1. Open the Velocity License Manager

      1. If the Velocity Service Control Manager icon is displayed in the Windows taskbar, right-click on it and choose Velocity License Manager from the pop-up menu

        If the Velocity Service Control Manager icon is not displayed in the Windows taskbar, click the upwards-pointing triangle on the left side to show the hidden icons for additional programs.

  3. Click the button after the Server ID to copy that information, and then paste it into an email message to Identiv so that we can create your license key. If you don’t have email access on the Velocity Server, you can paste the information into a text file and transfer it between computers.

  4. Close the Velocity License Manager

  5. After you receive an email containing your license key, copy all the characters between the -- License Key Start and the -- License Key End -- lines.

    If the Velocity Server is on a different computer, paste your license key into Notepad, save it as a text file, and transfer it between computers. Ensure that the word wrap option is turned off, indicated by the absence of a checkmark in front of the Format ▶ Word Wrap command.

  6. Paste the complete license key information into the Add / Renew License pane and click the Add / Renew button

  7. The “License value has been updated successfully” dialog displays

  8. Click OK to close this dialog and verify that the Velocity License Manager shows a new row of information about Velocity IDS Plugin-Bosch

  9. Licensing of the Velocity IDS Bosch plug-in is now completed so that you can close the Velocity License Manager

The license key is only valid on the computer with the specified Server ID; it cannot be used on a different computer.

Installation

Installing Bosch IDS Plugin

Prerequisite: To install the Velocity IDS Bosch plugin, the user must be logged into Windows using an account that has local  Administrator privileges, must be a member of the Velocity Administrators Role, have an active license for the integration, know the name and password of the Velocity Services Account (specified when Velocity was installed).

  1. Close the Velocity application

  2. Run the Bosch IDS Plugin. The IDS framework gets installed along with the Bosch IDS plugin.

  3. The installer displays various status messages while the installation proceeds

  4. Click Yes to back up the database

  5. Click Yes to start the services after the update completes

  6. Click Yes to start Velocity when the Update completes

     

     

  7. When the following screen is displayed, type in the name and password of the Velocity Services Account and click the OK button. The name and password of the Velocity Services account were specified when Velocity was installed.

The default Velocity Services account is named “VelocityServices.” Be sure to ”prefix the account name with “.\” to specify it as a local account. For example: .\velocityservices

To verify that the name and password you entered for the Velocity Services account were correct, try to start the new service by right-clicking on the Velocity Service Control Manager icon (while the other Velocity Services are running) and choosing Start Velocity IDS Service from the pop-up menu.

To confirm the successful installation of IDS services

  1. Open Velocity application. Select Event Viewer and scroll down to check IDS Service Online software event is generated

Bosch IDS Panel

Remote Procedure Software (RPS) Configuration

To communicate with Velocity, the panel must first be configured using the Bosch RPS tool to set the Automation Device and Automation password properties.

  1. In RPS Menu, navigate to Automation/Remote App > Automation Device

  2. In the Automation Device screen, select Mode 2 from the options to be the Data Value and click OK

Adding a Bosch IDS Panel

The Bosch IDS panel must be configured with a valid IP Address, Port, and Automation Passcode.

  1. Launch Velocity and navigate to Administration > Interfaces Configuration > Velocity Integrations > IDS Integration

  2. Double click Add new IDS Panel…

The Add New Panel screen is displayed.

  1. Enter the Name, Vendor, Model Type, Time zone, IP Address, Port, and Automation Passcode

  2. Click OK
    After the new panel is added, the Areas, Points, and Outputs are automatically displayed and populated below the panel.

Monitoring Bosch IDS Panels

The Bosch IDS panel status displays the current status of all connected panel areas, points, and outputs. The mapped IDS events and the generated alarms can be monitored from Event Viewer or Graphics.

Bosch IDS Panel Areas

Areas in the IDS Panel define a group of points. The IDS Areas folder displays the areas defined in the Bosch Panel.

In the Administration menu, navigate to Interface Configuration > Velocity Integrations > IDS Integration. Select your IDS Panel to see the Areas.

  1. Right-click on an area to view the list of supported commands

    The events include all alarms that are notified based on the configured areas. The table lists the supported event command types with descriptions.

Command

Description

Command

Description

Silence Bells

Allows to silence the alarm bell generated by an event

Activate Bells

Allows to activate the alarm bell caused by an event

Disarm

Allows to Disarm (OFF)

All on Instant

Turns on all points with no entry or exit delay

All on Delay

Turns on all points with entry or exit delay

Part on Instant

Turns on only some of the points with no entry or exit delay

Part on Delay

Turns on only some of the points with entry or exit delay

Force All on Delay

Forces all points to turn on with entry or exit delay

Force All on Instant

Forces all points to turn on with no entry or exit delay force

Force Part on Delay

Forces only some of the points to turn on with entry or exit delay

Force Part on Instant

Forces only some of the points to turn on with no entry or exit delay

Stay One Arm

Arm in stay mode

Away Arm

Arm in away mode

Force Stay One Arm

Force arm in stay mode

Force Away Arm

Force arm in away mode

Reset Sensors

Resets the sensors in the area from a previous action and returns to normal operation

Bosch IDS Panel Points

Points refer to single points such as doors, windows, fire detection sensors, etc. A group of points comprises an area such as the lobby, conference room, etc. 

  1. In the Administration menu, navigate to Interface Configuration > Velocity Integrations > IDS Integration.  Select your IDS Panel to see the Points

  2. Right-click configured areas to view the list of supported commands

The table lists the supported command types:

Command

Description

Command

Description

Bypass Point

Bypasses the selected point

Unbypass Point

Un-bypasses the selected point

Bosch IDS Panel Outputs

Outputs in IDS refer to automatic control of devices in areas such as entry/exit gates or lighting in secured zones.

The table lists the supported command types.

Command

Description

Command

Description

Control Output ON

Turns the output relay ON

Control Output OFF

Turns the output relay OFF

Status Viewer

The Status Viewer allows you to view the status of Panels, Areas, Points, and Outputs.

Viewing IDS Panel Objects in Status Viewer

  1. Select Status Viewer from the Main menu

  2. Click Configure Status Group

  3. Enter the Status Group name In the Status Viewer Properties window

  4. From the Filter drop-down list, select the type of component you want to include in this status group. The 'Available' pane is populated with all devices/points corresponding to the filter chosen.

  5. Click the right arrow to move the highlighted components in the 'Available' pane to the 'Selected' pane

  6. Click OK to save and return to the Status Viewer

    1. The Status Viewer displays the status of the component that is added online through Battery status and AC Power status

    2. The Status Group for the corresponding Areas displays as shown

    3. The Status Group for the corresponding Points displays as shown

    4. The Status Group for the corresponding Outputs displays as shown

Graphics Viewer

The Velocity Graphics module provides a visual interface for interacting with IDS Panels, Areas, Points, and outputs. Graphics supports two different kinds of IDS Objects:

  1. Traditional VIO IDS-related objects (Panels, Area, Points, and Outputs)

  2. The new IDS Area construct allows you to draw a representation of an IDS Area on a map to monitor the associated IDS Area’s Arm and Secure states

VIO objects allow you to plot specific IDS objects (panels, areas, points, and outputs) to monitor and control the Velocity Alarm state and execute device-specific commands. The Velocity Alarm state is the same as shown in the Velocity Alarm Viewer, and you may Acknowledge and Clear Velocity alarms from VIOs just like you can from the Velocity Alarm Window.

Difference between an IDS Area VIO object and an IDS Area

To illustrate the difference between an IDS Area VIO object and an IDS Area, consider the following example:

An IDS area goes into alarm, and a Velocity Alarm event is displayed in the Velocity Alarm Viewer. The associated IDS Area VIO object in Graphics animates to show that the VIO is in an alarm state. The operator may then acknowledge and clear the Velocity Alarm from either the IDS Area VIO or the Velocity Alarm Viewer. However, the secure form of the IDS Area constructs remains in alarm until the alarm is cleared from the IDS panel (usually from the IDS keypad).

Plotting IDS VIO Objects

To place Velocity VIO Objects on a drawing:

  1. Select the Object Library check box in the Main menu and the Object Library pane displays

  2. Expand the Topology folder till you reach the underlying panel, area, points, and output components are displayed

  3. Drag the required component from the selected folder to the drawing and carefully position them at the correct location

    If required, you can modify other features of the objects by right-clicking on the object.

The options in the pop-up menu:

  • Delete: Removes the velocity object from the drawing area

  • Set as Primary: The Velocity objects in the map are automatically enabled when set as primary. For example, if you place area 1 on three maps, you can set area 1 as the primary.  Then, if area 1 detects an illegal entry, area 1 automatically appears on the canvas with the area 1 alarm icon displayed.

  • Configure Device…: This allows you to bring up the corresponding configuration screen for that device.  For example, if you select this option for a reader, the Reader Properties screen for that reader appears.

IDS Area

The IDS Area feature allows you to visually represent an IDS Area by drawing it on a map. The IDS Area visually displays the Area’s Arm State and the Area’s Secure state. The border of the IDS Area represents the Arms State, and the inside of the IDS Area represents the secure state. You can color code all supported Arm States to identify how the area is armed quickly and visually.

Creating IDS Area

  1. Click Graphics in the Main menu

  2. In design mode, click Design > Draw and select IDS Area

  3. Draw the desired area on the map

  4. The Map IDS constructs a specific IDS panel Area and configures the IDS Area border and interior as shown

     

Interacting with IDS VIO Objects and IDS Area Constructs

In Graphics mode, right-click anywhere on the selected IDS Area construct and execute the desired IDS Area command as shown.

In Graphics mode, right-click on the selected IDS Area VIO and execute the desired command as shown.

Right-click to select IDS Point and execute the command in the map as shown.

Right-click to select IDS Output and your desired command as shown.

Roles and Permissions

The Roles in Velocity streamline the process of assigning rights and privileges to operators by the Velocity server.

Adding Role based Operator to access IDS Panels, Areas, Points, and Outputs

  1. Login as Velocity Superuser in Velocity Server

  2. Navigate from Main Menu > Administration > Roles > Operators

    The Role Operators window displays.

  3. Select Application Permissions > IDS Panels and enable the role for the desired functions (Add/Delete/Save/View). The operator must have view permission to access the IDS panel and perform any operation.

  4. To give specific access, select IDS Panels, IDS Areas, IDS Points, or IDS Outputs individually

Restricting Alarms and Events using Velocity Roles

The Velocity settings have an option to restrict alarms and events based on operator roles in Velocity. To enable this option:

  1. Right-click the Velocity Service Control Manager icon on the Windows taskbar and select Settings
    The Velocity Settings window displays.

  2. Go to System > Advanced in Velocity Settings

  3. Enable Restrict alarms and events using the Velocity Roles checkbox and click OK

Limitation

The Bosch IDS plugin has the following limitation.

  • When changes to the Area/Point/Output names of the IDS panel occur through the RPS tool, the new names will not appear in Velocity until the IDS panel has reconnected to Velocity. The workaround is disabling and re-enabling the panel or restarting the Velocity IDS service.