31

如果我想为一个客户端保护 REST 服务器,那么 spring-security OAuth2 的最小设置是什么?我不想使用任何不必要的设置或实现任何不必要的 bean。也许已经有一个用于 spring-security + OAuth2 的“简单”教程/示例?(虽然我试图避免对此抱有太大希望)

我当前的工作设置(使用 sparklr 上下文中的 copy+past+wtf)感觉太多了:

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:oauth="http://www.springframework.org/schema/security/oauth2"
       xmlns:sec="http://www.springframework.org/schema/security"
       xsi:schemaLocation="http://www.springframework.org/schema/security/oauth2
                           http://www.springframework.org/schema/security/spring-security-oauth2-1.0.xsd
                           http://www.springframework.org/schema/security
                           http://www.springframework.org/schema/security/spring-security-3.1.xsd
                           http://www.springframework.org/schema/beans
                           http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">

    <oauth:authorization-server client-details-service-ref="clientDetails" token-services-ref="tokenServices">
        <oauth:client-credentials />
    </oauth:authorization-server>

    <sec:authentication-manager alias="clientAuthenticationManager">
        <sec:authentication-provider user-service-ref="clientDetailsUserService" />
    </sec:authentication-manager>

    <http pattern="/oauth/token" create-session="stateless"
            authentication-manager-ref="clientAuthenticationManager"
            xmlns="http://www.springframework.org/schema/security">
        <intercept-url pattern="/oauth/token" access="IS_AUTHENTICATED_FULLY" />
        <anonymous enabled="false" />
        <http-basic entry-point-ref="clientAuthenticationEntryPoint" />

        <!-- include this only if you need to authenticate clients via request parameters -->
        <custom-filter ref="clientCredentialsTokenEndpointFilter" before="BASIC_AUTH_FILTER" />
        <access-denied-handler ref="oauthAccessDeniedHandler" />
    </http>

    <oauth:resource-server id="resourceServerFilter"
            resource-id="rest_server" token-services-ref="tokenServices" />

    <oauth:client-details-service id="clientDetails">
        <oauth:client client-id="the_client" authorized-grant-types="client_credentials" 
                authorities="ROLE_RESTREAD" secret="1234567890" />
    </oauth:client-details-service>


    <http pattern="/**" create-session="never"
            entry-point-ref="oauthAuthenticationEntryPoint"
            access-decision-manager-ref="accessDecisionManager"
            xmlns="http://www.springframework.org/schema/security">
        <anonymous enabled="false" />

        <intercept-url pattern="/rest/**" access="ROLE_RESTREAD" method="GET" />
        <custom-filter ref="resourceServerFilter" before="PRE_AUTH_FILTER" />
        <access-denied-handler ref="oauthAccessDeniedHandler" />
    </http>

    <bean id="tokenStore" class="org.springframework.security.oauth2.provider.token.InMemoryTokenStore" />

    <bean id="tokenServices" class="org.springframework.security.oauth2.provider.token.DefaultTokenServices">
        <property name="tokenStore" ref="tokenStore" />
        <property name="supportRefreshToken" value="false" />
        <property name="clientDetailsService" ref="clientDetails" />
        <property name="accessTokenValiditySeconds" value="400000" />
        <property name="refreshTokenValiditySeconds" value="0" />
    </bean>

    <bean id="accessDecisionManager" class="org.springframework.security.access.vote.UnanimousBased"
            xmlns="http://www.springframework.org/schema/beans">
        <constructor-arg>
            <list>
                <bean class="org.springframework.security.oauth2.provider.vote.ScopeVoter" />
                <bean class="org.springframework.security.access.vote.RoleVoter" />
                <bean class="org.springframework.security.access.vote.AuthenticatedVoter" />
            </list>
        </constructor-arg>
    </bean>


    <bean id="oauthAuthenticationEntryPoint" class="org.springframework.security.oauth2.provider.error.OAuth2AuthenticationEntryPoint">
        <property name="realmName" value="theRealm" />
    </bean>

    <bean id="clientAuthenticationEntryPoint" class="org.springframework.security.oauth2.provider.error.OAuth2AuthenticationEntryPoint">
        <property name="realmName" value="theRealm/client" />
        <property name="typeName" value="Basic" />
    </bean>

    <bean id="clientCredentialsTokenEndpointFilter" class="org.springframework.security.oauth2.provider.client.ClientCredentialsTokenEndpointFilter">
        <property name="authenticationManager" ref="clientAuthenticationManager" />
    </bean>


    <bean id="clientDetailsUserService" class="org.springframework.security.oauth2.provider.client.ClientDetailsUserDetailsService">
        <constructor-arg ref="clientDetails" />
    </bean>

    <bean id="oauthAccessDeniedHandler" class="org.springframework.security.oauth2.provider.error.OAuth2AccessDeniedHandler" />


    <sec:global-method-security pre-post-annotations="enabled" proxy-target-class="true">
        <sec:expression-handler ref="oauthExpressionHandler" />
    </sec:global-method-security>

    <oauth:expression-handler id="oauthExpressionHandler" />

    <oauth:web-expression-handler id="oauthWebExpressionHandler" />
</beans>   

我已经实现了 authenticationManager (UserDetailsS​​ervice) 作为实现基本 spring-security 的一部分,以便帐户和角色对我们的数据库进行持久化。


我没有真正得到的豆子是:

userApprovalHandler:为什么我需要在 client_credentials 流/授权中获得任何用户批​​准?看来,sparklr 会覆盖默认TokenServicesUserApprovalHandler自动批准一个客户。对于受信任的客户端和服务器之间的通信,我是否也需要这样做?

oauthAuthenticationEntryPoint:sparklr 对此所做的所有事情都是:

<bean id="oauthAuthenticationEntryPoint" class="org.springframework.security.oauth2.provider.error.OAuth2AuthenticationEntryPoint">
    <property name="realmName" value="sparklr2" />
</bean>

那应该做什么?

clientCredentialsTokenEndpointFilter 它说,只有当我想通过请求参数进行身份验证时,我才应该包含它。所以我想到的是:向我的服务器发送一个 GET(?) 请求,并获取一个令牌和那个令牌访问资源?所以我在想,对令牌的请求应该包含秘密作为请求参数..?

resourceServerFilter 在我看来,这表示一个单独的资源服务器?如果我的资源与身份验证提供程序位于同一台服务器上,这将如何应用?

accessDecisionManager 我不记得在设置我的自定义 spring-security 实现时必须使用它,为什么我现在要这样做?

感谢您通读!希望有人能回答我的一些问题。。

更新

我已将设置更新为当前的工作状态。我现在可以使用客户端凭据请求访问令牌:

$ curl -X -v -d 'client_id=the_client&client_secret=secret&grant_type=client_credentials' -X POST "http://localhost:9090/our-server/oauth/token"

并使用该令牌访问受保护的资源:

$ curl -H "Authorization: Bearer fdashuds-5432fsd5-sdt5s5d-sd5" "http://localhost:9090/our-server/rest/social/content/posts"

它仍然感觉像很多设置,我的问题仍然存在。另外我想知道这是否是保护可信客户端和 REST 服务器之间通信的正确方法。

除非通过 https 完成,否则对令牌的初始请求仍然感觉不安全,但这就足够了吗?

还有令牌本身呢,我应该给它一个很长的生命周期并将它持久保存在客户端上吗?在任何情况下,这都意味着捕获一个令牌过期异常,然后请求一个新的异常。还是我应该为每个请求握手?刷新令牌呢?我想我在某处读到刷新令牌对于客户端凭据授予类型不安全..?是否有必要将令牌作为 HTTP 标头发送,或者我可以更改它吗?我不想为我们的客户端使用 spring-security 客户端堆栈,因为它具有相当传统的设置(jboss 5),到目前为止我们所做的只是将 REST 通信功能与请求参数集成在一起。

了解更多关于所有弹簧安全设置的信息也会有所帮助,但文档很薄。

编辑

将 spring 安全配置更新为我们当前的状态。另外,这是我们的 web.xml:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
        id="WebApp_ID" version="2.5">

    <display-name>the-display-name</display-name>

    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring-context.xml</param-value>
    </context-param>

    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <listener>
        <listener-class>org.springframework.web.context.request.RequestContextListener</listener-class>
    </listener>

    <servlet>
        <servlet-name>jersey-serlvet</servlet-name>     
        <servlet-class>
            com.sun.jersey.spi.spring.container.servlet.SpringServlet
        </servlet-class>        
        <init-param>
            <param-name>com.sun.jersey.config.property.packages</param-name>
            <param-value>base.package.rest</param-value>
        </init-param>               
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>jersey-serlvet</servlet-name>
        <url-pattern>/rest/*</url-pattern>
    </servlet-mapping>

    <servlet>
        <servlet-name>appServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>
            /WEB-INF/servlet-context.xml            
            </param-value>
        </init-param>
        <load-on-startup>2</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>appServlet</servlet-name>
        <url-pattern>/*</url-pattern>
    </servlet-mapping>

    <filter>
        <filter-name>springSecurityFilterChain</filter-name>
        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
        <init-param>
            <param-name>contextAttribute</param-name>
            <param-value>org.springframework.web.servlet.FrameworkServlet.CONTEXT.appServlet</param-value>
        </init-param>
    </filter>

    <filter-mapping>
        <filter-name>springSecurityFilterChain</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

注意:上面的 spring-security-context.xml 将由 servlet-context 初始化。spring-context.xml 本身只初始化 bean。(另外:我们的服务器也有一些视图,所以所有的 rest 资源都在 /rest 下运行,因此是 url 模式。但是:总是需要有一个单独的 servlet 和 spring 上下文。)

4

2 回答 2

9

userApprovalHandler:如果您的系统中只有一个客户端,我同意用户不必批准它访问他们的数据。

oauthAuthenticationEntryPoint:通常,如果身份验证失败,则响应类型为 JSON。文档说“如果身份验证失败并且调用者要求特定的内容类型响应,则该入口点可以发送一个响应,以及标准的 401 状态。”

clientCredentialsTokenEndpointFilter:颁发访问令牌是一个两步过程。首先,您将用户发送到资源服务器进行身份验证。此重定向由客户端验证,理想情况下使用 HTTP 标头(密钥 + 秘密)。作为回报,客户端会获得一个代码,该代码可以换取一个令牌。您不会直接将密钥+秘密交易为令牌,因为它不包含用户的批准。

resourceServerFilter:我认为这样做的目的是指示哪些客户端可以访问哪些资源,如果您有许多不同的资源。

accessDecisionManager:对于 OAuth2,您需要一个 ScopeVoter,因此默认的 Manager 不够好。

一般来说:如果您只有一个客户端代表用户访问资源,那么也许考虑使用 Digest 而不是 OAuth2?如果您只想对客户端(而不是用户)进行身份验证,那么 OAuth2 就太过分了。OAuth2 中的客户端身份验证实际上与基于 https 的基本身份验证相同。

于 2013-01-06T05:26:24.053 回答
4

使用 spring security ouath 2.0 的 REST 客户端和用户的 oauth2 的一个很好的示例: http ://www.e-zest.net/blog/rest-authentication-using-oauth-2-0-resource-owner-password-flow-协议/

于 2014-03-29T14:28:39.460 回答