PAC4J 新手入门，之一（概述及准备）

什么是 pac4j

pac4j 是一个简单而强大的安全框架，用于 Java 验证用户、获取用户配置文件和管理授权，以保护 web 应用程序和 web服务。

它提供了一套全面的概念和组件。它适用于大多数框架/工具，并支持大多数认证和授权机制。它的开源授权协议为 Apache 2。

在 Java Web 项目开发中，涉及到用户认证时，我们可以选用 pac4j 框架进行对接，以减少开发工作量。而由于 pac4j 本身支持了很多认证协议，如 OAuth2.0、OIDC、CAS、SAML2等，所以我们更倾向于，当我们的项目需要作为认证协议客户端，对接相应协议时使用 pac4j 框架，以减少对接工作量。

pac4j 资料

pac4j 官方网站：网站

pac4j 中文文档地址：中文

pac4j 英文文档地址：英文

pac4j GitHub 地址：GitHub

pac4j 邮件列表：邮件列表

知识准备

阅读此 pac4j 新手指南，需要读者具有以下相关知识：

基本的 Java 语言知识（包括 Java 8 中引入的 Lambda）
会 Spring Boot 项目，并具有基本的 Spring Boot 项目知识
常用 IDE 软件的使用经验，如 IntelliJ IDEA
Maven 基础知识（熟悉 Gradle 也可）

pac4j 的版本

pac4j 目前分为三个主线版本，分别为：4.X、5.X 和 6.X，分别对应的 JDK 版本为：JDK 8、JDK 11 和 JDK 17。

使用时我们需要按照自己项目依赖的 JDK 版本进行选择。

软件/框架	版本号
`JDK`	`17.0.5`
`IntelliJ IDEA`	`社区版 2022.3.1`
`Maven`	`IntelliJ IDEA 内嵌`
`Spring Boot`	`2.7.7`
`Spring Security`	`2.7.7`
`pac4j`	`5.7.0`

初始化项目

我们在 IntelliJ IDEA 中新建一个 Maven 项目，并修改 pom.xml 以适配 Spring Boot，构建一个使用 Spring Boot 和 Spring Security 的基础项目。

pom.xml：

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.7</version>
        <relativePath/>
    </parent>

    <groupId>tech.bookhub</groupId>
    <artifactId>pac4j-demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <name>pac4j-demo</name>
    <description>pac4j demo project for Spring Boot.</description>

    <properties>
        <java.version>17</java.version>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

application.yml：

yaml 复制代码

server:
  port: 8888

spring:
  security:
    user:
      name: admin
      password: bookhub

以上 application.yml 文件意图为：指定 tomcat 以端口 8888 运行，并配置一个用户 admin，密码为 bookhub。

Pac4jApplication.java：

java 复制代码

package tech.bookhub;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Pac4jApplication {
    public static void main(String[] args) {
        SpringApplication.run(Pac4jApplication.class, args);
    }
}

IndexController.java：

java 复制代码

package tech.bookhub.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class IndexController {

    @GetMapping("/")
    public String index() {
        return "index ok";
    }
}

项目结构如下图:

然后我们运行项目后，可以通过浏览器访问 http://localhost:8888/，首次访问将会跳转到 Spring Security 的默认认证界面，我们输入用户名 admin，密码 bookhub，如下图：

认证成功后，我们即可获得路径 / 的响应 index ok，如下图：

以上 Demo 代码见 GitHub，Demo 0。