CasperSafe Security Orb

From CasperTech Wiki
Jump to navigation Jump to search
This is only a draft - the product is in BETA TESTING only right now
There is no ETA for final release at this time.

Features

  • Self-contained configuration - no notecards
  • Fewer scripts than competing products - 4 instead of 11-13 scripts
  • CasperLet Support
  • Visitor Tracking option
  • Region-wide operation
  • Capable of monitoring many parcels at once
Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.

What's in the Box?

The following named items are in the shipping crate:

CasperSafe Enforcer
CasperSafe Parcel Link Tool
CasperSafe Psychic Link Script (Read the instructions!)
CasperSafe Security Orb

Along with a landmark to the CasperTech store.

Quick Setup Steps

  1. Rez the shipping crate and unpack
  2. Rez out the CasperSafe Security Orb
  3. Add areas and/or link to rental unit
  4. Rez (and deed if necessary) the Enforcer unit
  5. Add people to appropriate access lists
  6. Arm the orb

See the sections below for explanations of all the options.

CasperSafe Enforcer

The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are ejected. BE CAREFUL with this option - we accept no responsibility for any damage caused.

This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead.

Like the CasperLet Prim Counter, in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.

The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.

For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its owner, or in the case of the enforcer being deeded to group, orbs belonging to the avatar who deeded it. For this reason, it will not work if you pass it to someone else to rez or deed.

UPDATES: The enforcer only needs to be replaced when a new enforcer version goes out.

About the Base Menus

By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources.

Default main menu - click to see larger version.

When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here:

Armed mode - click to see larger version.

When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 20 seconds), and increases the scan frequency in order to detect possible threats more quickly.

Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban.

Subadmin Main Menu


Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; their main menu options will look like this:

Main menu for subadmins - click to see larger version.
Subadmin main menu in armed mode - click to see larger version.

About Lockdown mode


If the orb is currently in "lockdown" mode, the lockdown option will change to "stand down" as shown here:

Lockdown mode - click to see larger version.

This automatically disables itself when everyone ON the access list has left the region - there is no time limit beyond waiting for every allowed person to leave the protected area.

Note that Lockdown mode uses slightly more script time than normal operation (see Script Times for details).

About Configuration

BETA 1 and forward have the capacity to save configuration on the server. Like CasperLet, this is saving against the UUID of the device, barring a complete script reset (which makes it forget everything.)

  • Takes about 20-30 seconds to save configuration changes.
  • Configuration is kept when you "Take a copy" > Rez the copy
  • Configuration is NOT kept when you shift > drag > copy (this resets the script)
  • Like CasperLet, the script tracks the UUID of the device. New device = new UUID. Shift > drag > copy = New device and new UUID.
  • Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)

Security Menus

Options - Defaults


These are the default settings for the options menu, as it ships from CasperTech:

Default Options page 1 - click to see larger version.
|
Default Options page 2- click to see larger version.

Floating text: Turns the radar on/off. Might be worth mentioning that turning the radar off helps keep the script time low, since having it on adds extra processing.

Disallow by default: Eject anyone who's not on the access list.

Discreet mode: Dials back the internal timers to reduce lag. Won't be as responsive, but will be kinder to region resources.

Eject from parcel: self explanatory

Teleport home: self explanatory

Add to parcel ban list: the ban duration is hard-set at 6 hours

Beta 5 introduced the ability to turn off notifications to groups of users, to automatically set group members as guests or admins, and the ability to limit a detection range to only affect the parcel that it's on (allowing owners to prevent the orb from kicking the neighbors out of neighboring homes.) These new options are on the 2nd page of the options menu (whereas Beta 1-4 didn't have a page 2 for options.)

Automatic Settings


* When used with CasperLet, the owner and any CasperLet managers are automatically admins
* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.
* Lockdown mode automatically ends when the protected area is empty of all allowed avatars.

Warning time


This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar.

Minimum warning period: 30 seconds in regular mode, 10 seconds in lockdown mode. You cannot set it for less time than that. Lockdown mode lasts until either (1) it's turned off, or (2) everyone leaves the protected area.

Age Limit


When on, this option ejects avatars who are younger than a certain number of days.

Banned avatars


Any avatar on the ban list (either in CasperSafe or on the land) will be ejected immediately if Eject Mode is on.

Access Levels


When Admins click into the access menu, they will get the following options:

Access main menu - click to see larger version.

When Subadmins click into the access menu, their options will be a little different:

Subadmin version of access menu - click to see larger version.

Guests


This option allows you to add a mostly permanent "whitelist" of allowed guests. Guests do not have menu access to the orb.

Banned


This option allows you to add to a "never allowed" list of people. Anyone on the banned list will be automatically ejected/teleported home upon arrival.

Admins


This is the owner, plus any additional admins that are added to the Orb's admin list.

Temporary


Like Guest, except that people added to the temporary list are automatically removed after they leave the sim/region.

Subadmins


Usually subadmins will be the tenants of a landlord. As a result, they will not have access to the higher administrative functions of the security orb.

Visitor Tracking Menus

BETA 1:

  • Visitor tracking turns ON or OFF with options menu
  • There is no interface, so the "visitor" menu is still empty
  • Visitor data WILL be sent to CasperTech servers when turned on

Add Areas

Main Area menu - click to see larger version.
Add Area menu - click to see larger version.

About Pairing


CasperSafe may be linked/paired to a single rental unit, and/or multiple parcels. You cannot link/pair a single CasperSafe to multiple rental units, but you CAN link/pair to a single rental unit AND multiple whole parcels.

You cannot cover multiple regions with a single CasperSafe device - the LSL commands used can only be issued from within the sim that the device is currently rezzed on. You will need one (1) CasperSafe device per region you want monitored.

Pairing CasperSafe to One or More Parcels


The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be used on the parcel that will be linked to the CasperSafe orb. It can be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels.

1) Rez the CasperSafe Security Orb on the land you want it to monitor
2) Rez the "Parcel Link Tool" - You will get these messages in local chat:
  Touch me to pair this parcel with your CasperSafe orb. 
  Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.
  I'm now over parcel ((parcel name as seen in "about land" floater)). Touch to register with a CasperSafe Orb.
3) On the CasperSafe orb, click for the popup menu
4) Select "Areas"
5) Select "Add"
5) Select "Parcel"
6) Then click the Parcel Link Tool. You'll see the following messages in local chat:
  OK. Trying to find a CasperSafe orb, please stand by.
  Alright, all done!
  Pairing process ended.
7) The Parcel Link Tool will self-delete when the parcel pairing process is completed.

Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.

Custom


Choosing custom will rez out a red and blue pair of arrows, which are used to define the diagonally opposite corners of a square or rectangular space. If the parcel you are trying to protect is irregular - non-square and non-rectangular - such as many mainland parcels, it might be more effective to use the "parcel" setting instead of "custom".

Range


Range allows you to define a circular radius of protection. The number you input may be any number (you are NOT limited to 96m!), up to the size of the sim/region.

Parcel


Allows you to protect a specific parcel on a region. You will need the Parcel Link Tool from the shipping crate to add a specific parcel to the orb.

Region


Allows you to protect the entire region.

Pairing CasperSafe to a single CasperLet Unit


NOTE: CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit.

1) Rez CasperSafe Security Orb near the rental unit
2) Drop the "Psychic Link Script" into the corresponding rental unit
3) Watch messages in local chat. If all goes well, you should see:
  Okay, let's have a look here..
  Ooh, CasperLet! Good choice! Searching for the orb..
  Cool! I'm paired with ((name of rental unit)) (Key: ((uuid string)) )
  Pairing process ended. 
4) The orb will also add the CasperSafe system owner as an ADMIN automatically.

Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.

Link to Rental Unit


Clicking LINK on the main menu:

Default main menu - click to see larger version.

Will get you to the LINK instructions. This option will link one copy of CasperSafe to ONE rental unit:

Default main menu - click to see larger version.

This starts the pairing process between CasperSafe and a single rental unit.

Once you've clicked the LINK option, simply drop the "CasperSafe Psychic Link" script into the corresponding rental unit and it will do the rest by itself.

If you clicked into this option this by mistake, simply wait a minute or two for the process to time out. When you see the "Paring ended" message, you can go back to doing what you were trying to do.

Remember that you cannot pair CasperSafe to multiple rental units - but you can manage multiple parcels. If you expect to use CasperSafe with multiple rental units, you will need one (1) CasperSafe per rental unit that will have security.

Messages From the Orb

All security orb messages from CasperSafe are received ONLY by the admins and subadmins.

Messages are sent using llRegionSayTo, so only the admins and subadmins currently on the region generating the alert will get the message.

Currently, these messages cannot be turned off - but they are limited to only the region that generates the alert.

Guests do not get any messages at all.

Not Supported

No height restrictions


CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many legitimate avatars.

No Instant ban / No short warning duration


Ever been randomly teleported home by an over-zealous security system without any knowledge that it was even there? Yes, us too. It really sucks, and it makes it impossible to provide in-person support for your products.

That's why CasperSafe is designed to be fair. Security devices which are set to less than 10 seconds do not provide ample opportunity for passer-bys to vacate the area.

The minimum warning time is 30 seconds under normal operation. However, if you require extra privacy, you can enable "Lockdown" mode which temporarily reduces the minimum warning period to 10 seconds (until everyone in the access list has left the sim/region).

For the above reason, we don't support an "instant" eject mode. However, those who are on the "Ban" list will be ejected instantly.

Script Times

These timings were measured over a 24 hour period, on a relatively quiet full region (Izanagi). Your mileage may vary, and times may be higher on busy sims.

UNARMED - 0.003ms
DISCREET - 0.003ms
ARMED - 0.004ms
LOCKDOWN - 0.005ms
ARMED + RADAR - 0.006ms
LOCKDOWN + RADAR - 0.007ms

Still Need to Know....

1) How to use with other supported rental systems?

2) Visitor tracking options and menus?