2012年3月13日 星期二

JA-SIG CAS for multi-tenant LDAP

說明Jasig CAS使用多個BaseDN或是不同的organizationalUnit,CAS Server的相關設定請參考其他文章,這裡只著重在Jasig CAS跟LDAP的配置。

準備執行環境

以下為測試時會用到的環境,但針對測試步驟不會一一說明
  • JDK (Java Development Kit) version 1.6+
  • OpenDS-2.2.1
  • Apache Tomcat 6+
  • JA-SIG CAS 3.4.2.1+



修改 CAS deployerConfigContext.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--
    | deployerConfigContext.xml centralizes into one file some of the declarative configuration that
    | all CAS deployers will need to modify.
    |
    | This file declares some of the Spring-managed JavaBeans that make up a CAS deployment.  
    | The beans declared in this file are instantiated at context initialization time by the Spring 
    | ContextLoaderListener declared in web.xml.  It finds this file because this
    | file is among those declared in the context parameter "contextConfigLocation".
    |
    | By far the most common change you will need to make in this file is to change the last bean
    | declaration to replace the default SimpleTestUsernamePasswordAuthenticationHandler with
    | one implementing your approach for authenticating usernames and passwords.
    +-->
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:p="http://www.springframework.org/schema/p"
       xmlns:sec="http://www.springframework.org/schema/security"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
       http://www.springframework.org/schema/security http://www.springframework.org/schema/security/spring-security-3.0.xsd">
    <!--
        | This bean declares our AuthenticationManager.  The CentralAuthenticationService service bean
        | declared in applicationContext.xml picks up this AuthenticationManager by reference to its id, 
        | "authenticationManager".  Most deployers will be able to use the default AuthenticationManager
        | implementation and so do not need to change the class of this bean.  We include the whole
        | AuthenticationManager here in the userConfigContext.xml so that you can see the things you will
        | need to change in context.
        +-->
    <bean id="authenticationManager"
        class="org.jasig.cas.authentication.AuthenticationManagerImpl">
        <!--
            | This is the List of CredentialToPrincipalResolvers that identify what Principal is trying to authenticate.
            | The AuthenticationManagerImpl considers them in order, finding a CredentialToPrincipalResolver which 
            | supports the presented credentials.
            |
            | AuthenticationManagerImpl uses these resolvers for two purposes.  First, it uses them to identify the Principal
            | attempting to authenticate to CAS /login .  In the default configuration, it is the DefaultCredentialsToPrincipalResolver
            | that fills this role.  If you are using some other kind of credentials than UsernamePasswordCredentials, you will need to replace
            | DefaultCredentialsToPrincipalResolver with a CredentialsToPrincipalResolver that supports the credentials you are
            | using.
            |
            | Second, AuthenticationManagerImpl uses these resolvers to identify a service requesting a proxy granting ticket. 
            | In the default configuration, it is the HttpBasedServiceCredentialsToPrincipalResolver that serves this purpose. 
            | You will need to change this list if you are identifying services by something more or other than their callback URL.
            +-->
        <property name="credentialsToPrincipalResolvers">
            <list>
             <!-- LDAP Attribute -->
             <bean class="org.jasig.cas.authentication.principal.CredentialsToLDAPAttributePrincipalResolver">
                 <property name="credentialsToPrincipalResolver">
                <!--
                    | UsernamePasswordCredentialsToPrincipalResolver supports the UsernamePasswordCredentials that we use for /login 
                    | by default and produces SimplePrincipal instances conveying the username from the credentials.
                    | 
                    | If you've changed your LoginFormAction to use credentials other than UsernamePasswordCredentials then you will also
                    | need to change this bean declaration (or add additional declarations) to declare a CredentialsToPrincipalResolver that supports the
                    | Credentials you are using.
                    +-->
                            <bean    class="org.jasig.cas.authentication.principal.UsernamePasswordCredentialsToPrincipalResolver" />
                  </property>
                  <property name="attributeRepository" ref="attributeRepository" />
                  <property name="filter" value="(&amp;(cn=%u)(!(sn=12)))" />

                  <!-- The attribute used to define the new Principal ID -->
                  <property name="principalAttributeName" value="cn" />

                  <property name="searchBase" value="ou=People,dc=example1,dc=com" />
                  <property name="contextSource" ref="myContextSource" />
                </bean>

                <bean class="org.jasig.cas.authentication.principal.CredentialsToLDAPAttributePrincipalResolver">
                    <property name="credentialsToPrincipalResolver">
                                  <bean class="org.jasig.cas.authentication.principal.UsernamePasswordCredentialsToPrincipalResolver" />
                    </property>
                    <property name="attributeRepository" ref="attributeRepository" />
                    <property name="filter" value="(&amp;(cn=%u)(!(sn=12)))" />

                    <!-- The attribute used to define the new Principal ID -->
                    <property name="principalAttributeName" value="cn" />

                    <property name="searchBase" value="ou=People,dc=example2,dc=com" />
                    <property name="contextSource" ref="myContextSource" />
                </bean>

                <!--
                    | HttpBasedServiceCredentialsToPrincipalResolver supports HttpBasedCredentials.  It supports the CAS 2.0 approach of
                    | authenticating services by SSL callback, extracting the callback URL from the Credentials and representing it as a
                    | SimpleService identified by that callback URL.
                    |
                    | If you are representing services by something more or other than an HTTPS URL whereat they are able to
                    | receive a proxy callback, you will need to change this bean declaration (or add additional declarations).
                    +-->
                <bean
                    class="org.jasig.cas.authentication.principal.HttpBasedServiceCredentialsToPrincipalResolver" />
            </list>
        </property>

        <!--
            | Whereas CredentialsToPrincipalResolvers identify who it is some Credentials might authenticate, 
            | AuthenticationHandlers actually authenticate credentials.  Here we declare the AuthenticationHandlers that
            | authenticate the Principals that the CredentialsToPrincipalResolvers identified.  CAS will try these handlers in turn
            | until it finds one that both supports the Credentials presented and succeeds in authenticating.
            +-->
        <property name="authenticationHandlers">
            <list>
                <!--
                    | This is the authentication handler that authenticates services by means of callback via SSL, thereby validating
                    | a server side SSL certificate.
                    +-->
                <bean class="org.jasig.cas.authentication.handler.support.HttpBasedServiceCredentialsAuthenticationHandler"
                    p:httpClient-ref="httpClient" />
                <!--
                    | This is the authentication handler declaration that every CAS deployer will need to change before deploying CAS 
                    | into production.  The default SimpleTestUsernamePasswordAuthenticationHandler authenticates UsernamePasswordCredentials
                    | where the username equals the password.  You will need to replace this with an AuthenticationHandler that implements your
                    | local authentication strategy.  You might accomplish this by coding a new such handler and declaring
                    | edu.someschool.its.cas.MySpecialHandler here, or you might use one of the handlers provided in the adaptors modules.
                    
                <bean
                    class="org.jasig.cas.authentication.handler.support.SimpleTestUsernamePasswordAuthenticationHandler" />
                    -->
                <!-- LDAP Authentication Handler -->
                <bean class="org.jasig.cas.adaptors.ldap.BindLdapAuthenticationHandler" >
                    <property name="filter" value="(&amp;(cn=%u)(!(sn=12)))" />
                    <property name="searchBase" value="dc=example1,dc=com" />
                    <property name="contextSource" ref="myContextSource" />
                </bean>
                <bean class="org.jasig.cas.adaptors.ldap.BindLdapAuthenticationHandler" >
                    <property name="filter" value="(&amp;(cn=%u)(!(sn=12)))" />
                    <property name="searchBase" value="dc=example2,dc=com" />
                    <property name="contextSource" ref="myContextSource" />
                </bean>
            </list>
        </property>
    </bean>


    <!--
    This bean defines the security roles for the Services Management application.  Simple deployments can use the in-memory version.
    More robust deployments will want to use another option, such as the Jdbc version.
    
    The name of this should remain "userDetailsService" in order for Spring Security to find it.
     -->
    <!-- <sec:user name="@@THIS SHOULD BE REPLACED@@" password="notused" authorities="ROLE_ADMIN" />
    <sec:user name="user" password="notused" authorities="ROLE_USER" />-->

    <sec:user-service id="userDetailsService">
        <sec:user name="@@THIS SHOULD BE REPLACED@@" password="notused" authorities="ROLE_ADMIN" />
    </sec:user-service>
    
    <!-- LDAP ContextSource -->
    <!-- ContextSource -->
    <bean id="myContextSource" class="org.springframework.ldap.core.support.LdapContextSource">
        <property name="pooled" value="false"/>
        <property name="urls">
            <list>
                <value>ldap://localhost:389/</value>
            </list>
        </property>
        <property name="userDn" value="cn=Directory Manager"/>
        <property name="password" value="opends123"/>
        <property name="baseEnvironmentProperties">
            <map>
                <entry>
                    <key>
                        <value>java.naming.security.authentication</value>
                    </key>
                    <value>simple</value>
                </entry>
                <entry>
                    <key>
                        <value>com.sun.jndi.ldap.connect.timeout</value>
                    </key>
                    <value>2000</value>
                </entry>
                <entry>
                    <key>
                        <value>com.sun.jndi.ldap.read.timeout</value>
                    </key>
                    <value>2000</value>
                </entry>
            </map>
    </property>
    </bean>
    
    <!-- 
    Bean that defines the attributes that a service may return.  This example uses the Stub/Mock version.  A real implementation
    may go against a database or LDAP server.  The id should remain "attributeRepository" though.
     
    <bean id="attributeRepository"
        class="org.jasig.services.persondir.support.StubPersonAttributeDao">
        <property name="backingMap">
            <map>
                <entry key="uid" value="uid" />
                <entry key="eduPersonAffiliation" value="eduPersonAffiliation" /> 
                <entry key="groupMembership" value="groupMembership" />
            </map>
        </property>
    </bean>
    -->

        <bean id="attributeRepository" class="org.jasig.services.persondir.support.MergingPersonAttributeDaoImpl"> 
            <property name="personAttributeDaos">
                <list>
                    <ref bean="attributeRepository0" />
                    <ref bean="attributeRepository1" />
                </list>
            </property>
        </bean>

        <bean id="attributeRepository0" class="org.jasig.services.persondir.support.ldap.LdapPersonAttributeDao">
            <property name="baseDN" value="ou=People,dc=example1,dc=com" />
            <property name="contextSource" ref="myContextSource" />
            <!-- parent class attribute -->
            <property name="requireAllQueryAttributes" value="true" />
            <!-- parent class attributes, javadoc says optional, but it's required??!!  -->
            <property name="queryAttributeMapping">
                <map>
                    <entry key="username" value="cn" /> 
                </map>
            </property>
              <property name="resultAttributeMapping">
                <map>
                    <entry key="uid" value="uid" /> 
                    <entry key="sn" value="sn" />
                <entry key="cn" value="username" />
                </map>
              </property>
          </bean>

        <bean id="attributeRepository1" class="org.jasig.services.persondir.support.ldap.LdapPersonAttributeDao">
            <property name="baseDN" value="ou=People,dc=example2,dc=com" />
            <property name="contextSource" ref="myContextSource" />
            <!-- parent class attribute -->
            <property name="requireAllQueryAttributes" value="true" />
            <!-- parent class attributes, javadoc says optional, but it's required??!!  -->
            <property name="queryAttributeMapping">
                <map>
                    <entry key="username" value="cn" /> 
                </map>
            </property>
              <property name="resultAttributeMapping">
                <map>
                    <entry key="uid" value="uid" /> 
                    <entry key="sn" value="sn" />
                <entry key="cn" value="username" />
                </map>
              </property>
          </bean>

    <!-- 
    Sample, in-memory data store for the ServiceRegistry. A real implementation
    would probably want to replace this with the JPA-backed ServiceRegistry DAO
    The name of this bean should remain "serviceRegistryDao".
     -->
    <bean
        id="serviceRegistryDao"
        class="org.jasig.cas.services.InMemoryServiceRegistryDaoImpl">
            <property name="registeredServices">
                <list>
                    <bean class="org.jasig.cas.services.RegisteredServiceImpl">
                        <property name="id" value="0" />
                        <property name="name" value="HTTP" />
                        <property name="description" value="Only Allows HTTP Urls" />
                        <property name="serviceId" value="http://**" />
                    </bean>

                    <bean class="org.jasig.cas.services.RegisteredServiceImpl">
                        <property name="id" value="1" />
                        <property name="name" value="HTTPS" />
                        <property name="description" value="Only Allows HTTPS Urls" />
                        <property name="serviceId" value="https://**" />
                    </bean>

                    <bean class="org.jasig.cas.services.RegisteredServiceImpl">
                        <property name="id" value="2" />
                        <property name="name" value="IMAPS" />
                        <property name="description" value="Only Allows HTTPS Urls" />
                        <property name="serviceId" value="imaps://**" />
                    </bean>

                    <bean class="org.jasig.cas.services.RegisteredServiceImpl">
                        <property name="id" value="3" />
                        <property name="name" value="IMAP" />
                        <property name="description" value="Only Allows IMAP Urls" />
                        <property name="serviceId" value="imap://**" />
                    </bean>
                </list>
            </property>
        </bean>
</beans>
  1. 修改 cas/WEB-INF/deployerConfigContext.xml

  2. CredentialToPrincipalResolvers設定第二個baseDN:dc=example2,dc=comline-71~83

  3. LDAP Authentication Handler一樣設定第二個baseDN:dc=example2,dc=comline-128~132

  4. attributeRepository要設定多組須使用MergingPersonAttributeDaoImpl  line-202~209,第一組Repository:line-211~229,第二組Repository:line-231~249

  5. 如使用同一個baseDN不同的organizationalUnit,將CredentialToPrincipalResolvers-searchBaseattributeRepository-baseDN修改成對應的organizationalUnit,LDAP Authentication Handler只須設定一組

測試結果

  1. 不同的baseDN CAS允許存在相同的帳號,CAS可以讀取這一組帳號不同baseDN的Attribute,CAS會回傳二組Attribute。
  2. 同一個baseDN不同的organizationalUnit則不允許存在相同的帳號,會直接login fail。
仔細想想這是合理,CAS應該是配合LDAP的Entries,baseDN如同一家公司,organizationalUnit則是部門,而企業允許多個子公司,當然企業或公司的帳號政策不儘相同LDAP只是提供這樣的Entries


相關設定可參考:
Active Directory with users in different OU's
[cas-user] Aggregating user attributes with group membership
CAS SSO for multi-tenant LDAP?

沒有留言:

張貼留言