|
|
|
| Main
> AddonChat
> Custom Integration
> Remote Authentication
|
|
| |
|
|
|
Migrating from RAS v1.x to RAS v2.1
| Created |
|
| Modified |
|
| Views |
615 |
| Author |
|
|
This article describes how RAS v1.0 and RAS v1.1 scripts translate to the current RAS protocol with respect to user group privilege settings.
This document is intended to assist developers in migrating their legacy (or deprecated) RAS scripts to the current (v2.1) protocol, and to serve as a guide for users who wish to continue using a previous v1.x generation script and understand exactly which current user group privileges are set based upon their legacy script.
It is recommended that readers be familiar with the Remote Authentication System v2.1 feature set before proceeding.
DEFAULT VALUES: THE GUEST USER GROUP
Before continuing, please note that your Guest usergroup (as customized via your AddonChat control panel) is first used to load default values before any remote authentication script is processed. In the case of the current version of RAS, no other transformations are made; however older versions of RAS (including the 1.x protocols) require that the RAS processor perform additional translations to ensure smooth transitions between AddonChat software updates.
Any user group privilege not described in this text will be automatically set to the same value as your default/Guest user group setting.
FEATURES COMMON TO RAS v1.0 AND v1.1
Both RAS v1.0 and v1.1 output a single numeric value with a range between 0 and 4 to indicate privilege level. In the case of RAS v1.0, only that single number is output via the script. In the case of v1.1, the numeric value is output using the AUTH^# parameter. Both values share the same meaning when the current RAS processor performs it's automatic up-conversion. The currently accepted values for RAS v1.x scripts and their translations to the current AddonChat user group privilege system are described below:
user.usergroup.id = 1
user.usergroup.can_login = 1
user.usergroup.can_msg = 1
user.usergroup.can_action = 1
user.usergroup.icon = 1
user.usergroup.level = 2
- 2: Basic Administrative Access
The following settings are set (or modified) in addition to all other settings listed above.
user.usergroup.id = 2
user.usergroup.post_delay = 0
user.usergroup.allow_pm = 1
user.usergroup.allow_room_create = 1
user.usergroup.idle_kick = 0
user.usergroup.is_admin = 1
user.usergroup.is_super_moderator = 0
user.usergroup.can_kick = 1
user.usergroup.can_affect_admin = 0
user.usergroup.can_grant = 0
user.usergroup.can_cloak = 0
user.usergroup.can_see_cloak = 0
user.usergroup.can_ban = 1
user.usergroup.can_system_speak = 1
user.usergroup.can_enable_moderation = 1
user.usergroup.can_silence = 1
user.usergroup.allow_bbcode = 1
user.usergroup.allow_color = 1
user.usergroup.msg_scroll = 1
user.usergroup.max_msg_length = 2048
user.usergroup.filter_shout = 0
user.usergroup.filter_profanity = 0
user.usergroup.filter_word_replace = 0
user.usergroup.can_launch_website = 1
user.usergroup.can_join_nopw = 1
user.usergroup.can_topic = 1
user.usergroup.is_unmoderated = 1
user.usergroup.can_ipquery = 1
user.usergroup.can_geo_locate = 1
user.usergroup.can_query_ether = 1
user.usergroup.allow_img_tag = 1
user.usergroup.level = 3
user.usergroup.icon = 2
user.usergroup.allow_avatars = 1
user.usergroup.can_give_timeout = 1
user.usergroup.can_random = 1
- 3: Super Administrator Access, including RAC privilege
The following settings are set (or modified) in addition to all other settings listed above.
user.usergroup.id = 3
user.usergroup.can_ban_subnet = 1
user.usergroup.can_see_cloak = 1
user.usergroup.can_grant = 1
user.usergroup.can_affect_admin = 1
user.usergroup.can_cloak = 1
user.usergroup.can_fnick = 1
user.usergroup.allow_admin_console = 1
user.usergroup.can_close = 1
user.usergroup.can_transfer = 1
user.usergroup.can_clear_screen = 1
user.usergroup.can_clear_history = 1
user.usergroup.level = 4
- 4: Super Administrator Access with RAC+Log View Privilege
The following settings are set (or modified) in addition to all other settings listed above.
user.usergroup.id = 4
user.usergroup.allow_admin_console = 1
user.usergroup.can_view_transcripts = 1
user.usergroup.level = 5
user.usergroup.id = 0
user.usergroup.can_login = 0
user.usergroup.level = 1
FEATURES SPECIFIC TO RAS v1.1
RAS v1.1 expanded upon v1.0 by permitting a user ID setting and a list of Remote Functions. The current remote authentication processor respects both settings from RAS v1.1. The following is an example RAS v1.1 script, followed by an example of how that script would be interpreted if it were a RAS v2.1 script. Both scripts are provided in PHP:
<?php
header("Content-type: text/plain");
print "SCRAS^1.1\n";
print "AUTH^1\n";
print "UID^243\n";
print "SITE_LINK^Google^http://www.google.com/\n";
print "SITE_LINK^AddonChat^http://www.addonchat.com/\n";
?>
The following script details precisely how the RAS processor automatically translates the above RAS v1.1 script:
<?php
header("Content-type: text/plain");
print "scras.version = 2.1\n";
/* This is the same UID specified in the RAS v1.1 script */
print "user.uid = 243\n";
/* Here we see how AUTH^1 is translated in RAS v2.1 */
print "user.usergroup.id = 1\n";
print "user.usergroup.can_login = 1\n";
print "user.usergroup.can_msg = 1\n";
print "user.usergroup.can_action = 1\n";
print "user.usergroup.icon = 1\n";
print "user.usergroup.level = 2\n";
/*
Here we see how our SITE_LINK parameters
are translated in RAS v2.1
*/
print "url.remote.user.0 = \"Google\", \"http://www.google.com/mylink.php\", \"_blank\", \"false\"\n";
print "url.remote.user.1 = \"AddonChat\", \"http://www.addonchat.com/mylink.php\", \"_blank\", \"false\"\n";
?>
|
Migrating from RAS v2.0 to RAS v2.1
This article describes how RAS v2.0 scripts translate to the current RAS v2.1 protocol with respect to user group privilege settings. This document is intended to assist...
|
Remote Authentication System v1.0
Remote Authentication System (RAS) v1.0 is a simple, easy to implement protocol allowing you to perform username/password authentication from your own web...
|
Remote Authentication System v2.1
Remote Authentication System (RAS) v2.1 allows you to perform username/password authentication from your own web site. This is enabled by hosting a script on your website...
|
|
|
|
|
|
| |
|
