1 /*
2 * Licensed to the Apache Software Foundation (ASF) under one
3 * or more contributor license agreements. See the NOTICE file
4 * distributed with this work for additional information
5 * regarding copyright ownership. The ASF licenses this file
6 * to you under the Apache License, Version 2.0 (the
7 * "License"); you may not use this file except in compliance
8 * with the License. You may obtain a copy of the License at
9 *
10 * http://www.apache.org/licenses/LICENSE-2.0
11 *
12 * Unless required by applicable law or agreed to in writing,
13 * software distributed under the License is distributed on an
14 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 * KIND, either express or implied. See the License for the
16 * specific language governing permissions and limitations
17 * under the License.
18 */
19 package org.apache.shiro.authc.pam;
20
21 import org.slf4j.Logger;
22 import org.slf4j.LoggerFactory;
23
24 import org.apache.shiro.authc.AuthenticationException;
25 import org.apache.shiro.authc.AuthenticationInfo;
26 import org.apache.shiro.authc.AuthenticationToken;
27 import org.apache.shiro.authc.UnknownAccountException;
28 import org.apache.shiro.realm.Realm;
29
30
31 /**
32 * <tt>AuthenticationStrategy</tt> implementation that requires <em>all</em> configured realms to
33 * <b>successfully</b> process the submitted <tt>AuthenticationToken</tt> during the log-in attempt.
34 * <p/>
35 * <p>If one or more realms do not support the submitted token, or one or more are unable to acquire
36 * <tt>AuthenticationInfo</tt> for the token, this implementation will immediately fail the log-in attempt for the
37 * associated subject (user).
38 *
39 * @since 0.2
40 */
41 public class AllSuccessfulStrategy extends AbstractAuthenticationStrategy {
42
43 /**
44 * Private class log instance.
45 */
46 private static final Logger LOGGER = LoggerFactory.getLogger(AllSuccessfulStrategy.class);
47
48 /**
49 * Because all realms in this strategy must complete successfully, this implementation ensures that the given
50 * <code>Realm</code> {@link org.apache.shiro.realm.Realm#supports(org.apache.shiro.authc.AuthenticationToken) supports}
51 * the given
52 * <code>token</code> argument. If it does not, this method throws an
53 * {@link UnsupportedTokenException UnsupportedTokenException} to end the authentication
54 * process immediately. If the realm does support the token, the <code>info</code> argument is returned immediately.
55 */
56 public AuthenticationInfo beforeAttempt(Realm realm, AuthenticationToken token,
57 AuthenticationInfo info) throws AuthenticationException {
58 if (!realm.supports(token)) {
59 String msg = "Realm [" + realm + "] of type [" + realm.getClass().getName() + "] does not support "
60 + " the submitted AuthenticationToken [" + token + "]. The [" + getClass().getName()
61 + "] implementation requires all configured realm(s) to support and be able to process the submitted "
62 + "AuthenticationToken.";
63 throw new UnsupportedTokenException(msg);
64 }
65
66 return info;
67 }
68
69 /**
70 * Merges the specified <code>info</code> into the <code>aggregate</code> argument and returns it (just as the
71 * parent implementation does), but additionally ensures the following:
72 * <ol>
73 * <li>if the <code>Throwable</code> argument is not <code>null</code>, re-throws it to immediately cancel the
74 * authentication process, since this strategy requires all realms to authenticate successfully.</li>
75 * <li>neither the <code>info</code> or <code>aggregate</code> argument is <code>null</code> to ensure that each
76 * realm did in fact authenticate successfully</li>
77 * </ol>
78 */
79 public AuthenticationInfo afterAttempt(Realm realm, AuthenticationToken token,
80 AuthenticationInfo info, AuthenticationInfo aggregate, Throwable t)
81 throws AuthenticationException {
82 if (t != null) {
83 if (t instanceof AuthenticationException) {
84 //propagate:
85 throw ((AuthenticationException) t);
86 } else {
87 String msg = "Unable to acquire account data from realm [" + realm + "]. The ["
88 + getClass().getName() + " implementation requires all configured realm(s) to operate successfully "
89 + "for a successful authentication.";
90 throw new AuthenticationException(msg, t);
91 }
92 }
93 if (info == null) {
94 String msg = "Realm [" + realm + "] could not find any associated account data for the submitted "
95 + "AuthenticationToken [" + token + "]. The [" + getClass().getName() + "] implementation requires "
96 + "all configured realm(s) to acquire valid account data for a submitted token during the "
97 + "log-in process.";
98 throw new UnknownAccountException(msg);
99 }
100
101 LOGGER.debug("Account successfully authenticated using realm [{}]", realm);
102
103 // If non-null account is returned, then the realm was able to authenticate the
104 // user - so merge the account with any accumulated before:
105 merge(info, aggregate);
106
107 return aggregate;
108 }
109 }