com.arangodb.shaded.vertx.ext.auth.authentication.AuthenticationProvider Maven / Gradle / Ivy
/*
* Copyright 2014 Red Hat, Inc.
*
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* and Apache License v2.0 which accompanies this distribution.
*
* The Eclipse Public License is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* The Apache License v2.0 is available at
* http://www.opensource.org/licenses/apache2.0.php
*
* You may elect to redistribute this code under either of these licenses.
*/
package com.arangodb.shaded.vertx.ext.auth.authentication;
import com.arangodb.shaded.vertx.codegen.annotations.Fluent;
import com.arangodb.shaded.vertx.codegen.annotations.GenIgnore;
import com.arangodb.shaded.vertx.codegen.annotations.VertxGen;
import com.arangodb.shaded.vertx.core.AsyncResult;
import com.arangodb.shaded.vertx.core.Future;
import com.arangodb.shaded.vertx.core.Handler;
import com.arangodb.shaded.vertx.core.Promise;
import com.arangodb.shaded.vertx.core.json.JsonObject;
import com.arangodb.shaded.vertx.ext.auth.User;
/**
*
* User-facing interface for authenticating users.
*
* @author Tim Fox
*/
@VertxGen
public interface AuthenticationProvider {
/**
* Authenticate a user.
*
* The first argument is a JSON object containing information for authenticating the user. What this actually contains
* depends on the specific implementation. In the case of a simple username/password based
* authentication it is likely to contain a JSON object with the following structure:
*
* {
* "username": "tim",
* "password": "mypassword"
* }
*
* For other types of authentication it contain different information - for example a JWT token or OAuth bearer token.
*
* If the user is successfully authenticated a {@link User} object is passed to the handler in an {@link AsyncResult}.
* The user object can then be used for authorisation.
*
* @deprecated For type safety this method should be avoided and {@link #authenticate(Credentials, Handler)} should be
* used instead.
*
* @param credentials The credentials
* @param resultHandler The result handler
*/
@Deprecated
void authenticate(JsonObject credentials, Handler> resultHandler);
/**
* Authenticate a user.
*
* The first argument is a JSON object containing information for authenticating the user. What this actually contains
* depends on the specific implementation. In the case of a simple username/password based
* authentication it is likely to contain a JSON object with the following structure:
*
* {
* "username": "tim",
* "password": "mypassword"
* }
*
* For other types of authentication it contain different information - for example a JWT token or OAuth bearer token.
*
* If the user is successfully authenticated a {@link User} object is passed to the handler in an {@link AsyncResult}.
* The user object can then be used for authorisation.
*
* @deprecated For type safety this method should be avoided and {@link #authenticate(Credentials)} should be
* used instead.
*
* @see AuthenticationProvider#authenticate(JsonObject, Handler)
* @param credentials The credentials
* @return The result future
*/
@Deprecated
default Future authenticate(JsonObject credentials) {
Promise promise = Promise.promise();
authenticate(credentials, promise);
return promise.future();
}
/**
* Authenticate a user.
*
* The first argument is a Credentials object containing information for authenticating the user.
* What this actually contains depends on the specific implementation.
*
* If the user is successfully authenticated a {@link User} object is passed to the handler in an {@link AsyncResult}.
* The user object can then be used for authorisation.
*
* @param credentials The credentials
* @param resultHandler The result handler
*/
@GenIgnore(GenIgnore.PERMITTED_TYPE)
default void authenticate(Credentials credentials, Handler> resultHandler) {
authenticate(credentials)
.onComplete(resultHandler);
}
/**
* Authenticate a user.
*
* The first argument is a Credentials object containing information for authenticating the user.
* What this actually contains depends on the specific implementation.
*
* @see AuthenticationProvider#authenticate(Credentials, Handler)
* @param credentials The credentials
* @return The result future
*/
@GenIgnore(GenIgnore.PERMITTED_TYPE)
default Future authenticate(Credentials credentials) {
return authenticate(credentials.toJson());
}
}