gerrit.opnfv Code Review - moon.git/blob

   1 /*
   2  * Copyright (c) 2016 Brocade Communications Systems, Inc. and others.  All rights reserved.
   3  *
   4  * This program and the accompanying materials are made available under the
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html
   7  */
   8
   9 package org.opendaylight.aaa.shiro.realm;
  10
  11 import org.apache.shiro.authc.AuthenticationException;
  12 import org.apache.shiro.authc.AuthenticationInfo;
  13 import org.apache.shiro.authc.AuthenticationToken;
  14 import org.apache.shiro.realm.ldap.JndiLdapRealm;
  15 import org.opendaylight.aaa.shiro.accounting.Accounter;
  16 import org.slf4j.Logger;
  17 import org.slf4j.LoggerFactory;
  18
  19 /**
  20  * Wrapper class for <code>org.apache.shiro.realm.ldap.JndiLdapRealm</code>.
  21  * This implementation disables Authorization so any LDAP user is able to access
  22  * server resources. This is particularly useful for quickly prototyping ODL
  23  * without worrying about resolving LDAP attributes (groups) to OpenDaylight
  24  * roles.
  25  *
  26  * The motivation for subclassing Shiro's implementation is two-fold: 1) Enhance
  27  * the default logging of Shiro. This allows us to more easily log incoming
  28  * connections, providing some security auditing. 2) Provide a common package in
  29  * the classpath for ODL supported Realm implementations (i.e.,
  30  * <code>org.opendaylight.aaa.shiro.realm</code>), which consolidates the number
  31  * of <code>Import-Package</code> statements consumers need to enumerate. For
  32  * example, the netconf project only needs to import
  33  * <code>org.opendaylight.aaa.shiro.realm</code>, and does not need to worry
  34  * about importing Shiro packages.
  35  *
  36  * @author Ryan Goulding (ryandgoulding@gmail.com)
  37  *
  38  */
  39 public class ODLJndiLdapRealmAuthNOnly extends JndiLdapRealm {
  40
  41     private static final Logger LOG = LoggerFactory.getLogger(ODLJndiLdapRealmAuthNOnly.class);
  42
  43     private static final String LDAP_CONNECTION_MESSAGE = "AAA LDAP connection from ";
  44
  45     /*
  46      * Adds debugging information surrounding creation of ODLJndiLdapRealm
  47      */
  48     public ODLJndiLdapRealmAuthNOnly() {
  49         super();
  50         LOG.debug("Creating ODLJndiLdapRealmAuthNOnly");
  51     }
  52
  53     /*
  54      * (non-Javadoc) Overridden to expose important audit trail information for
  55      * accounting.
  56      *
  57      * @see
  58      * org.apache.shiro.realm.ldap.JndiLdapRealm#doGetAuthenticationInfo(org
  59      * .apache.shiro.authc.AuthenticationToken)
  60      */
  61     @Override
  62     protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token)
  63             throws AuthenticationException {
  64
  65         try {
  66             final String username = getUsername(token);
  67             logIncomingConnection(username);
  68             return super.doGetAuthenticationInfo(token);
  69         } catch (ClassCastException e) {
  70             LOG.info("Couldn't service the LDAP connection", e);
  71         }
  72         return null;
  73     }
  74
  75     /**
  76      * Logs an incoming LDAP connection
  77      *
  78      * @param username
  79      *            the requesting user
  80      */
  81     protected void logIncomingConnection(final String username) {
  82         final String message = LDAP_CONNECTION_MESSAGE + username;
  83         LOG.info(message);
  84         Accounter.output(message);
  85     }
  86
  87     /**
  88      * Extracts the username from <code>token</code>
  89      *
  90      * @param token Which possibly contains a username
  91      * @return the username if it can be extracted
  92      * @throws ClassCastException
  93      *             The incoming token is not username/password (i.e., X.509
  94      *             certificate)
  95      */
  96     public static String getUsername(AuthenticationToken token) throws ClassCastException {
  97         if (null == token) {
  98             return null;
  99         }
 100         return (String) token.getPrincipal();
 101     }
 102 }