/*
* The contents of this file are subject to the terms of the Common Development and
* Distribution License (the License). You may not use this file except in compliance with the
* License.
*
* You can obtain a copy of the License at legal/CDDLv1.0.txt. See the License for the
* specific language governing permission and limitations under the License.
*
* When distributing Covered Software, include this CDDL Header Notice in each file and include
* the License file at legal/CDDLv1.0.txt. If applicable, add the following below the CDDL
* Header, with the fields enclosed by brackets [] replaced by your own identifying
* information: "Portions copyright [year] [name of copyright owner]".
*
* Copyright 2014 ForgeRock AS.
*/
package org.forgerock.oauth2.core;
import org.forgerock.oauth2.core.exceptions.BadRequestException;
import org.forgerock.oauth2.core.exceptions.InvalidClientException;
import org.forgerock.oauth2.core.exceptions.InvalidRequestException;
import org.forgerock.oauth2.core.exceptions.InvalidScopeException;
import org.forgerock.oauth2.core.exceptions.NotFoundException;
import org.forgerock.oauth2.core.exceptions.RedirectUriMismatchException;
import org.forgerock.oauth2.core.exceptions.ServerException;
import org.forgerock.oauth2.core.exceptions.UnsupportedResponseTypeException;
/**
* Request validator for the OAuth2 authorize endpoint.
* <br/>
* Request validators validate that the specified OAuth2 request is valid be checking that the request contains all of
* the required parameters.
*
* @since 12.0.0
*/
public interface AuthorizeRequestValidator {
/**
* Validates that the OAuth2 request contains the valid parameters for the OAuth2 authorize endpoint.
*
* @param request The OAuth2Request for the client requesting authorization. Must not be {@code null}.
* @throws InvalidClientException If either the request does not contain the client's id or the client fails to be
* authenticated.
* @throws InvalidRequestException If the request is missing any required parameters or is otherwise malformed.
* @throws RedirectUriMismatchException If the redirect uri on the request does not match the redirect uri
* registered for the client.
* @throws UnsupportedResponseTypeException If the requested response type is not supported by either the client
* or the OAuth2 provider.
* @throws ServerException If any internal server error occurs.
* @throws BadRequestException If the request is malformed.
* @throws IllegalArgumentException If the request is missing any required parameters.
* @throws InvalidScopeException If the requested scope is invalid, unknown, or malformed.
* @throws NotFoundException If the realm does not have an OAuth 2.0 provider service.
*/
void validateRequest(OAuth2Request request) throws InvalidClientException, InvalidRequestException,
RedirectUriMismatchException, UnsupportedResponseTypeException, ServerException, BadRequestException,
InvalidScopeException, NotFoundException;
}