Global Login System Authentication Service
The GLS AuthServer service is responsible for handling front end authentication requests and managing authentication tickets for clients. It is consumed by the game launcher and provides profile and subscription information.
The following operations are supported. For a formal definition, please review the Service Description.
Authenticates the supplied user credentials. If the supplied username and password are verified by the back-end billing system, this method will return an authentication ticket that can be used to hand off authentication status to other services (such as the game server) as well as a user profile that describes the subscriptions available to this user. Unsuccessful authentication attempts will cause an exception to be thrown which may contain information from the billing system. If that happens, either the username does not exist, or the password was incorrect. The authentication ticket that is returned is valid for a fixed period of time. If it is necessary to maintain an authentication context for longer than a few minutes, the RefreshTicket method should be used to obtain an extended ticket.
Refreshes an authentication ticket. If a valid ticket is presented, this method will return another ticket that is valid for an extended period of time. This mechanism can be used to keep an authentication context valid for the full period of a user's contact with Turbine services. An exception will be thrown if the ticket cannot be renewed for any reason. In particular, an expired ticket will cause a TicketExpiredException to be thrown. If that happens, a Call to LoginAccount will be necessary to re-authenticate the account.