Protocols/OSCAR/SNAC/ADMIN INFO CHANGE REPLY: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
 
Line 21: Line 21:


@NOTE: May contain one of these TLVs (need to clarify, make context and conditions more obvious): [[Protocols/OSCAR/Foodgroups/ADMIN#Info_TLVs]]
@NOTE: May contain one of these TLVs (need to clarify, make context and conditions more obvious): [[Protocols/OSCAR/Foodgroups/ADMIN#Info_TLVs]]
=== From Aleksandr Shutko: SNAC(07,05) ADMIN__INFO_CHANGE_REPLY ===
<table width=640 cellSpacing=0 cellPadding=0 border=0>
<tr>
<td>
<br><span >This is the client account info change reply. It also may
contain error code / error url instead if request failed. Known error codes
may be found in [[Protocols/OSCAR/SNAC_07_03|SNAC(07,03)]] description.</span><br><br>
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td  bgcolor=#E9E9E9 >
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td>&nbsp;00 07</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=55%>SNAC family</td>
</tr>
<tr>
<td>&nbsp;00 03</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC subtype</td>
</tr>
<tr>
<td>&nbsp;00 00</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>SNAC flags</td>
</tr>
<tr>
<td>&nbsp;xx xx xx xx</td>
<td>&nbsp;</td>
<td>dword</td>
<td>&nbsp;</td>
<td>SNAC request-id</td>
</tr>
</table>
</td></tr>
<tr><td bgcolor=#E9E9E9>
<table width=630 cellSpacing=2 cellPadding=0 align=center border=0>
<tr><td>
<table width=630 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0>
<tr><td bgcolor=#C9C9E9>&nbsp;
Following structure may be repeated more then once
</td></tr>
<tr><td bgcolor=#E9E9E9>
  <table width=100% cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=169>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td width=55%>permissions flags <span >(1 - r/o, 2 - r/o,
    3 - r/w)</span></td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td>&nbsp;</td>
  <td>word</td>
  <td>&nbsp;</td>
  <td>number of following TLVs</td>
  </tr>
  </table>
<!-- TLV 0x01 -->
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;00 01</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x01) - user screenname</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;xx ..</td>
  <td width=5>&nbsp;</td>
  <td width=17%>string</td>
  <td width=5>&nbsp;</td>
  <td width=60%>user formated screenname</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td></tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
<!-- TLV 0x11 -->
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;00 11</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x11) - user email</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td>&nbsp;</td>
  <td>word</td>
  <td>&nbsp;</td>
  <td>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td bgcolor=#f9f9f9>
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;xx ..</td>
  <td width=5>&nbsp;</td>
  <td width=17%>string</td>
  <td width=5>&nbsp;</td>
  <td width=60%>user email string</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td></tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
<!-- TLV 0x13 -->
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0 >
  <tr>
  <td width=25%>&nbsp;00 13</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x13) - registration status</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0 >
  <tr>
  <td width=25%>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>registration status <span>(1 - no disclosure,
    2 - limit disclosure, 3 - full disclosure)</span></td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td></tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
<hr>
<!-- TLV 0x08 -->
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;00 08</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x08) - error code</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td>&nbsp;</td>
  <td>word</td>
  <td>&nbsp;</td>
  <td>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td bgcolor=#f9f9f9>
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>error code (request failed)</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td></tr>
<tr><td height=5 colspan=3> </td></tr>
</table>
<!-- TLV 0x04 -->
<table width=630 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=3></td></tr>
<tr><td width=20> </td>
<td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0>  <tr><td  bgcolor=#f9f9f9 >
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;00 04</td>
  <td width=5>&nbsp;</td>
  <td width=17%>word</td>
  <td width=5>&nbsp;</td>
  <td width=60%>TLV.Type(0x04) - error url</td>
  </tr>
  <tr>
  <td>&nbsp;xx xx</td>
  <td width=5>&nbsp;</td>
  <td>word</td>
  <td width=5>&nbsp;</td>
  <td>TLV.Length</td>
  </tr>
  </table>
  </td></tr>
  <tr><td bgcolor=#f9f9f9>
  <table width=600 cellSpacing=0 cellPadding=0 align=center border=0>
  <tr>
  <td width=25%>&nbsp;xx ..</td>
  <td width=5>&nbsp;</td>
  <td width=17%>string</td>
  <td width=5>&nbsp;</td>
  <td width=60%>error description url</td>
  </tr>
  </table>
  </td></tr>
  </table>
</td></tr></table>
</td><td width=5> </td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
</td></tr></table>
</td></tr></table>
</td></tr></table>
</td></tr></table>
</td></tr></table>
</td></tr></table>
<br>Example SNAC dumps with flap header:
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr>
<td bgcolor=#E9E9E9>
<font size=3><pre style="font-size: 13px">
  2A 02 3D 1C 00 1F 00 07 00 05 00 00 00 01 00 04  *.=.............
  00 03 00 01 00 01 00 0D 52 45 41 4C 52 65 67 72  ........REALRegr
  65 73 73 6F 72                                  essor
</pre></font>
</td></tr></table>
</td></tr></table>


=== ADMIN SNACs ===
=== ADMIN SNACs ===
{{Protocols/OSCAR/Foodgroups/ADMIN/SNACs/Simple}}
{{Protocols/OSCAR/Foodgroups/ADMIN/SNACs/Simple}}


[[Category:With_Contrib]]
[[Category:Stub]]
[[Category:Stub]]
[[Category:AOL]]
[[Category:AOL]]

Latest revision as of 05:01, 13 February 2021

OSCAR Protocol
IntroductionTermsClients
Basic
DatatypesFLAPSNACTLV
UUIDsErrorsTool IDs
Host Interaction
Rate LimitsMigrationMessages
Other Services
ADMINADVERTALERT
BARTBOSBUCPCHAT
CHAT_NAV
Tutorials
Sign OnBARTRendezvous
ICBMLocateBuddies
Foodgroups
OSERVICE (0x0001)
LOCATE (0x0002)
BUDDY (0x0003)
ICBM (0x0004)
ADVERT (0x0005)
INVITE (0x0006)
ADMIN (0x0007)
POPUP (0x0008)
PD (0x0009)
USER_LOOKUP (0x000A)
STATS (0x000B)
TRANSLATE (0x000C)
CHAT_NAV (0x000D)
CHAT (0x000E)
ODIR (0x000F)
BART (0x0010)
FEEDBAG (0x0013)
ICQ (0x0015)
BUCP (0x0017)
ALERT (0x0018)
PLUGIN (0x0022)
UNNAMED_FG_24 (0x0024)
MDIR (0x0025)
ARS (0x044A)
ID Origin Name Foodgroup Service Status Version
0x0007, 0x0005 Host ADMIN__INFO_CHANGE_REPLY Unspecified ADMIN Active 1.9

This is the response for ADMIN__INFO_CHANGE_REQUEST and may either confirm changes or contain an error code and/or URL.

SNAC Header

Foodgroup uint16 (word) 00 07
Subgroup uint16 (word) 00 05
Flags uint16 (word) 00 00
Request ID uint32 (dword) 00 00 00 00

SNAC Data

Unconfirmed: This SNAC contains no data

@NOTE: May contain one of these TLVs (need to clarify, make context and conditions more obvious): Protocols/OSCAR/Foodgroups/ADMIN#Info_TLVs

From Aleksandr Shutko: SNAC(07,05) ADMIN__INFO_CHANGE_REPLY


This is the client account info change reply. It also may contain error code / error url instead if request failed. Known error codes may be found in SNAC(07,03) description.

 00 07   word   SNAC family
 00 03   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 

Following structure may be repeated more then once

 xx xx   word   permissions flags (1 - r/o, 2 - r/o, 3 - r/w)
 xx xx   word   number of following TLVs
 00 01   word   TLV.Type(0x01) - user screenname
 xx xx   word   TLV.Length
 xx ..   string   user formated screenname
 00 11   word   TLV.Type(0x11) - user email
 xx xx   word   TLV.Length
 xx ..   string   user email string
 00 13   word   TLV.Type(0x13) - registration status
 xx xx   word   TLV.Length
 xx xx   word   registration status (1 - no disclosure, 2 - limit disclosure, 3 - full disclosure)

 00 08   word   TLV.Type(0x08) - error code
 xx xx   word   TLV.Length
 xx xx   word   error code (request failed)
 00 04   word   TLV.Type(0x04) - error url
 xx xx   word   TLV.Length
 xx ..   string   error description url


Example SNAC dumps with flap header:


  2A 02 3D 1C 00 1F 00 07 00 05 00 00 00 01 00 04  *.=.............
  00 03 00 01 00 01 00 0D 52 45 41 4C 52 65 67 72  ........REALRegr
  65 73 73 6F 72                                   essor



ADMIN SNACs

SNAC List
Subgroup Origin Name
0x0001 Any ADMIN__ERR
This is the error SNAC for the ADMIN foodgroup.
0x0002 Client ADMIN__INFO_QUERY
Request account information. Host should reply with ADMIN__INFO_REPLY.
0x0003 Host ADMIN__INFO_REPLY
Reply to ADMIN__INFO_QUERY, may contain either account information or an error code and/or URL on failure.
0x0004 Client ADMIN__INFO_CHANGE_REQUEST
Change information request. Information may include screenname format, password, email address, and so on. Host will reply with ADMIN__INFO_CHANGE_REPLY.
0x0005 Host ADMIN__INFO_CHANGE_REPLY
This is the response for ADMIN__INFO_CHANGE_REQUEST and may either confirm changes or contain an error code and/or URL.
0x0006 Client ADMIN__ACCT_CONFIRM_REQUEST
Request to confirm account via email.
0x0007 Host ADMIN__ACCT_CONFIRM_REPLY
Response to ADMIN__ACCT_CONFIRM_REQUEST, may contain status change, pending email confirmation notice, or error message.
0x0008 Client ADMIN__ACCT_DELETE_REQUEST
Account delete request. Host will reply with ADMIN__ACCT_DELETE_REPLY.
0x0009 Host ADMIN__ACCT_DELETE_REPLY
The account delete reply will either contain confirmation or an error code and/or URL.