Difference between pages "IntelliDoor Garage" and "IntelliDoor GSS"

(Difference between pages)
imported>NelsonJenkins
 
imported>NelsonJenkins
(Created page with "The IntelliDoor GSS (Global Security Server) is a tool used to coordinate security settings among many IntelliDoor products. While group control is easiest for limited access,...")
 
Line 1: Line 1:
{{ infobox product
+
The IntelliDoor GSS (Global Security Server) is a tool used to coordinate security settings among many IntelliDoor products. While group control is easiest for limited access, in some cases it is not possible (autoreturn where the land group is not the group you want to allow, for instance). In this case, if you have many IntelliDoors, the GSS provides a single point where you can list people who should have access.
| title            = IntelliDoor Garage
 
| image            = [[File:VendorImage5 - IntelliDoor Builder Kit.jpg|200px|center]]
 
| caption          = IntelliDoor Builder Kit, the full-permissions pack of all IntelliDoor products.
 
| inventor        = [[Nelson Jenkins]]
 
| launch year      = 2009
 
| company          = [[Gentek]]
 
| available        = [https://marketplace.secondlife.com/p/IntelliDoor-Garage-Versatile-Garage-Door/1556292 Marketplace] & In-World
 
}}
 
 
 
The '''IntelliDoor Garage''' is a smoothly-operating garage door by [[Gentek]]. It uses notecard-based configuration.
 
 
 
  
 
==Setup==
 
==Setup==
# Rez the door and resize it to the frame. Try not to change the thickness of the door.
+
# Rez the GSS object and open it by right clicking and selecting Open, then double-clicking the "_config" notecard.
# Rez a Button if you want one and position it. It can be resized if necessary, but we recommend leaving it as it is. You don't need a Button; clicking the door itself will operate it as well.
+
# Edit the notecard according to who you want to allow and disallow from all of the doors using this server. Make sure you change the server's name to the same server used by your doors. For more information on the whitelist and blacklist, read the section labeled "WHITELIST/BLACKLIST".
# Open the _config notecard in the door, sensor, and button. For more information on the _config values, read the sections labeled "CONFIG VALUES". For now, change the door ID and make sure it is the same in all notecards.
+
# Save the notecard and close it. The server should automatically load the configuration.
# Test the door by clicking the up button (or if you don't have a controller, just the door itself). If you have autoclose enabled, stand under the door and see if it closes (it shouldn't).
+
# Reset all doors/components. This can either be done by editing the notecard (to put in the server name, for example) or by selecting the door and going to Tools -> Reset Scripts In Selection (or Build -> Scripts -> Reset Scripts). Make sure the door is fully closed before using the Reset Scripts menu option.
As of v3.0, the door can be rotated and linked freely; it will remain totally operational.
 
 
 
==Textures==
 
The door textures are now included in the package; simply drag them onto each side of the door to set the door's texture. The textures are prefixed with "Tex-IDGarage". You can also use your own textures.
 
 
 
==Autoclose==
 
The IntelliDoor has an autoclose feature set up in the _config notecard of each door. To enable it, set the AUTOCLOSE value greater than 0 (we recommend at least 10). A sensor is no longer included as of v3.0, since the door will now perform a raycast to detect if its path is blocked.<br>
 
When your door reaches the completely open position, it will wait the number of seconds in AUTOCLOSE, then automatically close. However, if there is something blocking the door, it will wait until the door becomes unobstructed (or 60 seconds after the last object entered the doorway) then close.
 
 
 
==Door Config Values==
 
* ID: This is the door's identifier. Each door should have a separate ID. The ID can be any alphanumeric string (A-Z, 0-9, space). All IntelliDoor components are owner-only so don't worry about conflicting IDs from other people.
 
* SPEED: This is the speed value. The door speed can be 1-9, 9 being the fastest. The default is 5. If you are experiencing slow operation due to lag (especially in homesteads), it might help to increase the speed.
 
* ACCESS: This is the base access setting. If the door is locked (which it is by default), this group of people can always access it anyway by clicking on it. Can be "Everyone", "Group", or "Owner". (If you put "Group" here, the door's group will be able to click the door to use it, but they won't be able to use any buttons or controllers unless you also set them to "Group".)
 
* AUTOCLOSE: If you don't want autoclose, leave this as 0. Otherwise, it is the number of seconds the door waits until closing automatically. For more info, read "AUTOCLOSE" above.
 
* WHITELIST: The list of people that will always be able to click the door to operate it. This does not affect buttons and controllers. Separate with commas. '''NOTE: Whitelist names are ''usernames'' (nelson.jenkins, newbie), not ''legacy names'' (Nelson Jenkins, Newbie Resident).''' If you have more than 10 names, please read "Extended Whitelist" below.
 
* GSS: If you are using a Global Security Server, enter its name in this field. The IntelliDoor GSS provides a "master" whitelist and blacklist for doors that subscribe to it (for example, if you have a group of doors that you want a list of people to control).
 
* AKS: This is for a future product. Ignore this field.
 
* REMOTE: If you have an IntelliDoor Remote, you can put a password in this field. This is the remote password that you'll put in the remote to control this door. '''IMPORTANT:''' The IntelliDoor Remote is '''not''' owner-only. Anyone can access your door if they have this password - similarly, if you have the same password as another door, even if it is owned by someone else, it will be controlled at the same time. We recommend simply [https://www.random.org/passwords/ generating a random password] without special characters.
 
 
 
===Extended Whitelist===
 
Because of LSL limitations, the whitelist line can only be read for 255 characters. However, the IntelliDoor system supports multiple whitelist lines. To be safe, separate your whitelist into 10-name increments, like so:<br>
 
<code>WHITELIST=User01, User02, User03, User04, User05, User06, User07, User08, User09, User10<br>WHITELIST=User11, User12, User13, User14</code><br>
 
You can have as many whitelist lines as you need.
 
 
 
==Button Config Values==
 
* ID: Put the door IDs you want to control here. If you are only controlling one door, just put that door's ID. If you have more than one door you want to control at the same time, separate their IDs with commas.
 
* ACCESS: This is the base access setting for this button only. This is the same as the door's access settings, except it affects the button only. (If you put "Group" here, the button's group will be able to use the button to use the door, but not the door directly by clicking it.)
 
* WHITELIST: This is the same as the door's whitelist, but again, only affects the button.
 
* GSS: This is the same as the door's GSS name, but only affects the button.
 
 
 
==Builder Kit Instructions==
 
<font size="4">[[Builder Kit Permissioning|Follow this guide]] before using your Builder Kit components, or they will break.</font>
 
 
 
Make sure you review the [[Gentek Company Policy|Full Permissions Agreement]] to understand how you may distribute IntelliDoor products. Remember, objects in violation of this agreement will be remotely deleted. Therefore, make sure you follow the above instructions exactly.
 
 
 
==API==
 
As of v3.0, the IntelliDoor has an API for controlling individual doors and components. All API communication is done on channel '''-494827459'''.
 
 
 
For the following, '''[BBID]''' specifies the [[Buildbox]] ID. By default, this should be '''NONE'''. However, if your doors were rezzed as part of a building through a Buildbox, it will have been set. You can get the Buildbox ID by selecting a door and checking its description - it should read '''BBID''' followed by the ID, which is usually formatted as a 36-character UUID. You can also set up your API-enabled item in the building such that it accepts and stores the Buildbox ID when it is rezzed. Note that Buildbox IDs do not change once the object is rezzed.
 
  
The IntelliDoor Garage accepts the following API commands:
+
==Whitelist/Blacklist==
* '''[BBID][DoorID]&&open''' - Opens the door.
+
The GSS has two security features - a whitelist and a blacklist. When a door (or other component) "subscribes" to a GSS by using the same server name in its _config notecard, it loads these lists upon resetting.<br>
* '''[BBID][DoorID]&&close''' - Closes the door.
+
Those in the whitelist always have access to the door, regardless of the door's local settings. Those in the blacklist will never have access to the door, even if it is unlocked or they have access through an Everyone or Group setting.<br>
* '''[BBID][DoorID]&&stop''' - Stops the door, if it is moving.
+
The lists are only limited by memory - theoretically, the system should handle more than 100 names easily.<br>
The IntelliDoor Garage ''does not'' accept the &&lock and &&unlock commands, and it is the only component which accepts the &&stop command.
+
NOTE ON NAMES: The IntelliDoor system v2.1 and above uses usernames (e.g. "nelson.jenkins" or "newusername") - NOT old-style names ("Nelson Jenkins" or "newusername Resident") and NOT display names ("Nelson the Magnificent" or "New User"). Separate values with commas (nelson.jenkins, newusername, etc.). Entries here are not case-sensitive.
  
 
==Updates & Release Notes==
 
==Updates & Release Notes==
You can update your IntelliDoor Garage by rezzing the update box.
+
You can update your IntelliDoor GSS by simply rezzing it.
* v3.1
+
* v2.1.3
** New button model
+
** Fixed GSS not working with v2.1.1+ doors when ID has spaces.
** IntelliDoor Remote integration
 
* v3.0
 
** Implemented Buildbox integration
 
** Doors now automatically reset when GSS is reset
 
** Usernames in whitelist are no longer case-sensitive
 
** Blacklist removed
 
** Default textures now included in the box
 
** Communications now streamlined onto single channel for less lag
 
** API added
 
** Doors are now all linkable to buildings for easier prefab packaging
 
** Garage can now be rotated (previously would not work)
 
** Garage Sensor removed and replaced with an automatic raycast
 
* v2.1.2
 
** Fixed separate textures sometimes overwriting each other
 
* v2.1.1
 
** Fixed integration with Keypad
 
 
* v2.1
 
* v2.1
** Allow separate textures on each side.
 
 
** Changed old-style names to usernames.
 
** Changed old-style names to usernames.
 
** Slight tweaks.
 
** Slight tweaks.
 
* v2.0
 
* v2.0
** Replaced and rewrote everything. It's better now. Trust me.
 
* v1.3.4
 
** Fixed API script.
 
* v1.3.3
 
** Added API script.
 
* v1.3.2
 
** Fixed "grey-out" bug.
 
** Removed Legacy door.
 
** Added touch menu.
 
** Added retexturing system.
 
** Added data validation for door settings.
 
** Removed self-deleter.
 
* v1.3.1
 
** Attempted to fix "grey-out" bug.
 
* v1.3
 
** New, smoother movement driver.
 
** Speed setting added.
 
** Minor UI changes.
 
** Updater moved to door (non-Legacy).
 
* v1.2
 
** Better sound driver.
 
* v1.1
 
** Added autoclose.
 
* v1.0
 
 
** Primary public release.
 
** Primary public release.
  
==History==
+
==Builder Kit Instructions==
Garage doors in [[Second Life]] used to either be one of two types:
+
'''''ATTENTION USERS OF THE BUILDER KIT VERSIONS: THIS IS IMPORTANT, PLEASE READ'''''<br>
* '''Physical:''' the door would set itself physical and move upwards through anything in its way. This required extra space above the door.
+
Your use of transfer-enabled products is bound by our [[Gentek Company Policy|Full Permissions Agreement]]. If you haven't read it, it's important you do so.<br>
* '''Compression:''' the door would resize and move itself so it appears to be moving up. This didn't require extra space, but compressed the texture vertically and didn't look realistic.
+
Most importantly, we keep track of who has purchased the Builder Kit. If someone has a transferable IntelliDoor but has not bought the Builder Kit, that door will not function, and their use of it will be recorded. If you are found to be giving out transferable IntelliDoors, you will be backtraced by the cyber police, and consequences will never be the same.<br><br>
The '''IntelliDoor Garage''', originally just the IntelliDoor, is a unique garage door released in early 2009 that uses an advanced scripting method that solves both problems - it doesn't require extra space and it doesn't compress the texture.
+
Therefore, ''make sure you set the door object to NO TRANSFER and the script inside it to NO TRANSFER before distributing it.'' However, '''leave the notecard FULL PERMISSIONS''' or it will break the script. Otherwise, you are risking both your license to use our products and your reputation with your customers, who will be left with prefabs that have their doors break when rezzed.
 
 
Its design has not changed much from the original design, except for a texture refresh. It is just a simple box prim. However, its scripts were reduced dramatically - the original had 5 separate scripts to coordinate movement. With the advent of newer LSL functions, they could be consolidated into one.
 
 
 
Fun fact: the original IntelliDoor was created on New Years Eve in 2008, as [[Nelson]] had hoped to release it for the New Years Sale starting the next day. Unfortunately, it was stalled due to general laziness, and wasn't released until several months later.
 
 
 
Version 2 brought integration with the rest of the IntelliDoor series, which had just been released.
 
  
 
{{Gentek}}
 
{{Gentek}}

Revision as of 16:45, 25 February 2013

The IntelliDoor GSS (Global Security Server) is a tool used to coordinate security settings among many IntelliDoor products. While group control is easiest for limited access, in some cases it is not possible (autoreturn where the land group is not the group you want to allow, for instance). In this case, if you have many IntelliDoors, the GSS provides a single point where you can list people who should have access.

Setup

  1. Rez the GSS object and open it by right clicking and selecting Open, then double-clicking the "_config" notecard.
  2. Edit the notecard according to who you want to allow and disallow from all of the doors using this server. Make sure you change the server's name to the same server used by your doors. For more information on the whitelist and blacklist, read the section labeled "WHITELIST/BLACKLIST".
  3. Save the notecard and close it. The server should automatically load the configuration.
  4. Reset all doors/components. This can either be done by editing the notecard (to put in the server name, for example) or by selecting the door and going to Tools -> Reset Scripts In Selection (or Build -> Scripts -> Reset Scripts). Make sure the door is fully closed before using the Reset Scripts menu option.

Whitelist/Blacklist

The GSS has two security features - a whitelist and a blacklist. When a door (or other component) "subscribes" to a GSS by using the same server name in its _config notecard, it loads these lists upon resetting.
Those in the whitelist always have access to the door, regardless of the door's local settings. Those in the blacklist will never have access to the door, even if it is unlocked or they have access through an Everyone or Group setting.
The lists are only limited by memory - theoretically, the system should handle more than 100 names easily.
NOTE ON NAMES: The IntelliDoor system v2.1 and above uses usernames (e.g. "nelson.jenkins" or "newusername") - NOT old-style names ("Nelson Jenkins" or "newusername Resident") and NOT display names ("Nelson the Magnificent" or "New User"). Separate values with commas (nelson.jenkins, newusername, etc.). Entries here are not case-sensitive.

Updates & Release Notes

You can update your IntelliDoor GSS by simply rezzing it.

  • v2.1.3
    • Fixed GSS not working with v2.1.1+ doors when ID has spaces.
  • v2.1
    • Changed old-style names to usernames.
    • Slight tweaks.
  • v2.0
    • Primary public release.

Builder Kit Instructions

ATTENTION USERS OF THE BUILDER KIT VERSIONS: THIS IS IMPORTANT, PLEASE READ
Your use of transfer-enabled products is bound by our Full Permissions Agreement. If you haven't read it, it's important you do so.
Most importantly, we keep track of who has purchased the Builder Kit. If someone has a transferable IntelliDoor but has not bought the Builder Kit, that door will not function, and their use of it will be recorded. If you are found to be giving out transferable IntelliDoors, you will be backtraced by the cyber police, and consequences will never be the same.

Therefore, make sure you set the door object to NO TRANSFER and the script inside it to NO TRANSFER before distributing it. However, leave the notecard FULL PERMISSIONS or it will break the script. Otherwise, you are risking both your license to use our products and your reputation with your customers, who will be left with prefabs that have their doors break when rezzed.