com.google.gerrit.server.auth.oauth

Class OAuthRealm

java.lang.Object

com.google.gerrit.server.account.AbstractRealm

com.google.gerrit.server.auth.oauth.OAuthRealm

All Implemented Interfaces:

Realm

public class OAuthRealm
extends AbstractRealm

Method Summary

Modifier and Type	Method and Description
boolean	accountBelongsToRealm(java.util.Collection<ExternalId> externalIds)
boolean	allowsEdit(AccountFieldName field) Can the end-user modify this field of their own account?
AuthRequest	authenticate(AuthRequest who) Authenticates with the OAuthLoginProvider specified in the authentication request.
Account.Id	lookup(java.lang.String accountName) Locate an account whose local username is the given account name.
void	onCreateAccount(AuthRequest who, Account account)

Methods inherited from class com.google.gerrit.server.account.AbstractRealm

getEditableFields, getEmailAddresses, hasEmailAddress

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.gerrit.server.account.Realm

isActive

Method Detail

allowsEdit

public boolean allowsEdit(AccountFieldName field)

Description copied from interface: Realm

Can the end-user modify this field of their own account?

authenticate

public AuthRequest authenticate(AuthRequest who)
                         throws AccountException

Authenticates with the OAuthLoginProvider specified in the authentication request.

AccountManager calls this method without password if authenticity of the user has already been established. In that case we can skip the authentication request to the OAuthLoginService.

Parameters:

who - the authentication request.

Returns:

the authentication request with resolved email address and display name in case the authenticity of the user could be established; otherwise who is returned unchanged.

Throws:

AccountException - if the authentication request with the OAuth2 server failed or no OAuthLoginProvider was available to handle the request.

onCreateAccount

public void onCreateAccount(AuthRequest who,
                            Account account)

lookup

public Account.Id lookup(java.lang.String accountName)

Description copied from interface: Realm

Locate an account whose local username is the given account name.

Generally this only works for local realms, such as one backed by an LDAP directory, or where there is an EmailExpander configured that knows how to convert the accountName into an email address, and then locate the user by that email address.

accountBelongsToRealm

public boolean accountBelongsToRealm(java.util.Collection<ExternalId> externalIds)

Returns:

true if the account is backed by the realm, false otherwise.