webauthn4j/webauthn4j-spring-security

WebAuthn4J Spring Security

概述

WebAuthn4J Spring Security通过使用https://github.com/webauthn4j/webauthn4j%EF%BC%8C%E4%B8%BASpring%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9BWeb Authentication规范支持，允许用户使用WebAuthn兼容的认证器进行登录。

项目状态

该项目处于积极开发中，API签名可能会发生变化。

文档

更多详细信息可参考https://webauthn4j.github.io/webauthn4j-spring-security/en/%E3%80%82

从Maven Central获取

如果使用Maven，只需添加webauthn4j-spring-security作为依赖：

xml
<properties>
  ...
  <!-- 尽可能使用最新版本。 -->
  <webauthn4j-spring-security.version>0.7.1.RELEASE</webauthn4j-spring-security.version>
  ...
</properties>

<dependency>
    <groupId>com.webauthn4j</groupId>
    <artifactId>webauthn4j-spring-security-core</artifactId>
    <version>${webauthn4j-spring-security.version}</version>
</dependency>

构建

WebAuthn4J Spring Security使用基于Gradle的构建系统。以下说明中，gradlew从源代码树的根目录调用，作为跨平台、自包含的构建引导机制。

前提条件

• Java 8或更高版本
• Spring Framework 5.0或更高版本

检出源代码

bash
git clone https://github.com/webauthn4j/webauthn4j-spring-security

构建所有JAR

bash
./gradlew build

运行示例应用

bash
./gradlew samples:spa:bootRun

!登录界面

配置

WebAuthn4J Spring Security可通过Spring Security Java Config进行配置。

java
@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    public void configure(AuthenticationManagerBuilder builder) throws Exception {
        builder.apply(new WebAuthnAuthenticationProviderConfigurer<>(webAuthnAuthenticatorService, webAuthnManager));
        builder.userDetailsService(userDetailsService).passwordEncoder(passwordEncoder);
    }

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

        // WebAuthn登录
        http.apply(WebAuthnLoginConfigurer.webAuthnLogin())
                .defaultSuccessUrl("/", true)
                .rpId("example.com")
                .attestationOptionsEndpoint()
                    .rp()
                        .name("WebAuthn4J Spring Security Sample MPA")
                        .and()
                    .pubKeyCredParams(
                        new PublicKeyCredentialParameters(PublicKeyCredentialType.PUBLIC_KEY, COSEAlgorithmIdentifier.ES256),
                        new PublicKeyCredentialParameters(PublicKeyCredentialType.PUBLIC_KEY, COSEAlgorithmIdentifier.RS1)
                    )
                    .attestation(AttestationConveyancePreference.DIRECT)
                    .extensions()
                        .uvm(true)
                        .credProps(true);
    }
}

许可证

WebAuthn4J Spring Security是开源软件，基于Apache 2.0许可证发布。