此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Security 6.3.1Spring中文文档

此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Security 6.3.1Spring中文文档

本节介绍如何获取 Spring Security 二进制文件。 有关如何获取源代码,请参阅源代码Spring中文文档

版本编号

Spring Security 版本的格式为 MAJOR。次要。PATCH 使得:Spring中文文档

  • MAJOR 版本可能包含重大更改。 通常,这样做是为了提供改进的安全性,以匹配现代安全实践。Spring中文文档

  • MINOR 版本包含增强功能,但被视为被动更新。Spring中文文档

  • PATCH 级别应该完全兼容,向前和向后,除了修复错误的更改之外。Spring中文文档

与 Maven 一起使用

与大多数开源项目一样,Spring Security 将其依赖项部署为 Maven 工件。 本节中的主题介绍如何在使用 Maven 时使用 Spring Security。Spring中文文档

使用 Maven 的 Spring Boot

Spring Boot 提供了一个聚合 Spring Security 相关依赖项的启动器。 使用启动器的最简单和首选方法是通过使用 IDE 集成(EclipseIntelliJNetBeans)或通过 start.spring.io 来使用 Spring Initializr。 或者,您可以手动添加启动器,如以下示例所示:spring-boot-starter-securitySpring中文文档

pom.xml
<dependencies>
	<!-- ... other dependency elements ... -->
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-security</artifactId>
	</dependency>
</dependencies>

由于 Spring Boot 提供了 Maven BOM 来管理依赖版本,因此无需指定版本。 如果要覆盖 Spring Security 版本,可以通过提供 Maven 属性来实现:Spring中文文档

pom.xml
<properties>
	<!-- ... -->
	<spring-security.version>6.3.2-SNAPSHOT</spring-security.version>
</properties>

由于 Spring Security 仅在主要版本中进行重大更改,因此您可以安全地将较新版本的 Spring Security 与 Spring Boot 一起使用。 但是,有时您可能还需要更新 Spring Framework 的版本。 您可以通过添加 Maven 属性来执行此操作:Spring中文文档

pom.xml
<properties>
	<!-- ... -->
	<spring.version>6.1.10</spring.version>
</properties>

如果使用其他功能(如 LDAP、OAuth 2 等),则还需要包含相应的项目模块和依赖项Spring中文文档

没有 Spring Boot 的 Maven

当您在没有 Spring Boot 的情况下使用 Spring Security 时,首选方法是使用 Spring Security 的 BOM 来确保在整个项目中使用一致的 Spring Security 版本。以下示例演示如何执行此操作:Spring中文文档

pom.xml
<dependencyManagement>
	<dependencies>
		<!-- ... other dependency elements ... -->
		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-bom</artifactId>
			<version>{spring-security-version}</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
	</dependencies>
</dependencyManagement>

最小的 Spring Security Maven 依赖项集通常如下例所示:Spring中文文档

pom.xml
<dependencies>
	<!-- ... other dependency elements ... -->
	<dependency>
		<groupId>org.springframework.security</groupId>
		<artifactId>spring-security-web</artifactId>
	</dependency>
	<dependency>
		<groupId>org.springframework.security</groupId>
		<artifactId>spring-security-config</artifactId>
	</dependency>
</dependencies>

如果使用其他功能(如 LDAP、OAuth 2 等),则还需要包含相应的项目模块和依赖项Spring中文文档

Spring Security 针对 Spring Framework 6.1.10 构建,但通常应适用于任何较新版本的 Spring Framework 5.x。 许多用户可能会遇到这样一个事实,即 Spring Security 的传递依赖项可以解决 Spring Framework 6.1.10,这可能会导致奇怪的类路径问题。 解决此问题的最简单方法是使用以下部分的 within :spring-framework-bom<dependencyManagement>pom.xmlSpring中文文档

pom.xml
<dependencyManagement>
	<dependencies>
		<!-- ... other dependency elements ... -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-framework-bom</artifactId>
			<version>6.1.10</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
	</dependencies>
</dependencyManagement>

前面的示例确保 Spring Security 的所有传递依赖项都使用 Spring 6.1.10 模块。Spring中文文档

此方法使用 Maven 的“物料清单”(BOM) 概念,仅在 Maven 2.0.9+ 中可用。 有关如何解析依赖关系的更多详细信息,请参阅 Maven 的依赖关系机制简介文档Spring中文文档

Maven 存储库

所有 GA 版本(即以 . 结尾的版本)RELEASE) 部署到 Maven Central,因此您无需在 pom 中声明其他 Maven 存储库。Spring中文文档

如果使用 SNAPSHOT 版本,则需要确保定义了 Spring Snapshot 存储库:Spring中文文档

pom.xml
<repositories>
	<!-- ... possibly other repository elements ... -->
	<repository>
		<id>spring-snapshot</id>
		<name>Spring Snapshot Repository</name>
		<url>https://repo.spring.io/snapshot</url>
	</repository>
</repositories>

如果使用里程碑或候选发布版本,则需要确保定义了 Spring Milestone 存储库,如以下示例所示:Spring中文文档

pom.xml
<repositories>
	<!-- ... possibly other repository elements ... -->
	<repository>
		<id>spring-milestone</id>
		<name>Spring Milestone Repository</name>
		<url>https://repo.spring.io/milestone</url>
	</repository>
</repositories>

此方法使用 Maven 的“物料清单”(BOM) 概念,仅在 Maven 2.0.9+ 中可用。 有关如何解析依赖关系的更多详细信息,请参阅 Maven 的依赖关系机制简介文档Spring中文文档

Gradle

与大多数开源项目一样,Spring Security 将其依赖项部署为 Maven 工件,从而提供一流的 Gradle 支持。 以下主题介绍如何在使用 Gradle 时使用 Spring Security。Spring中文文档

带有 Gradle 的 Spring Boot

Spring Boot 提供了一个聚合 Spring Security 相关依赖项的启动器。 使用启动器的最简单和首选方法是通过使用 IDE 集成(EclipseIntelliJNetBeans)或通过 start.spring.io 来使用 Spring Initializrspring-boot-starter-securitySpring中文文档

或者,您可以手动添加启动器:Spring中文文档

build.gradle
dependencies {
	implementation "org.springframework.boot:spring-boot-starter-security"
}

由于 Spring Boot 提供了 Maven BOM 来管理依赖版本,因此无需指定版本。 如果要覆盖 Spring Security 版本,可以通过提供 Gradle 属性来实现:Spring中文文档

build.gradle
ext['spring-security.version']='6.3.2-SNAPSHOT'

由于 Spring Security 仅在主要版本中进行重大更改,因此您可以安全地将较新版本的 Spring Security 与 Spring Boot 一起使用。 但是,有时您可能还需要更新 Spring Framework 的版本。 您可以通过添加 Gradle 属性来执行此操作:Spring中文文档

build.gradle
ext['spring.version']='6.1.10'

如果使用其他功能(如 LDAP、OAuth 2 等),则还需要包含相应的项目模块和依赖项Spring中文文档

没有 Spring Boot 的 Gradle

当您在没有 Spring Boot 的情况下使用 Spring Security 时,首选方法是使用 Spring Security 的 BOM 来确保在整个项目中使用一致的 Spring Security 版本。 您可以使用依赖项管理插件执行此操作:Spring中文文档

build.gradle
plugins {
	id "io.spring.dependency-management" version "1.0.6.RELEASE"
}

dependencyManagement {
	imports {
		mavenBom 'org.springframework.security:spring-security-bom:6.3.2-SNAPSHOT'
	}
}

A minimal Spring Security Maven collection of dependencies 通常如下所示:Spring中文文档

build.gradle
dependencies {
	implementation "org.springframework.security:spring-security-web"
	implementation "org.springframework.security:spring-security-config"
}

如果使用其他功能(如 LDAP、OAuth 2 等),则还需要包含相应的项目模块和依赖项Spring中文文档

Spring Security 针对 Spring Framework 6.1.10 构建,但通常应适用于任何较新版本的 Spring Framework 5.x。 许多用户可能会遇到这样一个事实,即 Spring Security 的传递依赖项可以解决 Spring Framework 6.1.10,这可能会导致奇怪的类路径问题。 解决此问题的最简单方法是在 . 您可以使用依赖项管理插件执行此操作:spring-framework-bomdependencyManagementbuild.gradleSpring中文文档

build.gradle
plugins {
	id "io.spring.dependency-management" version "1.0.6.RELEASE"
}

dependencyManagement {
	imports {
		mavenBom 'org.springframework:spring-framework-bom:6.1.10'
	}
}

前面的示例确保 Spring Security 的所有传递依赖项都使用 Spring 6.1.10 模块。Spring中文文档

Gradle 存储库

所有 GA 版本(即以 . 结尾的版本)RELEASE) 部署到 Maven Central,因此使用存储库足以发布 GA。以下示例演示如何执行此操作:mavenCentral()Spring中文文档

build.gradle
repositories {
	mavenCentral()
}

如果使用 SNAPSHOT 版本,则需要确保定义了 Spring Snapshot 存储库:Spring中文文档

build.gradle
repositories {
	maven { url 'https://repo.spring.io/snapshot' }
}

如果使用里程碑或候选发布版本,则需要确保定义了 Spring Milestone 存储库:Spring中文文档

build.gradle
repositories {
	maven { url 'https://repo.spring.io/milestone' }
}