Struct lu_packets::auth::server::LoginRequest

pub struct LoginRequest {
    pub username: LuWString33,
    pub password: LuWString41,
    pub locale_id: u16,
    pub client_os: ClientOs,
    pub computer_stats: ComputerStats,
}

Provides username and password to authenticate the client.

Also provides system stats for analytics.

Trigger

Receipt of Handshake with a service_id of ServiceId::Auth.

Handling

Look up the username and a hashed form of the password in the database. If there is a match, generate a session key to be used as an auth token when the client connects to world servers, and save it to DB. Generate session keys in a way that makes it impossible for an attacker to guess a session key with non-neglible probability. Specifically, this means that using an incrementing number or a non-cryptographically-secure pseudo-random number generator for session keys is not secure.

In addition, determine the address of a char server to redirect the client to.

Response

Respond with LoginResponse, using an appropriate variant to indicate the lookup status, passing the session key and redirect address if successful.

Notes

The password is provided in plain text. Don’t save this password to the database unprocessed, as this constitutes a security hazard. Hash and salt it using a strong cryptographic hash function before saving it.

Fields

username: LuWString33

The client’s user name.

password: LuWString41

The client’s password.

locale_id: u16

The client’s locale.

client_os: ClientOs

The client’s operating system.

computer_stats: ComputerStats

Stats about the computer the client is running on.

Trait Implementations

impl Debug for LoginRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<__ENDIO_ENDIANNESS: Endianness, __ENDIO_READER: Read + ERead<__ENDIO_ENDIANNESS>> Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER> for LoginRequestwhere
    LuWString33: Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER>,
    LuWString41: Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER>,
    u16: Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER>,
    ClientOs: Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER>,
    ComputerStats: Deserialize<__ENDIO_ENDIANNESS, __ENDIO_READER>,

fn deserialize(reader: &mut __ENDIO_READER) -> Result<Self>

Deserializes the type by reading from the reader.

impl PartialEq<LoginRequest> for LoginRequest

fn eq(&self, other: &LoginRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'__ENDIO_LIFETIME, __ENDIO_ENDIANNESS: Endianness, __ENDIO_WRITER: Write + EWrite<__ENDIO_ENDIANNESS>> Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER> for &'__ENDIO_LIFETIME LoginRequestwhere
    &'__ENDIO_LIFETIME LuWString33: Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER>,
    &'__ENDIO_LIFETIME LuWString41: Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER>,
    &'__ENDIO_LIFETIME u16: Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER>,
    &'__ENDIO_LIFETIME ClientOs: Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER>,
    &'__ENDIO_LIFETIME ComputerStats: Serialize<__ENDIO_ENDIANNESS, __ENDIO_WRITER>,

fn serialize(self, writer: &mut __ENDIO_WRITER) -> Result<()>

Serializes the type by writing to the writer.

impl StructuralPartialEq for LoginRequest