Protocols/OSCAR/SNAC/ADMIN INFO REPLY

From NINA Wiki
Jump to navigation Jump to search
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, 0x0003 Host ADMIN__INFO_REPLY Unspecified ADMIN Active 1.9

Reply to ADMIN__INFO_QUERY, may contain either account information or an error code and/or URL on failure.

SNAC Header

Foodgroup uint16 (word) 00 07
Subgroup uint16 (word) 00 03
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,03) ADMIN__INFO_REPLY


This is the client account info (screen-name formating, email info, etc) requested via SNAC(07,02). It also may contain error code / error url instead if request failed.

 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 subcode
 xx xx   word   TLV.Length
 xx xx   word   error subcode (see below)
 00 04   word   TLV.Type(0x04) - error description url
 xx xx   word   TLV.Length
 xx ..   string   Error description url string


Here is known administrative error codes list:

  0x0001   validate nickame
  0x0002   validate password
  0x0003   validate e-mail
  0x0004   service temporarily unavailable
  0x0005   field change temporarily unavailable
  0x0006   invalid nickname
  0x0007   invalid password
  0x0008   invalid e-mail
  0x0009   invalid registration preference
  0x000A   invalid old password
  0x000B   invalid nickname length
  0x000C   invalid password length
  0x000D   invalid e-mail length
  0x000E   invalid old password length
  0x000F   need old password
  0x0010   read only field
  0x0011   write only field
  0x0012   unsupported type
  0x0013   all other errors
  0x0014   bad snac
  0x0015   invalid account
  0x0016   deleted account
  0x0017   expired account
  0x0018   no database access
  0x0019   invalid database fields
  0x001A   bad database status
  0x001B   migration cancel
  0x001C   internal error
  0x001D   pending request
  0x001E   not dt status
  0x001F   outstanding confirm
  0x0020   no e-mail address
  0x0021   over limit
  0x0022   e-mail host fail
  0x0023   dns fail



Example SNAC dumps with flap header:


  2A 02 3D 1E 00 28 00 07 00 03 00 00 00 02 00 02  *.=..(..........
  00 03 00 01 00 11 00 16 41 56 53 68 75 74 6B 6F  ........AVShutko
  40 6D 61 69 6C 2E 6B 68 73 74 75 2E 72 75        @mail.khstu.ru



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.