[Dcplusplus-commit] SF.net SVN: adc:[103] trunk

[<ul...@us...>]

Revision: 103
          http://sourceforge.net/p/adc/code/103
Author:   ullner
Date:     2013-06-17 17:12:38 +0000 (Mon, 17 Jun 2013)
Log Message:
-----------
Added ONID as extension to ADC-Ext 1.0.8
Added a document for all ONID services.

Modified Paths:
--------------
    trunk/ADC-EXT.txt

Added Paths:
-----------
    trunk/ADC-ONIDServices.txt

Modified: trunk/ADC-EXT.txt
===================================================================
--- trunk/ADC-EXT.txt	2013-06-03 20:33:22 UTC (rev 102)
+++ trunk/ADC-EXT.txt	2013-06-17 17:12:38 UTC (rev 103)
@@ -16,6 +16,7 @@
 === Version 1.0.8, UNRELEASED
 
 * Improved 'NATT' documentation, as according to the original paper.
+* Added 'ONID' extension to provide online service integration.
 
 === Version 1.0.7
 Fredrik Ullner <ul...@gm...>, 2012-11-22
@@ -749,4 +750,50 @@
 BINF BBBB APDCPLUSPLUS VE0.782
 ====
 
+=== ONID - Online identification
+The purpose of the OID and OIR commands is to allow users to exchange information about their accounts on various online services. The OID name has been intentionally chosen to be similar to OpenID, although its spread is broader.
+
+New commands are preferrable here over new INF fields to avoid clogging up its 2-letter identifiers. They also allow for more flexibility: multiple profiles of the same type (OIR only); multiple identification parameters.
+
+The OID command is similar to INF, guaranteeing up-to-date information, whereas OIR follows a request/response scheme. OIR parties are therefore not required to keep their OIR information up-to-date.
+
+Parties supporting OID commands MUST advertise the ONID (ONline IDentification) support in the SU field of their INF.
+
+Parameters of the OID and OIR commands:
+
+- Unnamed parameter in first position to designate the service this command is referring to. Known services are listed in the "Known ONID services" (ADC-NOIDServices.txt) document; they are matched case-insensitively. Implementers willing to use an unlisted service SHOULD let ADC managers know about it.
+
+- Optional named parameters whose meanings depend on the service in question.
+
+OID and OIR commands support all contexts (hub-client, client-client). They are allowed in client-client contexts were users to want to avoid their OID/OIR information travelling through hubs. Both clients and hubs MAY provide each other with OID/OIR information.
+
+==== OID
+ OID service
+
+Any party that has sent OID information about itself SHOULD keep it up-to-date.
+
+OID parties MAY provide no information, usually indicating a refusal or inability to communicate it.
+
+Hubs that advertise ONID support MUST dispatch OID information they have received from clients to new clients logging in, similary to INF information.
+
+Clients MAY send OID commands to other clients on hubs that do not advertise ONID support.
+
+==== OIR
+ OIR service
+
+The requesting party MUST send an OIR command with a service parameter only (no optional parameter). The responding party MAY answer with an OIR command containing that same service parameter, and relevant optional parameters.
+
+The responding party MAY send multiple OIR commands in response to one request.
+
+The responding party MAY provide no information, usually indicating a refusal or inability to communicate it.
+
+Any party MAY at any time send an OIR response without any prior request.
+
+==== Examples
+[options="autowidth"]
+|=====
+|BOID BBBB google EMe...@gm... 
+|BOID BBBB lol SUtest SEkr 
+|=====
+
 // vim: set syntax=asciidoc:

Added: trunk/ADC-ONIDServices.txt
===================================================================
--- trunk/ADC-ONIDServices.txt	                        (rev 0)
+++ trunk/ADC-ONIDServices.txt	2013-06-17 17:12:38 UTC (rev 103)
@@ -0,0 +1,125 @@
+= ADC Recommendations
+Fredrik Ullner <ul...@gm...>
+1.0.0, June 2013
+
+== Abstract
+These are the services for the ONID command. See ADC-Ext for the ONID specification.
+
+== Version history
+The latest draft of the next version of this document as well as intermediate
+and older versions can be downloaded from
+$URL: https://adc.svn.sourceforge.net/svnroot/adc/trunk/ADC-ONIDServices.txt $.
+
+This version corresponds to $Revision: 1 $.
+
+=== Version 1.0.0
+* Initial release
+
+== Services
+The service names are all case-insensitive. They are written here as lower-case.
+
+=== DCBase
+Service name: dcbase
+
+Required parameters:
+[options="autowidth"]
+|=====
+|ID |The DCBase forum member numeric identifier.
+|=====
+
+=== Facebook
+Service name: facebook
+
+Required parameters:
+[options="autowidth"]
+|=====
+|ID |The public Facebook ID (that appears in a profile page's URL).
+|=====
+
+Optional parameters:
+[options="autowidth"]
+|=====
+|NI |The friendly name.
+|=====
+
+=== Google
+Service name: google
+
+Required parameters:
+[options="autowidth"]
+|=====
+|EM |The Google e-mail.
+|=====
+
+=== League of Legends
+Service name: lol
+
+Required parameters:
+[options="autowidth"]
+|=====
+|SU |The League of Legends summoner name.
+|SE |The server identifier.
+|=====
+
+The server identifier may be one of the following
+[options="autowidth"]
+|=====
+|SU |The League of Legends summoner name.
+|SE |The server identifier that SHOULD be in the server identifier list below.
+|=====
+
+Server identifiers:
+[options="header, autowidth"]
+|=====
+|Identifier |Description
+|br |Brazil
+|eune |EU West
+|kr |Korea
+|na |North America
+|tr |Turkey
+|ru |Russia
+|=====
+
+=== Microsoft Live
+Service name: mslive
+
+Required parameters:
+[options="autowidth"]
+|=====
+|EM |The Microsoft Live e-mail.
+|=====
+
+=== Playstation Network
+Service name: psn
+
+Required parameters:
+[options="autowidth"]
+|=====
+|ID |The Playstation Network ID
+|=====
+
+=== Twitter
+Service name: twitter
+
+Required parameters:
+[options="autowidth"]
+|=====
+|ID |The Twitter profile ID (that appears in a profile page's URL).
+|=====
+
+Optional parameters:
+[options="autowidth"]
+|=====
+|NI |The nick name.
+|=====
+
+=== Yahoo!
+Service name: yahoo
+
+Required parameters:
+[options="autowidth"]
+|=====
+|EM |The Yahoo! e-mail.
+|=====
+
+// vim: set syntax=asciidoc:

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.