Difference between revisions of "Protocols/OSCAR/Sign On"
Line 160: | Line 160: | ||
--> | --> | ||
+ | |||
+ | === FLAP Login Sign On Errors (Temp) === | ||
+ | |||
+ | Standard Format Login Errors during Phase 1 | ||
+ | |||
+ | These occur in response to the initial Phase 1 login command sent from the client. All Standard Format login errors follow this format. This error command is always in the Command Family 0x04. All variable-length strings are assumed to be 1 byte long when doing position numbers. | ||
+ | |||
+ | {| border="1" | ||
+ | | Position | ||
+ | | Data Size | ||
+ | | Data | ||
+ | |- | ||
+ | | 1 | ||
+ | | Word | ||
+ | | 0x0001 | ||
+ | |- | ||
+ | | 3 | ||
+ | | Word | ||
+ | | Screen Name Length (not including null) | ||
+ | |- | ||
+ | | 5 | ||
+ | | ASCIIZ String | ||
+ | | Screen Name that failed (null-terminated) | ||
+ | |- | ||
+ | | 6 | ||
+ | | Byte | ||
+ | | 0x04 | ||
+ | |- | ||
+ | | 7 | ||
+ | | Word | ||
+ | | Error Message URL Length (not including null) | ||
+ | |- | ||
+ | | 9 | ||
+ | | ASCIIZ String | ||
+ | | Error Message URL (null-terminated) | ||
+ | |- | ||
+ | | 10 | ||
+ | | Byte | ||
+ | | 0x08 | ||
+ | |- | ||
+ | | 11 | ||
+ | | Byte | ||
+ | | 0x00 | ||
+ | |- | ||
+ | | 12 | ||
+ | | Byte | ||
+ | | 0x02 | ||
+ | |- | ||
+ | | 13 | ||
+ | | Word | ||
+ | | Specific Error Code | ||
+ | |} | ||
+ | |||
+ | The current list of known "Specific Error Code"s: | ||
+ | |||
+ | {| border="1" | ||
+ | | Specific Error Code | ||
+ | | Error Msg URL | ||
+ | | Meaning | ||
+ | |- | ||
+ | | 0x0001 | ||
+ | | http://www.aim.aol.com/errors/UNREGISTERED_SCREENNAME.html | ||
+ | | Invalid Screen Name | ||
+ | |- | ||
+ | | 0x0005 | ||
+ | | http://www.aim.aol.com/errors/MISMATCH_PASSWD.html | ||
+ | | SN/Pasword Mismatch (Invalid Password) | ||
+ | |} | ||
=== TLV Class: FLAP__SIGNON_TAGS === | === TLV Class: FLAP__SIGNON_TAGS === |
Revision as of 15:22, 23 March 2020
OSCAR Protocol |
Introduction • Terms • Clients |
Basic |
Datatypes • FLAP • SNAC • TLV |
UUIDs • Errors • Tool IDs |
Host Interaction |
Rate Limits • Migration • Messages |
Other Services |
ADMIN • ADVERT • ALERT |
BART • BOS • BUCP • CHAT |
CHAT_NAV |
Tutorials |
Sign On • BART • Rendezvous |
ICBM • Locate • Buddies |
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) |
Connection overview
Connection Acknowledge
Authorization Request - notes from another
Authorization Successful Response - notes from another
Auth error notes from another
BOS Signon Request
FLAP Login Sign On Errors (Temp)
Standard Format Login Errors during Phase 1
These occur in response to the initial Phase 1 login command sent from the client. All Standard Format login errors follow this format. This error command is always in the Command Family 0x04. All variable-length strings are assumed to be 1 byte long when doing position numbers.
Position | Data Size | Data |
1 | Word | 0x0001 |
3 | Word | Screen Name Length (not including null) |
5 | ASCIIZ String | Screen Name that failed (null-terminated) |
6 | Byte | 0x04 |
7 | Word | Error Message URL Length (not including null) |
9 | ASCIIZ String | Error Message URL (null-terminated) |
10 | Byte | 0x08 |
11 | Byte | 0x00 |
12 | Byte | 0x02 |
13 | Word | Specific Error Code |
The current list of known "Specific Error Code"s:
Specific Error Code | Error Msg URL | Meaning |
0x0001 | http://www.aim.aol.com/errors/UNREGISTERED_SCREENNAME.html | Invalid Screen Name |
0x0005 | http://www.aim.aol.com/errors/MISMATCH_PASSWD.html | SN/Pasword Mismatch (Invalid Password) |
TLV Class: FLAP__SIGNON_TAGS
These tags are used in the FLAP signon frame to BOS. They appear right after the 4 byte version number.
@MAKE NOTE: Difference between ones used if BUCP is in use and ones if clientLogin or w/e was used
Name | Tag | Type | Notes |
---|---|---|---|
OSERVICE__TLV_TAGS_CLIENT_IDENTITY | 0x03 | string | Yet another client name |
OSERVICE__TLV_TAGS_LOGIN_COOKIE | 0x06 | blob | Login cookie returned by startOSCARSession |
OSERVICE__TLV_TAGS_MAJOR_VERSION | 0x17 | uint16 (word) | Client major version: (1) if the client version is "1.2.3" |
OSERVICE__TLV_TAGS_MINOR_VERSION | 0x18 | uint16 (word) | Client minor version: (2) if the client version is "1.2.3" |
OSERVICE__TLV_TAGS_POINT_VERSION | 0x19 | uint16 (word) | Client minor version: (3) if the client version is "1.2.3" |
OSERVICE__TLV_TAGS_BUILD_NUM | 0x1A | uint16 (word) | Client build number, usually monotonically increasing |
OSERVICE__TLV_TAGS_MULTICONN_LEVEL | 0x4A | uint8 (byte) | [Class: OSERVICE__MULTICONN_FLAGS] Should almost always be 0x01 |
OSERVICE__TLV_TAGS_CLIENT_RECONNECT | 0x94 | uint8 (byte) | Client claims it is reconnecting because it got knocked off |
Class: OSERVICE__MULTICONN_FLAGS
These flags control how multiple instances are handled by the servers and if current sessions need to be bumped off when a new session signs on.
Name | Value | Notes |
---|---|---|
OSERVICE__MULTICONN_LEVEL_OLD_CLIENT | 0x00 | Don't use |
OSERVICE__MULTICONN_LEVEL_MULTI | 0x01 | This is a recent client that understands multiple instances |
OSERVICE__MULTICONN_LEVEL_SINGLE | 0x03 | This is a recent client that understands multiple instances but does not want them |