1. 程式人生 > >Oauth2認證模式之授權碼模式實現

Oauth2認證模式之授權碼模式實現

Oauth2認證模式之授權碼模式(authorization code)

本示例實現了Oauth2之授權碼模式,授權碼模式(authorization code)是功能最完整、流程最嚴密的授權模式。它的特點就是通過客戶端的後臺伺服器,與"服務提供商"的認證伺服器進行互動。

閱讀本示例之前,你需要先有以下兩點基礎:

  • 需要對spring security有一定的配置使用經驗,使用者認證這一塊,spring security oauth2建立在spring security的基礎之上
  • oauth2開放授權標準基礎,可以穩步到OAuth2 詳解,瀏覽下授權碼模式,理解下基本概念

概述

實現 oauth2,可以簡易的分為三個步驟

  • 配置資源伺服器
  • 配置認證伺服器
  • 配置spring security

程式碼實現

1.pom.xml新增maven依賴

    <dependencies>
        <dependency>
            <groupId>org.springframework.security.oauth</groupId>
            <artifactId>spring-security-oauth2</artifactId>
            <version>2.3.6.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
    </dependencies>

2.配置資源伺服器

public class ResourceServerConfig {

    private static final String RESOURCE_ID = "account";

    @Configuration
    @EnableResourceServer()
    protected static class ResourceServerConfiguration extends ResourceServerConfigurerAdapter {

        @Override
        public void configure(ResourceServerSecurityConfigurer resources) {
            resources.resourceId(RESOURCE_ID).stateless(true);
        }

        @Override
        public void configure(HttpSecurity httpSecurity) throws Exception {
            httpSecurity
                    .requestMatchers()
                    // 保險起見,防止被主過濾器鏈路攔截
                    .antMatchers("/account/**").and()
                    .authorizeRequests().anyRequest().authenticated()
                    .and()
                    .authorizeRequests()
                    .antMatchers("/account/info/**").access("#oauth2.hasScope('get_user_info')")
                    .antMatchers("/account/child/**").access("#oauth2.hasScope('get_childlist')");
        }
    }
}

3.配置認證伺服器

    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        clients.inMemory()
                .withClient("client1")
                .resourceIds(RESOURCE_ID)
                .authorizedGrantTypes("authorization_code", "refresh_token", "implicit")
                .authorities("ROLE_CLIENT")
                .scopes("get_user_info", "get_childlist")
                .secret("secret")
                .redirectUris("http://localhost:8081/client/account/redirect")
                .autoApprove(true)
                .autoApprove("get_user_info");
    }

4.配置spring security

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Bean
    @Override
    protected UserDetailsService userDetailsService() {
        InMemoryUserDetailsManager manager = new InMemoryUserDetailsManager();
        // 建立兩個記憶體使用者
        manager.createUser(User.withUsername("admin").password("123456").authorities("USER").build());
        manager.createUser(User.withUsername("lin").password("123456").authorities("USER").build());
        return manager;
    }

    @Override
    @Bean
    public AuthenticationManager authenticationManagerBean() throws Exception {
        return super.authenticationManagerBean();
    }

    @Bean
    PasswordEncoder passwordEncoder(){
        return NoOpPasswordEncoder.getInstance();
    }

    /**
     * 密碼生成器(預設為bcrypt模式)
     *
     * @return
     */
//    @Bean
//    PasswordEncoder passwordEncoder() {
//        return PasswordEncoderFactories.createDelegatingPasswordEncoder();
//    }

    @Override
    protected void configure(HttpSecurity httpSecurity) throws Exception {

        httpSecurity.
                requestMatchers()
                // 必須登入過的使用者才可以進行 oauth2 的授權碼申請
                .antMatchers("/", "/home", "/login", "/oauth/authorize")
                .and()
                .authorizeRequests()
                .anyRequest().permitAll()
                .and()
                .formLogin()
                .loginPage("/login")
                .and()
                .httpBasic()
                .disable()
                .exceptionHandling()
                .accessDeniedPage("/login?authorization_error=true")
                .and()
                .csrf()
                .requireCsrfProtectionMatcher(new AntPathRequestMatcher("/oauth/authorize"))
                .disable();
    }
}

使用介紹

  • 找到AuthResServerApplication.java執行server服務,預設埠:8080
  • 找到ClientApplication.java執行client客戶端,埠:8081

1.嘗試直接訪問使用者資訊

http://localhost:8080/account/info/testAccount1/

返回未授權錯誤

<oauth>
<error_description>
Full authentication is required to access this resource
</error_description>
<error>unauthorized</error>
</oauth>

2.嘗試獲取授權碼

http://localhost:8080/oauth/authorize?client_id=client1&response_type=code&redirect_uri=http://localhost:8081/client/account/redirect

結果被主過濾器攔截,302 跳轉到登入頁,因為 /oauth/authorize 端點是受保護的端點,必須登入的使用者才能申請 code。

3.輸入使用者名稱和密碼

輸入使用者名稱和密碼 admin 123456
如上使用者名稱密碼是交給 SpringSecurity 的主過濾器用來認證的

4.登入成功後,真正進行授權碼的申請

oauth/authorize 認證成功,會根據 redirect_uri 執行 302 重定向,並且帶上生成的 code,注意重定向到的是 8001 埠,這個時候已經是另外一個應用了。

localhost:8081/client/account/redirect?code=xxxx
程式碼中封裝了一個 http 請求,使得 client1 使用 restTemplate 向 server 傳送 token 的申請,當然是使用 code 來申請的,並最終成功獲取到 access_token

{
access_token: "59a25558-f714-4ca8-aa87-c36f93c120bf",
token_type: "bearer",
refresh_token: "92436849-7ef7-4923-8270-5a2c9b464556",
expires_in: 43199,
scope: "get_user_info get_childlist"
}

5.攜帶 access_token 訪問account資訊

http://localhost:8080/account/info/testAccount1?access_token=59a25558-f714-4ca8-aa87-c36f93c120bf

6.正常返回資訊

{
name: "testAccount1",
nickName: "測試使用者1",
remark: "備註1",
childAccount: [
{
name: "testChild1_0",
nickName: "測試子使用者1_0",
remark: "0",
childAccount: null
},
{
name: "testChild1_1",
nickName: "測試子使用者1_1",
remark: "1",
childAccount: null
},
{
name: "testChild1_2",
nickName: "測試子使用者1_2",
remark: "2",
childAccount: null
},
{
name: "testChild1_3",
nickName: "測試子使用者1_3",
remark: "3",
childAccount: null
},
{
name: "testChild1_4",
nickName: "測試子使用者1_4",
remark: "4",
childAccount: null
},
{
name: "testChild1_5",
nickName: "測試子使用者1_5",
remark: "5",
childAccount: null
},
{
name: "testChild1_6",
nickName: "測試子使用者1_6",
remark: "6",
childAccount: null
},
{
name: "testChild1_7",
nickName: "測試子使用者1_7",
remark: "7",
childAccount: null
},
{
name: "testChild1_8",
nickName: "測試子使用者1_8",
remark: "8",
childAccount: null
},
{
name: "testChild1_9",
nickName: "測試子使用者1_9",
remark: "9",
childAccount: null
}
]
}

資料

  • 示例程式碼-github
  • 官方文件
  • OAuth2 Boot
  • 授權碼模式參考