de.onyxbits.raccoon.finsky

Class LoginApi

java.lang.Object

de.onyxbits.raccoon.finsky.LoginApi

public class LoginApi
extends java.lang.Object

Implements the wire protocol for logging into a Google account via the "deprecated" client login mechanism. Strictly speaking, login is not a part of the Finsky app, but with the Android framework, it is difficult to draw the line.

NOTE: use ClientFactory to avoid getting CAPTCHAs.

Constructor Summary

Constructors

Constructor and Description
LoginApi(ClientProvider cp, RequestContextProvider rcp)
LoginApi(org.apache.hc.client5.http.classic.HttpClient client, org.apache.hc.core5.http.Header... headers) Convenience constructor that wraps client in a DefaultClientProvider and headers in a DefaultRequestContextProvider.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	encryptPassword(java.lang.String uid, char[] pwd) Convert a plain password to an encrypted password
long	getGsfId()
java.util.Locale	getLocale()
int	getSdk()
AuthenticatedUser	requestSignIn(java.lang.String uid, java.lang.String epwd, Captcha captcha, boolean created) Sign into Play.
void	setGsfId(long gsfId)
void	setLocale(java.util.Locale locale)
void	setSdk(int sdk)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LoginApi

public LoginApi(org.apache.hc.client5.http.classic.HttpClient client,
                org.apache.hc.core5.http.Header... headers)

Convenience constructor that wraps client in a DefaultClientProvider and headers in a DefaultRequestContextProvider.

Parameters:

client - client for making requests.

headers - headers to add when making a request.

LoginApi

public LoginApi(ClientProvider cp,
                RequestContextProvider rcp)

Parameters:

cp -

rcp -

Method Detail

getLocale

public java.util.Locale getLocale()

setLocale

public void setLocale(java.util.Locale locale)

Parameters:

locale -

getSdk

public int getSdk()

setSdk

public void setSdk(int sdk)

getGsfId

public long getGsfId()

setGsfId

public void setGsfId(long gsfId)

requestSignIn

public AuthenticatedUser requestSignIn(java.lang.String uid,
                                       java.lang.String epwd,
                                       Captcha captcha,
                                       boolean created)
                                throws java.io.IOException,
                                       BadAuthenticationException,
                                       CaptchaException,
                                       ClientLoginDisabledException

Sign into Play.

Parameters:

uid - username (typically an email address=.

epwd - encrypted password.

captcha - solved captcha or null if no captcha required.

created - true if the account has just been created and the server should include user core data (full name, allowed services, email address) in the reply.

Returns:

A session, valid for Google Play.

Throws:

java.io.IOException

BadAuthenticationException

CaptchaException

ClientLoginDisabledException

encryptPassword

public static java.lang.String encryptPassword(java.lang.String uid,
                                               char[] pwd)

Convert a plain password to an encrypted password

Parameters:

uid - username (typically a gmail address)

pwd - plain text password (don't forget to zero it after this method returns).

Returns:

a password that can be passed to requestSignIn(String, String, Captcha, boolean).