2014-11-12 15:15:38 +00:00
|
|
|
package eu.siacs.conversations.crypto.sasl;
|
|
|
|
|
|
|
|
import java.security.SecureRandom;
|
|
|
|
|
|
|
|
import eu.siacs.conversations.entities.Account;
|
|
|
|
import eu.siacs.conversations.xml.TagWriter;
|
|
|
|
|
|
|
|
public abstract class SaslMechanism {
|
|
|
|
|
2014-11-12 20:35:44 +00:00
|
|
|
final protected TagWriter tagWriter;
|
|
|
|
final protected Account account;
|
|
|
|
final protected SecureRandom rng;
|
2014-11-12 15:15:38 +00:00
|
|
|
|
2015-10-12 10:36:54 +00:00
|
|
|
protected enum State {
|
2014-11-15 13:48:40 +00:00
|
|
|
INITIAL,
|
|
|
|
AUTH_TEXT_SENT,
|
|
|
|
RESPONSE_SENT,
|
|
|
|
VALID_SERVER_RESPONSE,
|
|
|
|
}
|
|
|
|
|
|
|
|
public static class AuthenticationException extends Exception {
|
|
|
|
public AuthenticationException(final String message) {
|
|
|
|
super(message);
|
|
|
|
}
|
|
|
|
|
|
|
|
public AuthenticationException(final Exception inner) {
|
|
|
|
super(inner);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public static class InvalidStateException extends AuthenticationException {
|
|
|
|
public InvalidStateException(final String message) {
|
|
|
|
super(message);
|
|
|
|
}
|
|
|
|
|
|
|
|
public InvalidStateException(final State state) {
|
|
|
|
this("Invalid state: " + state.toString());
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-12 20:35:44 +00:00
|
|
|
public SaslMechanism(final TagWriter tagWriter, final Account account, final SecureRandom rng) {
|
|
|
|
this.tagWriter = tagWriter;
|
|
|
|
this.account = account;
|
|
|
|
this.rng = rng;
|
|
|
|
}
|
2014-11-12 15:15:38 +00:00
|
|
|
|
2014-11-15 14:42:40 +00:00
|
|
|
/**
|
|
|
|
* The priority is used to pin the authentication mechanism. If authentication fails, it MAY be retried with another
|
|
|
|
* mechanism of the same priority, but MUST NOT be tried with a mechanism of lower priority (to prevent downgrade
|
|
|
|
* attacks).
|
|
|
|
* @return An arbitrary int representing the priority
|
|
|
|
*/
|
|
|
|
public abstract int getPriority();
|
|
|
|
|
|
|
|
public abstract String getMechanism();
|
2014-11-12 20:35:44 +00:00
|
|
|
public String getClientFirstMessage() {
|
|
|
|
return "";
|
|
|
|
}
|
|
|
|
public String getResponse(final String challenge) throws AuthenticationException {
|
|
|
|
return "";
|
|
|
|
}
|
2014-11-12 15:15:38 +00:00
|
|
|
}
|