Protocols/OSCAR/SNAC/BUCP LOGIN RESPONSE: Difference between revisions

From Toxi's Wiki
Jump to navigationJump to search
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Template:Protocols/OSCAR}}
{{Template:Protocols/OSCAR}}
BUCP__LOGIN_RESPONSE_DESCRIPTION
TODO


=== SNAC Header ===
==== Authorized User TLVs ====
{{Template:Protocols/OSCAR/SNAC/Header
{{Template:Protocols/OSCAR/SNAC/Header
|foodgroup=00 17
|foodgroup=00 17
Line 9: Line 9:
|request_id=00 00 00 00}}
|request_id=00 00 00 00}}


=== SNAC Data ===
{{Template:Protocols/OSCAR/SNAC/TLV
The SNAC data is a list of TLVs - the possible TLVs being as follows:
|tlv_type=00 05
|tlv_type_desc=TLV Type (0x0005) - BOS server address
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=BOS server address to connect to}}


BUCP__LOGIN_RESPONSE_TLVS
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 06
|tlv_type_desc=TLV Type (0x0006) - BOS authorization cookie
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=array
|tlv_data_desc=BOS authorization cookie: used when authorizing with the BOS server}}


''May also contain other [[Protocols/OSCAR/TLV#Common_TLVs|common TLVs]].''
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 11
|tlv_type_desc=TLV Type (0x0011) - e-mail address
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=E-mail address (i.e., "toxidation@msn.com")}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 13
|tlv_type_desc=TLV Type (0x0013) - registration status
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=Registration status: 1 - no disclosure, 2 - valid account disclosure, 3 - full disclosure}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 54
|tlv_type_desc=TLV Type (0x0054) - change password URL
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=URL to change your AIM account's password}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 8E
|tlv_type_desc=TLV Type (0x008E) - unknown
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=unknown}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 01
|tlv_type_desc=TLV Type (0x0001) - screen name
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=Screen name}}
 
{{Template:Protocols/OSCAR/SNAC/CommonTLV}}
{{Template:Protocols/OSCAR/SNAC/Footer}}


=== SNAC Dump ===
Example dump (from NINA's servers - dump contains a FLAP header):
Example dump (from NINA's servers - dump contains a FLAP header):
BUCP__LOGIN_RESPONSE_SNAC_DUMP
<pre>
0000  2a 02 00 02 01 b1 00 17 00 03 00 00 00 00 00 00  *...............
0010  00 05 00 14 31 33 34 2e 32 30 39 2e 31 37 35 2e  ....134.209.175.
0020  32 34 36 3a 35 31 39 30 00 06 01 00 03 0a c4 27  246:5190.......'
0030  a8 c4 e3 b8 30 d4 47 84 10 07 20 04 28 05 81 ad  ....0.G... .(...
0040  4c 34 43 71 31 2b f5 e3 15 90 68 fd 87 24 6e 8b  L4Cq1+....h..$n.
0050  82 f4 d6 01 65 dd b4 f7 5a e2 3e 6e b2 e6 85 88  ....e...Z.>n....
0060  9d 3f 90 7a 38 35 01 f5 1f 7f 66 aa 8b 54 13 79  .?.z85....f..T.y
0070  38 c0 17 a1 3a 4c 24 81 1b e8 d8 04 58 fd 6b 0e  8...:L$.....X.k.
0080  ec 3c 5b 6e 8d 5d df cb 77 61 67 23 c8 fa 9f a5  .<[n.]..wag#....
0090  20 a7 2d f1 ba e0 6f f9 b7 ae aa 4f eb 93 68 3a    .-...o....O..h:
00a0  a8 76 b4 c4 a2 08 54 99 bc 54 b4 33 aa b5 09 c8  .v....T..T.3....
00b0  57 cd 1f ea ad 78 2a ec 47 14 ed 94 6e 2c 9c 25  W....x*.G...n,.%
00c0  81 e9 18 d6 d2 87 ed e5 9f b8 0a a1 47 1d a9 06  ............G...
00d0  b0 ad a6 fe d8 3d d6 06 74 a3 1b 00 93 ea 51 6c  .....=..t.....Ql
00e0  ab f1 f5 4f 58 0f cf 2d d4 4a 05 14 25 46 26 03  ...OX..-.J..%F&.
00f0  65 74 f1 11 60 ca a9 16 41 0d 32 e2 bb eb 85 7b  et..`...A.2....{
0100  1a 5e 7f 49 05 9c 15 eb 95 e1 5c e8 24 80 1d f6  .^.I......\.$...
0110  13 ad 24 51 fa 55 eb 49 4f 9a 4a cb 75 23 d2 32  ..$Q.U.IO.J.u#.2
0120  ee 81 6a 02 6a 74 9f ce c4 0e 03 0a 00 11 00 12  ..j.jt..........
0130  74 6f 78 69 64 61 74 69 6f 6e 40 6d 73 6e 2e 63  toxidation@msn.c
0140  6f 6d 00 13 00 02 00 01 00 54 00 58 68 74 74 70  om.......T.Xhttp
0150  3a 2f 2f 61 69 6d 2e 6e 69 6e 61 2e 62 7a 2f 72  ://aim.nina.bz/r
0160  65 64 69 72 65 63 74 73 2f 70 61 73 73 77 6f 72  edirects/passwor
0170  64 2f 63 68 61 6e 67 65 5f 70 61 73 73 77 6f 72  d/change_passwor
0180  64 2e 61 64 70 3f 53 63 72 65 65 6e 4e 61 6d 65  d.adp?ScreenName
0190  3d 25 73 26 63 63 6f 64 65 3d 75 73 26 6c 61 6e  =%s&ccode=us&lan
01a0  67 3d 65 6e 00 8e 00 01 00 00 01 00 0a 74 6f 78  g=en.........tox
01b0  69 64 61 74 69 6f 6e                              idation
</pre>
 
==== Unauthorized User TLVs ====
{{Template:Protocols/OSCAR/SNAC/Header
|foodgroup=00 17
|subgroup=00 03
|flags=00 00
|request_id=00 00 00 00}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 08
|tlv_type_desc=TLV Type (0x0008) - Error code
|tlv_length=00 02
|tlv_data_val=xx xx
|tlv_data_type=string
|tlv_data_desc=Error code: the basic ones are 0x0001 for invalid user and 0x0005 for invalid password, however there are more}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 08
|tlv_type_desc=TLV Type (0x0008) - Error URL
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=Error URL: URL to a page describing the error}}
 
{{Template:Protocols/OSCAR/SNAC/TLV
|tlv_type=00 01
|tlv_type_desc=TLV Type (0x0001) - screen name
|tlv_length=xx xx
|tlv_data_val=xx ..
|tlv_data_type=string
|tlv_data_desc=Screen name}}
 
{{Template:Protocols/OSCAR/SNAC/CommonTLV}}
{{Template:Protocols/OSCAR/SNAC/Footer}}
 
Example dump for a invalid password (from NINA's servers - dump contains a FLAP header):
<pre>
0000  2a 02 00 02 00 74 00 17 00 03 00 00 00 00 00 00  *....t..........
0010  00 08 00 02 00 05 00 04 00 52 68 74 74 70 73 3a  .........Rhttps:
0020  2f 2f 77 69 6b 69 2e 6e 69 6e 61 2e 63 68 61 74  //wiki.nina.chat
0030  2f 77 69 6b 69 2f 43 6c 69 65 6e 74 73 2f 41 4f  /wiki/Clients/AO
0040  4c 5f 49 6e 73 74 61 6e 74 5f 4d 65 73 73 65 6e  L_Instant_Messen
0050  67 65 72 2f 45 72 72 6f 72 73 2f 4d 69 73 6d 61  ger/Errors/Misma
0060  74 63 68 5f 50 61 73 73 77 6f 72 64 00 01 00 0a  tch_Password....
0070  74 6f 78 69 64 61 74 69 6f 6e                    toxidation
</pre>
 
''The invalid user is the same, just with a different code and URL.''

Latest revision as of 20:12, 21 July 2024

OSCAR Protocol
IntroductionTermsClients
Basic
TODO
Tutorials
Sign On
Foodgroups
OSERVICE (0x0001)
BUCP (0x0017)

TODO

Authorized User TLVs

 00 17   word   SNAC foodgroup
 00 03   word   SNAC subgroup
 00 00   word   SNAC flags
 00 00 00 00   dword   SNAC request ID
 00 05   word   TLV Type (0x0005) - BOS server address
 xx xx   word   TLV Length
 xx ..   string   BOS server address to connect to
 00 06   word   TLV Type (0x0006) - BOS authorization cookie
 xx xx   word   TLV Length
 xx ..   array   BOS authorization cookie: used when authorizing with the BOS server
 00 11   word   TLV Type (0x0011) - e-mail address
 xx xx   word   TLV Length
 xx ..   string   E-mail address (i.e., "toxidation@msn.com")
 00 13   word   TLV Type (0x0013) - registration status
 xx xx   word   TLV Length
 xx ..   string   Registration status: 1 - no disclosure, 2 - valid account disclosure, 3 - full disclosure
 00 54   word   TLV Type (0x0054) - change password URL
 xx xx   word   TLV Length
 xx ..   string   URL to change your AIM account's password
 00 8E   word   TLV Type (0x008E) - unknown
 xx xx   word   TLV Length
 xx ..   string   unknown
 00 01   word   TLV Type (0x0001) - screen name
 xx xx   word   TLV Length
 xx ..   string   Screen name
 May contain other common TLVs

Example dump (from NINA's servers - dump contains a FLAP header):

0000   2a 02 00 02 01 b1 00 17 00 03 00 00 00 00 00 00   *...............
0010   00 05 00 14 31 33 34 2e 32 30 39 2e 31 37 35 2e   ....134.209.175.
0020   32 34 36 3a 35 31 39 30 00 06 01 00 03 0a c4 27   246:5190.......'
0030   a8 c4 e3 b8 30 d4 47 84 10 07 20 04 28 05 81 ad   ....0.G... .(...
0040   4c 34 43 71 31 2b f5 e3 15 90 68 fd 87 24 6e 8b   L4Cq1+....h..$n.
0050   82 f4 d6 01 65 dd b4 f7 5a e2 3e 6e b2 e6 85 88   ....e...Z.>n....
0060   9d 3f 90 7a 38 35 01 f5 1f 7f 66 aa 8b 54 13 79   .?.z85....f..T.y
0070   38 c0 17 a1 3a 4c 24 81 1b e8 d8 04 58 fd 6b 0e   8...:L$.....X.k.
0080   ec 3c 5b 6e 8d 5d df cb 77 61 67 23 c8 fa 9f a5   .<[n.]..wag#....
0090   20 a7 2d f1 ba e0 6f f9 b7 ae aa 4f eb 93 68 3a    .-...o....O..h:
00a0   a8 76 b4 c4 a2 08 54 99 bc 54 b4 33 aa b5 09 c8   .v....T..T.3....
00b0   57 cd 1f ea ad 78 2a ec 47 14 ed 94 6e 2c 9c 25   W....x*.G...n,.%
00c0   81 e9 18 d6 d2 87 ed e5 9f b8 0a a1 47 1d a9 06   ............G...
00d0   b0 ad a6 fe d8 3d d6 06 74 a3 1b 00 93 ea 51 6c   .....=..t.....Ql
00e0   ab f1 f5 4f 58 0f cf 2d d4 4a 05 14 25 46 26 03   ...OX..-.J..%F&.
00f0   65 74 f1 11 60 ca a9 16 41 0d 32 e2 bb eb 85 7b   et..`...A.2....{
0100   1a 5e 7f 49 05 9c 15 eb 95 e1 5c e8 24 80 1d f6   .^.I......\.$...
0110   13 ad 24 51 fa 55 eb 49 4f 9a 4a cb 75 23 d2 32   ..$Q.U.IO.J.u#.2
0120   ee 81 6a 02 6a 74 9f ce c4 0e 03 0a 00 11 00 12   ..j.jt..........
0130   74 6f 78 69 64 61 74 69 6f 6e 40 6d 73 6e 2e 63   toxidation@msn.c
0140   6f 6d 00 13 00 02 00 01 00 54 00 58 68 74 74 70   om.......T.Xhttp
0150   3a 2f 2f 61 69 6d 2e 6e 69 6e 61 2e 62 7a 2f 72   ://aim.nina.bz/r
0160   65 64 69 72 65 63 74 73 2f 70 61 73 73 77 6f 72   edirects/passwor
0170   64 2f 63 68 61 6e 67 65 5f 70 61 73 73 77 6f 72   d/change_passwor
0180   64 2e 61 64 70 3f 53 63 72 65 65 6e 4e 61 6d 65   d.adp?ScreenName
0190   3d 25 73 26 63 63 6f 64 65 3d 75 73 26 6c 61 6e   =%s&ccode=us&lan
01a0   67 3d 65 6e 00 8e 00 01 00 00 01 00 0a 74 6f 78   g=en.........tox
01b0   69 64 61 74 69 6f 6e                              idation

Unauthorized User TLVs

 00 17   word   SNAC foodgroup
 00 03   word   SNAC subgroup
 00 00   word   SNAC flags
 00 00 00 00   dword   SNAC request ID
 00 08   word   TLV Type (0x0008) - Error code
 00 02   word   TLV Length
 xx xx   string   Error code: the basic ones are 0x0001 for invalid user and 0x0005 for invalid password, however there are more
 00 08   word   TLV Type (0x0008) - Error URL
 xx xx   word   TLV Length
 xx ..   string   Error URL: URL to a page describing the error
 00 01   word   TLV Type (0x0001) - screen name
 xx xx   word   TLV Length
 xx ..   string   Screen name
 May contain other common TLVs

Example dump for a invalid password (from NINA's servers - dump contains a FLAP header):

0000   2a 02 00 02 00 74 00 17 00 03 00 00 00 00 00 00   *....t..........
0010   00 08 00 02 00 05 00 04 00 52 68 74 74 70 73 3a   .........Rhttps:
0020   2f 2f 77 69 6b 69 2e 6e 69 6e 61 2e 63 68 61 74   //wiki.nina.chat
0030   2f 77 69 6b 69 2f 43 6c 69 65 6e 74 73 2f 41 4f   /wiki/Clients/AO
0040   4c 5f 49 6e 73 74 61 6e 74 5f 4d 65 73 73 65 6e   L_Instant_Messen
0050   67 65 72 2f 45 72 72 6f 72 73 2f 4d 69 73 6d 61   ger/Errors/Misma
0060   74 63 68 5f 50 61 73 73 77 6f 72 64 00 01 00 0a   tch_Password....
0070   74 6f 78 69 64 61 74 69 6f 6e                     toxidation

The invalid user is the same, just with a different code and URL.