Packets/Login/Vanilla: Difference between revisions

From wowdev
Jump to navigation Jump to search
(→‎Body: Add realmlist realm category values)
m (→‎Opcodes and Errors: Add notice about security flags)
 
(18 intermediate revisions by the same user not shown)
Line 3: Line 3:
== Opcodes and Errors ==
== Opcodes and Errors ==


{| class="wikitable"
See [[Login Packet]]s. The opcode value corresponds to the packet name.
|+ Opcodes
! Name
! Value
! Description
|-
!colspan="3"| Authentication
|-
| LOGIN_CHALL || 0x00 || Intial information sent by client and then challenge by server.
|-
| LOGIN_PROOF || 0x01 || Proof sent by client and then server.
|-
| RECON_CHALL || 0x02 || Reconnect challenge sent by client and then server.
|-
| RECON_PROOF || 0x03 || Reconnect proof sent by client and then server.
|-
| SURVEY_RESULT || 0x04 || Used for hardware survey.
|-
!colspan="3"| Realmlist
|-
| REALMLIST || 0x10 || Realmlist request sent by client and realmlist information sent by server.
|-
!colspan="3"| Patching
|-
| XFER_INITIATE || 0x30 || Used for patching.
|-
| XFER_DATA || 0x31 || Used for patching.
|-
| XFER_ACCEPT || 0x32 || Used for patching.
|-
| XFER_RESUME || 0x33 || Used for patching.
|-
| XFER_CANCEL || 0x34 || Used for patching.
|}


{| class="wikitable"
See [[Login Packet Results]] for result values.
|+ Error codes
 
! Name
See [[Login Packet Security Flags]] for security flag values. These are only used for {{Template:Sandbox/PrettyVersion|expansionlevel=2}} and later.
! Value
|-
| LOGIN_OK || 0x00
|-
| LOGIN_FAILED || 0x01
|-
| LOGIN_FAILED2 || 0x02
|-
| LOGIN_BANNED || 0x03
|-
| LOGIN_UNKNOWN_ACCOUNT || 0x04
|-
| LOGIN_UNKNOWN_ACCOUNT3 || 0x05
|-
| LOGIN_ALREADYONLINE || 0x06
|-
|  LOGIN_NOTIME || 0x07
|-
| LOGIN_DBBUSY || 0x08
|-
| LOGIN_BADVERSION || 0x09
|-
| LOGIN_DOWNLOAD_FILE || 0x0A
|-
| LOGIN_FAILED3  || 0x0B
|-
| LOGIN_SUSPENDED  || 0x0C
|-
| LOGIN_FAILED4 || 0x0D
|-
| LOGIN_CONNECTED || 0x0E
|-
| LOGIN_PARENTALCONTROL || 0x0F
|-
| LOGIN_LOCKED_ENFORCED || 0x10
|}


==Challenge packets==
==Challenge packets==


{| class="wikitable"
=== Client ===
|+ AuthLogonChallenge_Client
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || command || LOGIN_CHALL (0x0), AuthReconnectionChallenge_Client has RECON_CHALL (0x2).
|-
| 0x1 || 1 / - || uint8 || protocol_version || 3 for 1.12, unknown for 1.1.
|-
| 0x2 || 2 / Little || uint16 || size || length of package minus the size of the command,<br> protocol_version and size fields (4 bytes).<br>The size can be calculated as 30 (0x1E) + account_name_len,<br> see that field for a maximum.
|-
| 0x4 || 4 / Little || uint8[4] || gamename || Always null terminated 'WoW\0' string.
|-
| 0x8 || 3 / - || uint8[3] || version || [0x01, 0x01, 0x02] for 1.1.2. [0x01, 0x0C, 0x01] for 1.12.1.
|-
| 0xB || 2 / Little || uint16 || build || 4125, aka [[Rev|Revision]]
|-
| 0xD || 4 / Big || uint8[4] || platform || eg '\0x86'. Has a leading zero for 'x86'.
|-
| 0x11 || 4 / Big || uint8[4] || os || eg '\0Win'. Has a leading zero for 'Win'.
|-
| 0x15 || 4 / Big || uint8[4] || locale || eg 'enUS'
|-
| 0x19 || 4 / Little || uint32 || worldregion_bias || Offset in minutes from UTC time,<br> eg. 180 means 180 minutes
|-
| 0x1D || 4 / Big || uint32 || ip || client_ip
|-
| 0x21 || 1 / - || uint8 || account_name_lenth || Length of the account_name field in bytes.<br> The client can only send 16 characters, <br> but this can still be more than 16 bytes if non-ASCII characters are used.
|-
| 0x22 || account_name_len / Big || uint8[account_name_len] || account_name || UTF-8 encoded uppercase string of the username.<br> Not all unicode characters are uppercased correctly.
|}


=== {{Template:Sandbox/PrettyVersion|expansionlevel=1|build=1.1.2.4125}} ===
See [[CMD_AUTH_LOGON_CHALLENGE_Client]].


{| class="wikitable"
=== Server ===
|+ AuthLogonChallenge_Server
! Offset
! Type
! Name
! Description
|-
| 0x1 || uint8 || command || LOGIN_CHALL (0x0)
|-
| 0x2 || uint8 || protocol_version || Must be 0.
|-
| 0x3 || uint8 || result ||
|-
| 0x4 || char[32] || B || SRP public server ephemeral
|-
| 0x24 || uint8 || g_len || SRP generator length
|-
| 0x25 || uint8 || g || SRP generator
|-
| 0x26 || uint8 || n_len || SRP modulus length
|-
| 0x27 || char[32] || n || SRP modulus
|-
| 0x47 || char[32] || srp_salt || SRP user's salt
|-
| 0x47 || char[16] || crc_salt || A salt to be used in AuthLogonProof_Client.crc_hash
|}


=== {{Template:Sandbox/PrettyVersion|expansionlevel=1|build=1.12.1.5875}} ===
See [[CMD_AUTH_LOGON_CHALLENGE_Server]].
 
The AuthLogonChallenge_Server packet has added the two_factor_authentication field and will hang waiting for it to be sent.
 
{| class="wikitable"
|+ AuthLogonChallenge_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
!colspan="5"| Header
|-
| 0x1 || 1 / - || uint8 || command || LOGIN_CHALL (0x0)
|-
| 0x2 || 1 / -  || uint8 || protocol_version || Must be 0.
|-
| 0x3 || 1 / - || uint8 || result || The fields below are only included if this is LOGIN_OK (0x0).
|-
!colspan="5"| Body
|-
| 0x4 || 32 / Little || uint8[32] || B || SRP public server ephemeral.<br>All SRP operations are performed with little endian values.
|-
| 0x24 || 1 / - || uint8 || g_len || SRP generator length.<br> Should always be 1 since the generator is never larger than 255.
|-
| 0x25 || g_len / - || uint8 || g || SRP generator. All SRP operations are performed with little endian values.
|-
| (0x26) || 1 / - || uint8 || n_len || SRP modulus length. Client will not read more than 32.<br>All SRP operations are performed with little endian values.
|-
| (0x27) || n_len / Little || uint8[n_len] || n || SRP modulus. All SRP operations are performed with little endian values.
|-
| (0x47) || 32 / Little || uint8[32] || srp_salt || SRP user's salt. All SRP operations are performed with little endian values.
|-
| (0x47) || 16 / Little || uint8[16] || crc_salt || A salt to be used in AuthLogonProof_Client.crc_hash.<br>Can be all zeros.
|-
| (0x57) || 1 / - || bool (size 1 byte) || two_factor_authentication || 0 for disabled. The fields below are not included if this is 0.
|-
!colspan="5"| PIN
|-
| (0x58) || 4 / Little || uint32 || pin_grid_seed || Seed value for the PIN grid on the client.<br> Only here if the two_factor_authentication field is true.
|-
| (0x5c) || 16 / Little || uint8[16] || pin_salt || Salt value for the client.<br> Only here if the two_factor_authentication field is true.
|}
 
The offsets in parentheses are not fixed since they depend on the lengths of previous fields, but these fields are most often the default values so the offsets are presented as semi-fixed.


==Proof packets==
==Proof packets==


=== {{Template:Sandbox/PrettyVersion|expansionlevel=1|build=1.1.2.4125}} ===


{| class="wikitable"
=== Client ===
|+ AuthLogonProof_Client
! Offset
! Type
! Name
! Description
|-
| 0x0 || uint8 || command || 0x1
|-
| 0x1 || uint8[32] || a
|-
| 0x21 || uint8[20] || m1
|-
| 0x35 || uint8[20] || crc_hash
|-
| 0x49 || uint8 || num_keys
|}


{| class="wikitable"
See [[CMD_AUTH_LOGON_PROOF_Client]].
|+ AuthLogonProof_Server
! Offset
! Type
! Name
! Description
|-
| 0x0 || uint8 || command || 0x1
|-
| 0x1 || uint8 || error
|-
| 0x2 || uint8[20] || m2
|-
| 0x16 || uint32 || unk
|}


=== {{Template:Sandbox/PrettyVersion|expansionlevel=1|build=1.12.1.5875}} ===
=== Server ===


==== Client ====
See [[CMD_AUTH_LOGON_PROOF_Server]].


{| class="wikitable"
==Reconnection challenge packets==
|+ AuthLogonProof_Client
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || command || LOGIN_PROOF (0x1)
|-
| 0x1 || 32 / Little  || uint8[32] || a || SRP6 Client public key. Called A (capital A) in RFC2945.
|-
| 0x21 || 20 / Little || uint8[20] || m1 || SRP6 Client proof.
|-
| 0x35 || 20 / Little || uint8[20] || crc_hash || Hash of arbitrary files. Can be safely ignored.
|-
| 0x49 || 1 / - || uint8 || num_keys || Used for unknown telemetry. Can be expected to always be 0.<br>See the table below for when it is not 0.
|-
| 0x4A || 1 / - || bool (size 1 byte) || two_factor_enabled || If false the packet ends here, if true the fields in the table below are included.<br> Added in 1.12.x client branch.
|}


When num_keys is not 0, the field is followed by 4 key data fields that repeat num_key times.
=== Client ===


{| class="wikitable"
The reconnect client packet has the same format as [[CMD_AUTH_LOGON_CHALLENGE_Client]] except that the opcode field is 0x2 instead of 0x0.
|+ num_keys Fields
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| || 2 / - || uint16 || unk1 || Used for unknown telemetry. Can be expected to not be present.
|-
| || 4 / - || uint32 || unk2 || Used for unknown telemetry. Can be expected to not be present.
|-
| || 4 / - || uint8[4] || unk3 || Used for unknown telemetry. Can be expected to not be present.
|-
| || 20 / - || uint8[20] || unk4 || Used for unknown telemetry. Can be expected to not be present.
|}


When two_factor_enabled is not 0, the field is followed by the data in the table below.
=== Server ===


{| class="wikitable"
See [[CMD_AUTH_RECONNECT_CHALLENGE_Server]].
|+ two_factor_enabled Fields
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| || 16 / ? || uint8[16] || pin_salt || Salt used for PIN. Only included if two_factor_enabled is true.
|-
| || 20 / ? || uint8[20] || pin_hash || Client proof for PIN. Only included if two_factor_enabled is true.
|}


==== Server ====
==Reconnection proof packets==


{| class="wikitable"
=== Client ===
|+ AuthLogonProof_Server
! Offset
! Size
! Type
! Name
! Description
|-
!colspan="5"| Header
|-
| 0x0 || 1 / - || uint8 || command || LOGIN_PROOF (0x1)
|-
| 0x1 || 1 / - || uint8 || error || The fields below are only included if this is LOGIN_OK (0x0).
|-
!colspan="5"| Body
|-
| 0x2 || 20 / Little || uint8[20] || m2 || SRP6 Server proof.
|-
| 0x16 || 4 / Little || uint32 || hardware_survey_id || ID of a hardware survey that the client should perform. <br>Set to 0 to not use. Can safely be set to 0.
|}


==Reconnection challenge packets==
See [[CMD_AUTH_RECONNECT_PROOF_Client]].


AuthReconnectionChallenge_Client has the same structure as AuthLogonChallenge_Client, except that the command is RECON_CHALL (0x2).
To check if the client proof is correct, the server must calculate SHA1(account_name | proof_data | challenge_data | session_key) and compare it to client_proof.


{| class="wikitable"
=== Server ===
|+ AuthReconnectionChallenge_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
!colspan="5"| Header
|-
| 0x0 || 1 / - || uint8 || command || RECON_CHALL (0x2)
|-
| 0x1 || 1 / - || uint8 || error || The fields below are only included if this is LOGIN_OK (0x0).
|-
!colspan="5"| Body
|-
| 0x2 || 16 / Little || char[16] || challenge_data || Random data, used as challenge data.
|-
| 0x12 || 16 / - || char[16] || checksum_salt || No longer used by client in 1.12. Can be all zeros.
|}
 
==Reconnection proof packets==


{| class="wikitable"
See [[CMD_AUTH_RECONNECT_PROOF_Server]].
|+ AuthReconnectionProof_Client
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || command || RECON_PROOF (0x3)
|-
| 0x1 || 16 / Little || uint8[16] || proof_data || Challenge data used for calculating proof.
|-
| 0x11 || 20 / Little || uint8[20] || client_proof || SRP6 Client proof.
|-
| 0x25 || 20 / ? || uint8[20] || client_checksum || Unknown.
|-
| 0x39 || 1 / - || uint8 || key_count || Unknown. Can be expected to always be 0.
|}
 
To check if the client proof is correct, the server must calculate SHA1(account_name | proof_data | challenge_data | session_key) and compare it to client_proof.
 
{| class="wikitable"
|+ AuthReconnectionProof_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || command || RECON_PROOF (0x3)
|-
| 0x1 || 1 / - || uint8 || error || Return 0 if the client calculated proof matches the server calculated proof.
|}


==Realm list packets==
==Realm list packets==
Line 377: Line 56:
=== Client ===
=== Client ===


{| class="wikitable"
See [[CMD_REALM_LIST_Client]].
|+ RealmList_Client
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || cmd || REALMLIST (0x10)
|-
| 0x1 || 4 / - || uint32 || unknown || Hardcoded to 0 in the client. Can be expected to always be 0.
|-
|}


=== Server ===
=== Server ===


The server answers with a packet composed of a RealmHeader_Server, as many
See [[CMD_REALM_LIST_Server]].
RealmInfo_Server as specified and a RealmFooter_Server.
 
==== Header ====
 
{| class="wikitable"
|+ RealmHeader_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 1 / - || uint8 || command || REALMLIST (0x10)
|-
| 0x1 || 2 / Little || uint16 || size || Size of the rest of packet, without the command and size fields (3 bytes).
|-
| 0x3 || 4 / - || uint32 || unknown || Not used in public clients. Set to 0.
|-
| 0x7 || 1 / - || uint8 || num_realms || Number of RealmInfo_Server.
|-
|}
 
The size value can be computed with the part of the header taken into account
plus the footer (5+2 bytes) and the size of every RealmInfo_Server which is
variable.
 
==== Body ====
 
{| class="wikitable"
|+ RealmInfo_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 4 / Little || uint32 || realm_type || 0 is normal, 1 is PvP, 6 is RP and 8 is RPPvP.
|-
| 0x4 || 1 / - || uint8 || flags || See RealmInfo_Server.flags table below.
|-
| 0x5 || - / Big || char[] || realm_name || Zero terminated string; name of the Realm
|-
| || - / Big || char[] || address_port || Zero terminated string; address of the Realm ("ip:port")
|-
| || 4 / Little || float || population || Population value.<br>200 is always green "Recommended", <br>400 is always red "Full",<br>600 is always blue "Recommended".<br>Low/Medium/High are calculated based on the population values sent.
|-
| || 1 / - || uint8 || num_chars || The number of characters the client has on the server.
|-
| || 1 / - || uint8 || realm_category || The language or region of the server.<br>How this is interpreted depends on the locale of the client.<br>It is shown as tabs at the bottom of the realmlist screen.<br>If there are only realms of one category no tabs are shown.<br>See table RealmInfo_Server.realm_category Values.
|-
| || 1 / - || uint8 || realm_id ||
|-
|}
 
{| class="wikitable"
|+ RealmInfo_Server.flags Values
! Value
! Name
! Description
|-
| 0x00 || NONE || No changes.
|-
| 0x01 || INVALID || Color realm name in read.
|-
| 0x02 || OFFLINE || Gray out name and prevent selection.
|-
| 0x04 || SPECIFY_BUILD || Unused. Possibly used to list realm build numbers previously.
|-
| 0x08 || UNK1 || Unused.
|-
| 0x10 || UNK2 || Unused.
|-
| 0x20 || FORCE_RECOMMENDED || Forces the client to show the server as "Recommended" in blue text,<br> no matter what the population value is.
|-
| 0x40 || FORCE_NEW_PLAYERS || Forces the client to show the server as "Recommended" in green text,<br> no matter what the population value is.
|-
| 0x80 || FORCE_FULL || Forces the client to show the population as "Full" in red text,<br> no matter what the population value is.
|-
|}
 
{| class="wikitable"
|+ RealmInfo_Server.realm_category Values
! Value
! Name
! Description
|-
| 0x00 || DEFAULT || Same as the first value for a locale.
|-
!colspan="3"| US
|-
| 0x01 || UNITED_STATES || United States.
|-
| 0x05 || OCEANIC || Oceania.
|-
!colspan="3"| EUROPE
|-
| 0x01 || ENGLISH || English.
|-
| 0x02 || GERMAN || German.
|-
| 0x03 || FRENCH || French.
|-
| 0x05 || SPANISH || Spanish.
|-
!colspan="3"| KOREA
|-
| 0x01 || KOREA || Korea.
|-
!colspan="3"| TAIWAN
|-
| 0x01 || TAIWAN || Taiwan.
|-
!colspan="3"| CHINA
|-
| 0x01 || CHINA || China.
|-
| 0x02 || CN3 || Unknown.
|-
| 0x03 || CN7 || Unknown.
|-
!colspan="3"| TEST
|-
| 0x01 || TEST_SERVER || Test.
|-
| 0x05 || OCEANIC_TEST || Oceanic test.
|-
!colspan="3"| QA
|-
| 0x01 || QA_SERVER || QA server.
|}
 
==== Footer ====


{| class="wikitable"
|+ RealmFooter_Server
! Offset
! Size / Endianness
! Type
! Name
! Description
|-
| 0x0 || 2 / ? || uint16 || unknown || Ignored in public clients. Set to 0.
|-
|}


[[Category:Login]]
[[Category:Packet]]
[[Category:Packet]]
[[Category:Packet/Login]]
[[Category:Packet/Login]]

Latest revision as of 21:01, 21 May 2021

It's worth noting that, for build Vanilla (1.1.2.4125), the client automatically disconnects after a successful login challenge and proof exchange and sends a reconnect packet right away instead of asking for the realm list.

Opcodes and Errors

See Login Packets. The opcode value corresponds to the packet name.

See Login Packet Results for result values.

See Login Packet Security Flags for security flag values. These are only used for BC and later.

Challenge packets

Client

See CMD_AUTH_LOGON_CHALLENGE_Client.

Server

See CMD_AUTH_LOGON_CHALLENGE_Server.

Proof packets

Client

See CMD_AUTH_LOGON_PROOF_Client.

Server

See CMD_AUTH_LOGON_PROOF_Server.

Reconnection challenge packets

Client

The reconnect client packet has the same format as CMD_AUTH_LOGON_CHALLENGE_Client except that the opcode field is 0x2 instead of 0x0.

Server

See CMD_AUTH_RECONNECT_CHALLENGE_Server.

Reconnection proof packets

Client

See CMD_AUTH_RECONNECT_PROOF_Client.

To check if the client proof is correct, the server must calculate SHA1(account_name | proof_data | challenge_data | session_key) and compare it to client_proof.

Server

See CMD_AUTH_RECONNECT_PROOF_Server.

Realm list packets

Client

See CMD_REALM_LIST_Client.

Server

See CMD_REALM_LIST_Server.

Retrieved from "https://wowdev.wiki/index.php?title=Packets/Login/Vanilla&oldid=33885"