casproxyticketvalidator.java

Acegi Security为Spring Framework提供一个兼容的安全认证服务(security services).

/* Copyright 2004 Acegi Technology Pty Limited
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.acegisecurity.providers.cas.ticketvalidator;

import edu.yale.its.tp.cas.client.ProxyTicketValidator;

import org.acegisecurity.AuthenticationException;
import org.acegisecurity.AuthenticationServiceException;
import org.acegisecurity.BadCredentialsException;
import org.acegisecurity.providers.cas.TicketResponse;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;


/**
 * Uses CAS' <code>ProxyTicketValidator</code> to validate a service ticket.
 *
 * @author Ben Alex
 * @version $Id: CasProxyTicketValidator.java,v 1.2 2005/11/17 00:56:29 benalex Exp $
 */
public class CasProxyTicketValidator extends AbstractTicketValidator {
    //~ Static fields/initializers =============================================

    private static final Log logger = LogFactory.getLog(CasProxyTicketValidator.class);

    //~ Instance fields ========================================================

    private String proxyCallbackUrl;

    //~ Methods ================================================================

    public void setProxyCallbackUrl(String proxyCallbackUrl) {
        this.proxyCallbackUrl = proxyCallbackUrl;
    }

    /**
     * Optional callback URL to obtain a proxy-granting ticket from CAS.
     * 
     * <P>
     * This callback URL belongs to the Acegi Security System for Spring
     * secured application. We suggest you use CAS'
     * <code>ProxyTicketReceptor</code> servlet to receive this callback and
     * manage the proxy-granting ticket list. The callback URL is usually
     * something like
     * <code>https://www.mycompany.com/application/casProxy/receptor</code>.
     * </p>
     * 
     * <P>
     * If left <code>null</code>, the <code>CasAuthenticationToken</code> will
     * not have a proxy granting ticket IOU and there will be no
     * proxy-granting ticket callback. Accordingly, the Acegi Securty System
     * for Spring secured application will be unable to obtain a proxy ticket
     * to call another CAS-secured service on behalf of the user. This is not
     * really an issue for most applications.
     * </p>
     *
     * @return the proxy callback URL, or <code>null</code> if not used
     */
    public String getProxyCallbackUrl() {
        return proxyCallbackUrl;
    }

    public TicketResponse confirmTicketValid(String serviceTicket)
        throws AuthenticationException {
        // Attempt to validate presented ticket using CAS' ProxyTicketValidator class
        ProxyTicketValidator pv = new ProxyTicketValidator();

        pv.setCasValidateUrl(super.getCasValidate());
        pv.setServiceTicket(serviceTicket);
        pv.setService(super.getServiceProperties().getService());

        if (super.getServiceProperties().isSendRenew()) {
            logger.warn(
                "The current CAS ProxyTicketValidator does not support the 'renew' property. The ticket cannot be validated as having been issued by a 'renew' authentication. It is expected this will be corrected in a future version of CAS' ProxyTicketValidator.");
        }

        if ((this.proxyCallbackUrl != null)
            && (!"".equals(this.proxyCallbackUrl))) {
            pv.setProxyCallbackUrl(proxyCallbackUrl);
        }

        return validateNow(pv);
    }

    /**
     * Perform the actual remote invocation. Protected to enable replacement
     * during tests.
     *
     * @param pv the populated <code>ProxyTicketValidator</code>
     *
     * @return the <code>TicketResponse</code>
     *
     * @throws AuthenticationServiceException
     *         if<code>ProxyTicketValidator</code> internally fails
     * @throws BadCredentialsException DOCUMENT ME!
     */
    protected TicketResponse validateNow(ProxyTicketValidator pv)
        throws AuthenticationServiceException, BadCredentialsException {
        try {
            pv.validate();
        } catch (Exception internalProxyTicketValidatorProblem) {
            throw new AuthenticationServiceException(internalProxyTicketValidatorProblem
                .getMessage());
        }

        if (!pv.isAuthenticationSuccesful()) {
            throw new BadCredentialsException(pv.getErrorCode() + ": "
                + pv.getErrorMessage());
        }

        return new TicketResponse(pv.getUser(), pv.getProxyList(),
            pv.getPgtIou());
    }
}