org.artifactory.rest.common.ArtifactoryRestExceptionMapper.java Source code

Introduction

Here is the source code for org.artifactory.rest.common.ArtifactoryRestExceptionMapper.java

Source

/*
 * Artifactory is a binaries repository manager.
 * Copyright (C) 2012 JFrog Ltd.
 *
 * Artifactory is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Artifactory is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with Artifactory.  If not, see <http://www.gnu.org/licenses/>.
 */

package org.artifactory.rest.common;

import org.apache.commons.httpclient.HttpStatus;
import org.artifactory.api.config.CentralConfigService;
import org.artifactory.api.security.AuthorizationService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.web.authentication.www.BasicAuthenticationEntryPoint;
import org.springframework.stereotype.Component;

import javax.ws.rs.WebApplicationException;
import javax.ws.rs.core.MultivaluedMap;
import javax.ws.rs.core.Response;
import javax.ws.rs.ext.ExceptionMapper;
import javax.ws.rs.ext.Provider;

/**
 * Intercepts and maps different exceptions thrown by the REST API.
 * <p/>
 * <strong>NOTE!</strong> Candidates exceptions <b>MUST NOT</b> have an entity, otherwise they will not get intercepted.
 *
 * @author Shay Yaakov
 */
@Component
@Provider
public class ArtifactoryRestExceptionMapper implements ExceptionMapper<WebApplicationException> {

    @Autowired
    private CentralConfigService centralConfig;

    @Autowired
    AuthorizationService authorizationService;

    @Autowired
    private BasicAuthenticationEntryPoint authenticationEntryPoint;

    @Override
    public Response toResponse(WebApplicationException exception) {
        Response jerseyResponse = exception.getResponse();
        int status = jerseyResponse.getStatus();
        switch (status) {
        case HttpStatus.SC_FORBIDDEN:
            return interceptForbiddenStatus(jerseyResponse);

        case HttpStatus.SC_UNAUTHORIZED:
            return interceptUnauthorizedStatus(jerseyResponse);
        }

        return jerseyResponse;
    }

    /**
     * Handle forbidden response (403) by verifying is anonymous access is globally allowed, if so we need to send
     * an unauthorized (401) response with basic authentication challenge.
     * If the global hide unauthorized resources is set, the result will be not found (404).
     *
     * @param jerseyResponse The original response, will be returned in there is no need for a conversion.
     */
    private Response interceptForbiddenStatus(Response jerseyResponse) {
        if (authorizationService.isAnonAccessEnabled() && authorizationService.isAnonymous()) {
            if (centralConfig.getDescriptor().getSecurity().isHideUnauthorizedResources()) {
                return Response.status(HttpStatus.SC_NOT_FOUND).build();
            }

            return createUnauthorizedResponseWithChallenge(jerseyResponse);
        }

        return jerseyResponse;
    }

    /**
     * Handle unauthorized response (401) by adding it with a basic authentication challenge in case it's missing
     * (WWW-Authenticate header with Artifactory realm).
     *
     * @param jerseyResponse
     * @return
     */
    private Response interceptUnauthorizedStatus(Response jerseyResponse) {
        MultivaluedMap<String, Object> headers = jerseyResponse.getMetadata();
        if (headers != null && headers.containsKey("WWW-Authenticate")) {
            return jerseyResponse;
        }
        return createUnauthorizedResponseWithChallenge(jerseyResponse);
    }

    private Response createUnauthorizedResponseWithChallenge(Response jerseyResponse) {
        return Response.status(HttpStatus.SC_UNAUTHORIZED).entity(jerseyResponse.getEntity())
                .header("WWW-Authenticate", "Basic realm=\"" + authenticationEntryPoint.getRealmName() + "\"")
                .build();
    }
}