Difference between revisions of "Protocols/OSCAR/Sign On"

From NINA Wiki
Jump to navigation Jump to search
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
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)


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