Jive Messenger 2.2.2 Javadoc

org.jivesoftware.messenger.auth
Interface AuthProvider

All Known Implementing Classes:
DefaultAuthProvider, LdapAuthProvider, NativeAuthProvider, POP3AuthProvider

public interface AuthProvider

Provider interface for authentication. Users that wish to integrate with their own authentication system must implement this class and then register the implementation with Jive Messenger in the jive-messenger.xml file. An entry in that file would look like the following:

   <provider>
     <auth>
       <className>com.foo.auth.CustomAuthProvider</className>
     </auth>
   </provider>

Author:
Matt Tucker

Method Summary
 void authenticate(String username, String password)
          Returns if the username and password are valid; otherwise this method throws an UnauthorizedException.
 void authenticate(String username, String token, String digest)
          Returns if the username, token, and digest are valid; otherwise this method throws an UnauthorizedException.
 boolean isDigestSupported()
          Returns true if this AuthProvider supports digest authentication according to JEP-0078.
 boolean isPlainSupported()
          Returns true if this AuthProvider supports authentication using plain-text passwords according to JEP--0078.
 

Method Detail

isPlainSupported

boolean isPlainSupported()
Returns true if this AuthProvider supports authentication using plain-text passwords according to JEP--0078. Plain text authentication is not secure and should generally only be used for a TLS/SSL connection.

Returns:
true if plain text password authentication is supported by this AuthProvider.

isDigestSupported

boolean isDigestSupported()
Returns true if this AuthProvider supports digest authentication according to JEP-0078.

Returns:
true if digest authentication is supported by this AuthProvider.

authenticate

void authenticate(String username,
                  String password)
                  throws UnauthorizedException
Returns if the username and password are valid; otherwise this method throws an UnauthorizedException.

If isPlainSupported() returns false, this method should throw an UnsupportedOperationException.

Parameters:
username - the username.
password - the passwordl
Throws:
UnauthorizedException - if the username and password do not match any existing user.

authenticate

void authenticate(String username,
                  String token,
                  String digest)
                  throws UnauthorizedException
Returns if the username, token, and digest are valid; otherwise this method throws an UnauthorizedException.

If isDigestSupported() returns false, this method should throw an UnsupportedOperationException.

Parameters:
username - the username.
token - the token that was used with plain-text password to generate the digest.
digest - the digest generated from plain-text password and unique token.
Throws:
UnauthorizedException - if the username and password do not match any existing user.

Jive Messenger 2.2.2 Javadoc

Copyright © 1999-2004 Jive Software.