GameAccountError

• Forbidden - 403 status code
  - Access denied
• Unauthorized - 401 status code
  - Account token expired

GameAccount

• id - String
• display_name - String
• game_id - String

GameTokenRequest

• game_account_id - String
  - Maps to platformGameAccountId
• gsid - GameSessionId
• game_id - String

GameforgeAuthRequest

• blackbox - Blackbox
• email - String
• password - String
• locale - Locale

Summary

Implement the logic to send request to the /api/v1/auth/thin/codes endpoint.

Details

This endpoint requires an encrypted black-box (#6), authentication to the Gameforge API (#19) and a custom User-Agent (#25)

Tasklist

• #6
• #19
• #25
• #13
• #14
• #17

GameforgeAuthResponse

• token - String

Let's move the fingerprint and blackbox modules from the gf-auth crate to the gf-auth-model crate, this way we can use those custom types inside other models and provide a shared place where their logic is stored.

GameTokenError

• Forbidden - 403 status code
  - Access denied
• Unauthorized - 401 status code
  - Account token expired

GameTokenResponse

• token - String

Summary

Implement logic to handle the /api/v1/user/accounts endpoint.

Details

To make this endpoint work we need to authenticate to the Gameforge API (#19).

Tasklist

• #19
• #11
• #12

Create a sub-module for fingerprint to define utility functions.

Create a custom FingerprintVector struct that allows easier updating and type safety.

We can split reqwest and ureq modules into sub-modules that for example implement From traits for HttpError, this can gradually improve code readability.

Tasklist:

• Implement the Serialize trait to encrypt the blackbox.
• #4

Identity is a helper struct composed of:

• Timing settings
• Fingerprint
• Installation ID

It is meant to be loaded by the IdentityManager and provide the necessary configuration values needed for authentication (apart from the actual account details).

IdentityManager is a helper struct providing methods necessary during authentication.

Summary

Implement logic for sending authentication requests to the /api/v1/auth/sessions endpoint.

Details

To implement this endpoint we need a method to "generate" a blackbox (#5) as it is required as input in the request, we also need a captcha solver (#20) to solve Gameforge's captchas if needed.

Tasklist

• Fingerprint implementation
• #5
• #7
• #8
• #9
• #12
• #15
• #20

Summary

Implement logic to handle the /api/v1/auth/iovation endpoint.

Details

To send this request we need a method to "generate" a blackbox (#5) and authenticate to the Gameforge API (#19). We also need to send an OPTIONS request before the actual one, since Gameforge will deny any request that doesn't do that.

Tasklist

• #5
• #19

GameAccountResponse

Alias: Vec<GameAccount>

GameSessionId is a wrapper around gsid and provides type safety and ease of usage.

GameforgeAuthError

• Captcha - 409 status code
  - Captcha needs to be solved before logging in
• Unauthorized - 403 status code
  - Invalid email or password