Protocols/OSCAR/SNAC/USER LOOKUP FIND BY EMAIL

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
0x000A, 0x0002 Client USER_LOOKUP__FIND_BY_EMAIL Unspecified BOS Active 1.9

Search for other users by email address.

SNAC Header

Foodgroup uint16 (word) 00 0A
Subgroup uint16 (word) 00 02
Flags uint16 (word) 00 00
Request ID uint32 (dword) 00 00 00 00

SNAC Data

Unconfirmed: This SNAC contains no data

6.3 Finding People

The OSCAR BOS (basic services) allows a few rudimentrary methods of locating other AIM and AOL users.

6.3.1 Finding by EMail Address

A "find SN by email address" request is facilitated by the "Request Screen Name by Address" command in next table.

Fig 6.3.1.1 Request Screen Name by Address

Position Length Data
1 Word 0x000a
3 Word 0x0002
5 Word 0x0000
7 DWord Request ID
11 ASCII String Email Address (unterminated)

Please notice the lack of a length byte/word prefixed to the email address. It's kind of strange for this derivation in behavior, but AOL can do what they want.

The server's response to that is the "Search by Address Response" command, explaned in the next table. Please note that there may be several screen names per email address.

Fig 6.3.1.2 Search by Address Response

Position Length Data
1 Word 0x000a
3 Word 0x0003
5 Word 0x0000
7 DWord Request ID
11* Word 0x0001
13* Word SN Length
15* ASCII String SN (unterminated)
* Field repeats for every listed screen name.

And if no screen names are found, we get the "Search by Address Response Fail" command below.

Fig 6.3.1.3 Search by Address Fail

Position Length Data
1 Word 0x000a
3 Word 0x0001
5 Word 0x0000
7 DWord Request ID
11 Word 0x0014

6.3.2 Finding by Name

It would appear that AIM no longer has the feature of being able to find by name. That now takes you to the address: http://www.aol.com/netfind/whitepages.html. I sure thought it used to do this....


From Aleksandr Shutko: SNAC(0A,02) client search by email request SNAC(0A,02) CLI_SEARCHxBYxEMAIL


Use this to search AIM account by email address associated with it. Server will reply via SNAC(0A,03) or via SNAC(0A,01) - error.

 00 0A   word   SNAC family
 00 02   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx ..   string   email address string


Example SNAC dump with flap header:


  2A 02 33 73 00 17 00 0A  00 02 00 00 00 00 00 02 *.3s............
  61 61 61 61 61 40 61 61  61 61 2E 72 75          aaaaa@aaaa.ru



USER_LOOKUP SNACs

SNAC List
Subgroup Origin Name
0x0001 Any USER_LOOKUP__ERR
This is the error SNAC for the USER_LOOKUP foodgroup.
0x0002 Client USER_LOOKUP__FIND_BY_EMAIL
Search for other users by email address.
0x0003 Host USER_LOOKUP__FIND_REPLY
Response to search queries.