org.tmatesoft.svn.core.auth
public interface ISVNAuthenticationProvider
setAuthenticationProvider()
.
When a repository server pulls user's credentials, an SVNRepository driver
asks the registered ISVNAuthenticationManager for credentials. The auth manager in its turn
will ask the registered auth provider for credentials.
ISVNAuthenticationProvider may be implemented to keep a list of credentials, for example, there is such a default SVNKit implementation (that comes along with a default implementation of ISVNAuthenticationManager - org.tmatesoft.svn.core.internal.wc.DefaultSVNAuthenticationManager), that saves credentials in and retrieves them from the in-memory cache only during runtime (not on the disk); or the default one that uses the auth area cache (read the Subversion book chapter).
Version: 1.1.1
See Also: ISVNAuthenticationManager SVNRepository
Field Summary | |
---|---|
int | ACCEPTED
Denotes that a user credential is accepted by a server and will be
cached on the disk. |
int | ACCEPTED_TEMPORARY
Denotes that a user credential is accepted by a server and will be
cached only during runtime, not on the disk. |
int | REJECTED
Denotes that a user credential is rejected by a server. |
Method Summary | |
---|---|
int | acceptServerAuthentication(SVNURL url, String realm, Object certificate, boolean resultMayBeStored)
Checks a server authentication certificate and whether accepts it
(if the client trusts it) or not.
|
SVNAuthentication | requestClientAuthentication(String kind, SVNURL url, String realm, SVNErrorMessage errorMessage, SVNAuthentication previousAuth, boolean authMayBeStored)
Returns a next user credential of the specified kind for the given
authentication realm.
|
This method is used by an SSL manager (see ISVNSSLManager).
Parameters: url a repository location that is accessed realm a repository authentication realm (host, port, realm string) certificate a server certificate object resultMayBeStored if true then the server certificate can be cached, otherwise not
Returns: the result of the certificate check (REJECTED, ACCEPTED_TEMPORARY, or ACCEPTED)
If this provider has got more than one credentials (say, a list of credentials),
to get the first one of them previousAuth
is set to
null.
Parameters: kind a credential kind (for example, like those defined in ISVNAuthenticationManager) url a repository location that is to be accessed realm a repository authentication realm (host, port, realm string) errorMessage the recent authentication failure error message previousAuth the credential that was previously retrieved (to tell if it's not accepted) authMayBeStored if true then the returned credential can be cached, otherwise it won't be cached anyway
Returns: a next user credential