RISCO Group Application Server User Manual
RISCO Cloud
RISCO Application Server
Web Administration Manual
For more information about the control panels that are supported by RISCO Cloud
please refer to our website: www.riscogroup.com
Table of Contents
1. Introduction ................................................................................................................................................................................ 1
1.1. Related Documents ................................................................................................................................................ 1
1.2. Abbreviations .......................................................................................................................................................... 1
2. Overview ..................................................................................................................................................................................... 2
2.1. System Architecture ................................................................................................................................................ 3
2.2. The Web Administration Application ....................................................................................................................... 3
3. Login ............................................................................................................................................................................................ 4
3.1. Login Access Level ................................................................................................................................................. 4
3.2. Logging Into the Web Administration Application ................................................................................................... 5
3.3. Logging Out............................................................................................................................................................. 5
4. Web Admin/WEB RP User Management................................................................................................................................... 6
4.1. Adding a New User ................................................................................................................................................. 7
4.2. Editing an Existing User .......................................................................................................................................... 8
4.3. Filtering by RP User Assigned to Group Option...................................................................................................... 9
4.4. Deleting a User ....................................................................................................................................................... 9
5. Service Providers List .............................................................................................................................................................. 10
5.1. Adding a New Service Provider ............................................................................................................................ 11
5.2. Editing an Existing Service Provider ..................................................................................................................... 13
5.3. Deleting a Service Provider ................................................................................................................................... 13
6. Control Panels List ................................................................................................................................................................... 14
6.1. Adding a New Control Panel ................................................................................................................................. 14
6.2. Editing an Existing Control Panel .......................................................................................................................... 16
6.3. Deleting a Control Panel ....................................................................................................................................... 17
6.4. Additional Control Panel Options .......................................................................................................................... 17
7. Control Panels Groups ............................................................................................................................................................ 26
7.1. Creating a Control Panel Group ............................................................................................................................ 26
7.2. Managing Control Panels Groups ......................................................................................................................... 27
8. System Status Tools ................................................................................................................................................................ 29
8.1. Statistics ................................................................................................................................................................ 29
8.2. Database Services Information ............................................................................................................................. 31
9. E-mail Template Editor............................................................................................................................................................. 32
10. SMS Template Editor................................................................................................................................................................ 35
11. Licenses .................................................................................................................................................................................... 36
12. General Configuration Options ............................................................................................................................................... 38
12.1. RISCO Cloud Common Parameters ..................................................................................................................... 38
12.2. Event Groups Enable/Disable ............................................................................................................................... 42
ii
13. Customization ........................................................................................................................................................................... 46
13.1. Editing Text ........................................................................................................................................................... 46
13.2. Editing Tip of the Day Texts .................................................................................................................................. 48
13.3. Adding Customized Logos and Images ................................................................................................................ 48
13.4. Modifying the Icon Text ......................................................................................................................................... 50
13.5. Modifying the Hints ................................................................................................................................................ 51
13.6. Modifying the Web User Application Color Scheme ............................................................................................. 52
13.7. Managing Files on the Web User Application’s Downloads Page ........................................................................ 53
13.8. WUApp Translations Page.................................................................................................................................... 54
13.9. Messages, Remarks and Terms of Use ............................................................................................................... 58
Appendix A: Event Table ................................................................................................................................................................... 59
Appendix B: E-mail Notification ........................................................................................................................................................ 63
iii
1 Introduction
1. Introduction
This guide provides information regarding the RISCO Application Server (RISCO Cloud) and
instructions on how to use the Web Administration application. The target audience for the guide is
personnel responsible for RISCO Cloud administration. The principle purpose of this guide is to
provide the reader with the information necessary to manage RISCO Cloud admin and WEB Based
RP users, customers (subscribers) and service providers.
If you have any questions concerning any of the procedures described in this guide please contact
RISCO Group at (+972-3) 963-7777.
1.1. Related Documents
(UL Note: All security systems working with RISCO Cloud are subject to UL approval).
The Agility 3 User & Installer manuals provide additional information on some of the subjects
addressed in this guide.
1.2. Abbreviations
The following abbreviations are used throughout the guide:
Abbreviation Meaning
CP
CPNS
CPWS
CSR
Proxy
GPRS
GPRS Proxy
IIS
ISP
RISCO Cloud/Proxy
RISCO Cloud
PSTN
RP
Control Panel, or Security Panel. In some manuals, term Control System is also used.
Control panel Notification Service
Control panel Web Service
Central Station Receiver
RISCO Proxy Server
General Packet Radio Service
A server installed as part of RISCO Cloud topology responsible for the
communication with the GPRS based security panels.
Internet Information services
Internet Service Provider
RISCO Application/Proxy Server
RISCO Application Server
Public Switched Telephone Network
Remote Programmer application (for programming control panels)
SIA
SP
WAApp
WUApp
RISCO Cloud Web Administration Manual
Security systems event reporting protocol
Service Provider – refers to monitoring stations serviced by RISCO Cloud
Web Administrative Application (Administrator Access to RISCO Cloud)
Web User Application (Security Systems Users connected to RISCO Cloud).
1
2 Overview
2. Overview
RISCO Application Server (RISCO Cloud) is the central component of RISCO’s Web based service
platform. Implementing secure TCP/IP network connectivity, RISCO Cloud provides high-speed
central station reporting via a broadband interface.
The predominant role of the RISCO Cloud is to handle and manage communications between
security systems installed in the homes and businesses of subscribers and multiple alarm
monitoring service providers. In addition to event reporting, RISCO Cloud enables the security
system to be programmed and controlled via the Web by means of a number of Web applications
and utilities.
RISCO Cloud
Figure 2-1: System Architecture
The main components of the system are:
• RISCO Cloud/Proxy – application/proxy server responsible for connection between
end-users’ control panels1 and service providers, for system management, and data
transfer to the central station's alarm monitoring system
• Agility 3 – security panels with GSM/GPRS, IP or PSTN connection.
1
Please note that Control Panel, Security Panel, and Control System terms refer to the same notion.
2
RISCO Cloud Web Administration Manual
2 Overview
2.1. System Architecture
The security control panel, installed in the home or business of the subscriber, provides the interface
to a wide range of encrypted wireless peripherals and household appliances. The control panel
communicates with RISCO Cloud via broadband or wireless GPRS connection to the Internet.
Event messages are forwarded to the monitoring service’s central station. backup communication is
provided to a traditional receiver at the monitoring service. The proxy server Risco Cloud/Proxy
forwards events to the central station’s management software application.
Additionally, monitoring, control and programming of the remote premises security systems can be
performed from RISCO Group’s Smartphone application (iRISCO) or a PC with an Internet
connection.
2.2. The Web Administration Application
The Web Administration application is the main administrator interface with RISCO Cloud and
offers the following features
• Web Administration and Web RP user management
• Service Provider configuration
• Control panel record configuration
• Web User application customization features
• RISCO Cloud configuration features
• Control panels Groups configuration
• Event forwarding email and SMS template editing
The user can access the Web Administration application from a standard Web browser (Internet
Explorer version 6.0 and above with JavaScript support).
In addition to the configurable options listed above, the Web Administration application also
displays statistics regarding the current status of the system; for example, offline control panels and
panels with a trouble condition, and database status information. RISCO Cloud provides additional
status notification to the administrator via email. For further details on the content of these email
messages, see Appendix B: E-mail Notification.
RISCO Cloud Web Administration Manual
3
3 Login
3. Login
To begin a session, the Web Administration application requires that the user logs in.
3.1. Login Access Level
The Login Access Level is the authorization granted to the Web Administration Application user.
There are five types of access levels available for Administrator accounts:
Table 3-1: Login Access Levels
Access Levels Available Options
Role
Administrator Full Access WAApp: Management of all data in RISCO Cloud WAApp
Customer Data
Change Only
Remote
Programmer
Read Only
Panel Registrar
Supervisor
Operator
Technician
WAApp: Modifying data that is related to CP owners in Control Panel
Update page only.
WAApp: Reading data but no data management.
WAApp: Access to the CP list for panel registration.
WAApp:
1
Control Panels
service Providers.
Users: Allocating users to CP groups and updating user details.
WEB RP: Full Access
WEB RP: Has restricted access to the General frame of the Web RP
where only the CP ID and the SW versions of the CP modules are
displayed.
Monitor: Arming/Disarming, seeing the registered devices' status,
bypassing/unbypassing of the zones.
WAApp: No Access
WAApp: No Access
Web RP: The same access level as the Supervisor, but no access to the
User Management frame (user names and the passcodes).
: Adding new CPs and assigning CPs to groups and
1
The Remote Programmer has access to manage only the associated Control Panels based on the “WEB RP Users and
Control panels assignment groups” membership. Complete access to the CP data is provided, with only one restriction:
no option to select Service Provider that has no relation.
4
RISCO Cloud Web Administration Manual
3 Login
3.2. Logging Into the Web Administration Application
To log into the Web Administration application:
1. Enter user name and password.
2. Click Login; the Main page is displayed.
Figure 3-1: Main Page
The Main page displays the details of the current user. At the top of the page, there is a menu
offering links to the various pages of the application.
3.3. Logging Out
To log out of the Web Administration Application:
Click Log Out; you are automatically returned to the Log In page.
RISCO Cloud Web Administration Manual
5
4 Web Admin/WEB RP User Management
4. Web Admin/WEB RP User Management
On the Users List page, you can view the list of users who are authorized to enter the Web
Administration application or the Web Remote Programmer (RP) application.
For RP users, there is an option to display the list for each group of panels specifically.
Figure 4-1: Users List
Table 4-1: User Fields description
Column
Select If selected, the WEB RP User can be allocated to a Control panel Group*.
Login ID The user name that is entered when logging in.
Role The type of user. The role can be Administrator (RISCO Cloud operator
Access Level The authorization level of the user. Various authorization levels are
First/Middle/Last Name User's personal details for identification purposes.
Phone User’s telephone number for reference purposes.
Last Update The date when the user’s details were last edited.
Updated By The RISCO Cloud WAApp operator who last updated the user’s details.
Associate If one of the WEB RP users were selected in the list, the operator can
Display List Filtering The users display list can be filtered by selection of the list length on the
Description
for Web Administration application user), Remote Programmer (RP
user), or CMS user (for Central Monitoring Station)
available for each role.
(If Deleted displayed in the Update By column, meaning this
Administrator User was deleted from the RISCO Cloud DB)
Choose a Control Panel Group and Associate the selected Users to this
Group (for more information, see, Control Panels Groups
foot of the page on the right, or by selecting the User Role for display
from the dropdown list on the top of the table.
For more information, see, Control Panels Groups
6
RISCO Cloud Web Administration Manual
4 Web Admin/WEB RP User Management
4.1. Adding a New User
To add a new user:
1. On the Users List page, click New User (located at the foot of the list); the User Update
page is displayed.
Figure 4-2: New User Page
2. Enter the new user’s login ID, password (twice) and personal details in the appropriate
fields.
The User ID is automatically assigned once the new user is saved in the system.
3. Choose the new user’s role and access level.
Panel Registrar access level allows only panel registration – see Figure 4-3
Figure 4-3: New User Page – Control Panel Registrar
If the RISCO Cloud administrator grants Supervisor access level to a Remote Programmer, the
Remote Programmer acquires access to WebRP and WAApp, therefore allowing him to assign
control panels to groups and service providers as well as add new panels – see Figure 4-4.
RISCO Cloud Web Administration Manual
7
4 Web Admin/WEB RP User Management
Figure 4-4: New User Page – Remote Programmer with Supervisor access level
4. Click OK to update and return to the Users List
– Or –
Click Apply to update and remain on the User Update page.
Mandatory fields are indicated by an asterisk (*).
4.2. Editing an Existing User
To edit the existing user's details:
1. On the Users List page, click the Login ID Name of the user you wish to edit (colored in
blue); the User Update page is displayed.
2. Edit the user’s details as required.
3. Click OK to update and return to the Users List
– Or –
Click Apply to update and remain on the User Update page.
8
RISCO Cloud Web Administration Manual
4 Web Admin/WEB RP User Management
4.3. Filtering by RP User Assigned to Group Option
If the operator chooses to filter the Users Display list by the RP User Assigned to Group option, two
new options, relevant for this display only, will appear on the foot of the page in addition to
Associate, as displayed below.
Figure 4-5: Filtering by RP User Assigned to Group display
• Associate – When the operator wishes to associate one or several WEB RP users from
one group with another group, too, the relevant users will be selected from the
displayed list, the new group will be selected from the dropdown list, and associate
button will be pressed. Now the WEB RP users will be associated with the new group
as well.
• Transfer – If the operator wishes to transfer WEB RP users between groups, the above
procedure will be executed, and Transfer button will be pressed instead of Associate,
thus deleting the WEB RP users from the previous group, and transferring them only
to the newly chosen group.
• Remove – If the operator wishes to remove WEB RP user from a group, the relevant
user or users will be selected, and pressing the Remove button will remove those
users from this list.
The WEB RP users won’t be deleted from the RISCO Cloud database, but only
removed from the association with the group.
4.4. Deleting a User
To delete a user:
1. On the Users List page, click the Login ID of the user you wish to delete; the User Update
page is displayed.
2. Click Delete and then OK; the user is deleted.
RISCO Cloud Web Administration Manual
9
5 Service Providers List
5. Service Providers List
The Service Providers list displays all of the current service providers that are configured for RISCO
Cloud. After an event is received from a control panel, the event data is forwarded to the Proxy of
the service provider which is, in turn, passed on to the service providers monitoring software. The
Service Providers page comprises a list of the service providers that are available for allocation to
each customer (i.e. each control panel). In the certain countries, a common service provider will be
responsible for all events and will be so entered in this screen.
Figure 5-1: Service Providers Page
Table 5-1: Service Providers Columns/Fields
Column/Field
Provider Name The name of the service provider.
Provider Type The Type of the service provider: Proxy or IP SIA CSR.
Last Update The date when the service provider’s details were last edited.
Updated By The person who last updated the service provider’s details.
Default Provider Option to assign a default service provider in cases when multiple
Description
service providers are used.
10
RISCO Cloud Web Administration Manual
5 Service Providers List
5.1. Adding a New Service Provider
To add a new service provider:
1. On the Service Providers List page, click New Service Providers (located at the foot of the
list); the New Service Provider page is displayed.
Figure 5-2: New Service Provider Page
2. Enter the new service provider’s details in the appropriate fields. The available fields are
described in the table following this procedure.
3. Click OK to update and return to the Service Providers List.
– Or –
Click Apply to update and remain on the Service Provider Update page.
Mandatory fields are indicated by an asterisk (*).
Table 5-2: Service Providers Fields
Field Description
Provider ID The serial number of the Service Provider that is allocated
automatically when the Service Provider is registered in
RISCO Cloud.
Provider Name The name of the service provider.
Description A short description of the service provided.
Location A description of where the service provider is located.
Contact Name General details for future reference.
Contact E-mail General details for future reference.
SP Type
Service Provider Type – Choose from the dropdown list the
type of the service provider. The Proxy Provider – emulating
events in event reporting protocol to PSTN CSR or SIA IP
Receiver Provider (CSR) which receives the events in SIA
protocol using TCP/IP communication.
RISCO Cloud Web Administration Manual
11
5 Service Providers List
Field Description
Login ID The name used for identification when RISCO Cloud attempts
to forward an event, used for security and authentication
method, for Monitoring Station control of RISCO Cloud event
reporting.
CSR Host IP address of the service provider.(only applicable to SIA lP)
CSR Port
CSR Protocol
Account Prefix
Receiver Number
Report Attempts
Other Settings
Password The password used for authentication when RISCO Cloud
RSICO Cloud/Proxy
URL 1 & 2
Last Update/By Last time the service provider fields were updated and details
Port number of the service provider.(only applicable to SIA IP)
Communication connection protocol used by the service
provider.(only applicable to SIA IP)
Prefix number used by the service provider.(only applicable to
SIA IP)
Receiver number used by the service provider.(only applicable
to SIA IP)
Number of times RISCO Cloud will attempt to report to the
service provider before a report “report failed” event is
triggered (only applicable to SIA IP)
Enable/ disable the reporting of guard code usage and
arm/disarm control panel events to the service provider
forwards an event. If a password is required (this is defined by
the Proxy application), enter the password again in the
Confirm Password box. If no password is required, select the
Blank Password check box. The password must be between 6
and 16 characters and must begin with a letter.
The URL of the two RISCO Cloud/Proxy servers (1 = Primary,
2 = Backup). It is possible to enter one URL if no backup is
required.
of the user/administrator that performed the changes
5.1.1. Editing the Service Provider’s Event List
Each service provider has an Event List used to filter the events that are sent from RISCO
Cloud/Proxy to the monitoring station. When a control panel sends an event to the RISCO Cloud,
only events that are enabled in the service provider’s Event List are forwarded to the control
panel’s service provider. For a complete list of events included in the Event List, refer to
Customization.
In case of the CMS connection failure, the end user notification will be repeated three
times.
To edit a service provider’s Event List:
1. On the Service Provider Update page (see, Adding a New Service Provider), click Event
List; the Event List page is displayed.
To edit a service provider’s Event List, you must first create the Service Provider. It is
not enough to enter the mandatory fields in the Service Provider Update page; you
must also click Apply before you can access the Event List.
12
RISCO Cloud Web Administration Manual
5 Service Providers List
Figure 5-3: Service Provider Event List
2. Using the checkboxes located on the right hand side of the list, select the events that the
RISCO Cloud/Proxy shall forward to the service provider.
By clearing the checkbox the user disables event forwarding to the service provider,
but not the end user SMS notification.
Clicking a column label sorts the event list according to ID, Event Name or the Event
Group to which the event belongs. Two checkboxes located at the bottom of the table
allow you to select or clear all checkboxes simultaneously.
3. When you have finished configuring the Event List, click Update to return to the Service
Provider Update page.
5.2. Editing an Existing Service Provider
To edit an existing service provider:
1. On the Service Providers List page, click the Provider Name of the service provider you
wish to edit; the Service Provider Update page is displayed.
2. Edit the service provider’s details as required.
3. Click OK to update and return to the Service Providers List.
– Or –
Click Apply to update and remain on the Service Provider Update page.
5.3. Deleting a Service Provider
To delete a service provider:
1. On the Service Providers List page, click the Provider Name of the service provider you
wish to delete; the Service Provider Update page is displayed.
2. Click Delete; the following dialog box appears.
3. Click OK; the service provider is deleted.
RISCO Cloud Web Administration Manual
13
6 Control Panels List
6. Control Panels List
The Control Panels List is an inventory of the customers’ control panels. A control panel must
appear in the list in order to be recognized by RISCO Cloud.
To view the Control Panels List:
1. Open the Control Panels List page.
2. Select the Control Panel Group you wish to view (for more information about Control
Panels Groups see Control Panels Groups).
3. Choose the appropriate search filters for the control panels you wish to view.
4. Click Find; the required entries in the Control Panels List are displayed.
Figure 6-1: Control Panels List Page
6.1. Adding a New Control Panel
To add a new control panel:
1. On the Control Panels List page, click New Customer; the Control Panel Update page is
displayed.
2. Enter the new customer’s details in the appropriate fields. The available fields are
described in the table following this procedure.
3. Click OK to update and return to the Control Panels List.
–Or–
Click Apply to update and remain on the Control Panel Update page.
14
RISCO Cloud Web Administration Manual
6 Control Panels List
Figure 6-2: New Control Panel Page (Self Registration enabled)
Figure 6-3: New Control Panel Page (Self Registration disabled)
Table 6-1: Control Panel Update Page
Field Description
Control Panel ID The serial number of the control panel that is allocated automatically
when the customer is created.
ISP Account Number The customer’s account number at the ISP/Cable provider used for
billing purposes (only applicable when the Self Registration option is
disabled).
CP Login ID Used by the control panel for identification when connecting to RISCO
Cloud. This parameter must be identical to the CP ID programmed at
the control panel. To edit this field, click the Change button to the right
of the field then click OK in the confirmation dialog box. The
maximum number of characters you should enter for the CP ID is 16.
CP Password Used by the control panel for authentication when connecting to
RISCO Cloud. This parameter must be identical to the CP Password
programmed at the control panel. The maximum number of characters
you should enter for the CP Password is 16.
CP Confirm Password Confirmation field for the CP Password.
Web Login ID The customer’s login name that they must enter when they log in to the
Web User Application (only applicable when the Self Registration
option is disabled).
Web Password The customer’s password that must be entered when they log in to the
Web User Application. The maximum number of characters you
should enter for the Web Password is 16 and the password must begin
with a letter (only applicable when the Self Registration option is
disabled).
RISCO Cloud Web Administration Manual
15
Field Description
Web Confirm
Password
Confirmation field for the Web Password (only applicable when the
Self Registration option is disabled).
6 Control Panels List
First/Middle/
Last Name
Cell Phone/E-mail Additional customer information for reference purposes (only
Time Zone The UTC offset and time zone in which the control panel is located.
Current IP IP address of the control panel (this parameter is displayed after the
Last Update/By
Last Connect Time Last time the control panel connected to RISCO Cloud.
The customer's personal details for identification purposes (only
applicable when the Self Registration option is disabled).
applicable when the Self Registration option is disabled).
first connection between the control panel and RISCO Cloud).
Last time the control panel fields were updated and details of the
user/administrator that performed the changes.
The following diagrams show world time zones, US time zones and their UTC offset.
Figure 6-4: World Time Zones Figure 6-5: US Time Zones
6.2. Editing an Existing Control Panel
To edit an existing control panel:
1. On the Control Panels List page, click the CP Login ID of the customer you wish to edit;
the Control Panel Update page is displayed.
2. Enter the control panel’s details as required.
3. Click OK to update and return to the Control Panels List.
– Or –
Click Apply to update and remain on the Control Panel Update page.
16
RISCO Cloud Web Administration Manual
6 Control Panels List
6.3. Deleting a Control Panel
To delete a control panel:
1. On the Control Panels List page, click the CP login ID of the control panel you wish to
delete; the Control Panel Update page is displayed.
2. Click Delete and then OK; the control panel is deleted.
6.4. Additional Control Panel Options
On opening the Control Panel Update page, the column on the left hand side offers a number of
additional options relevant to each control panel. These are as follows:
• Event Forwarding – allows the user to enable or disable the event forwarding groups
that are available for the Alerts event forwarding feature in the Web User Application.
• Service Providers – allows the user to define the service provider (monitoring service)
to which events are reported.
• Web Users – allows the user to add additional Sub users for the security panel.
• Group Membership – on this page the user can assign the panel to any group
available in RISCO Cloud.
• Devices Descriptors – allows the web user to edit descriptors of registered devices via
WUApp.
• User Video Events – on this page the user can define additional user video event
parameters and view a log of the video events removed by the web user.\
• CP Statistics – allows the user to view general statistical information about the
selected control panel and associated Web and Smartphone user
• Smartphone List – allows the user to view the list of registered Smartphone’s
associated to the selected control panel.
Each of these options is explained in the following sections.
6.4.1. Event Forwarding
Alert notification is an event forwarding feature that allows notification by email or text message
after an event has occurred. The list of event forwarding options appears on the Control Panel
Update page located below the customer details. This option in the Web Administration application
is used for enabling or disabling email and/or SMS notification per event forwarding group.
Contacts for event forwarding, however, are edited by the customer in the Alerts section of the Web
User application. The user fills in contacts credentials and then chooses the desired events to be
forwarded from the available groups, as chosen by administrator on this page.
To edit event forwarding options:
1. Open the Control Panel Update page.
2. Click the Event Forwards link in the left-hand column; the Event Forwards table is
displayed.
RISCO Cloud Web Administration Manual
17
6 Control Panels List
Figure 6-6: Event Forwards Table
3. Using the checkboxes that appear in the E-mail and SMS columns enable or disable event
forwarding per event group as required.
4. Click Update.
6.4.2. Service Provider
Service providers can generally be defined as the monitoring station to which RISCO Cloud forwards event
data. This section explains how to allocate a service provider to a control panel. The list of service providers
available for allocation to a control panel is determined elsewhere in this application – see Service Providers
List.
Allocating a service provider to a control panel
Each control panel can be allocated with several service providers, Proxy or IP SIA. This ensures
that the service provider to which the customer has subscribed will receive the relevant event
messages generated by the customer’s security system. The event will be filtered by the Event
Forwarding as explained above, and by Service Provider Event List as defined per service provider,
see Editing the Service Provider’s Event List.
To allocate a service provider to a control panel:
1. Open the Control Panel Update page.
2. Click the Service Providers link in the left-hand column; the Service Providers table is
displayed. The page appears as follows.
Figure 6-7: Service Provider Allocation
3. Click on New SP button then choose an available service provider.
4. Enter the account number in the text field provided.
This account will be reported in the events sent to service provider’s monitoring
system, regardless of the account number registered in the panel for other means of
communication.
5. Click Update.
18
RISCO Cloud Web Administration Manual
Loading...