获取 Spring Security (Getting Spring Security) _ Spring Security6.3.1中文文档(官方文档中文翻译)|Spring 教程 —

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

版本编号

Spring Security 版本的格式为 MAJOR。次要。PATCH 使得：

MAJOR 版本可能包含重大更改。通常，这样做是为了提供改进的安全性，以匹配现代安全实践。
MINOR 版本包含增强功能，但被视为被动更新。
PATCH 级别应该完全兼容，向前和向后，除了修复错误的更改之外。

与 Maven 一起使用

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

使用 Maven 的 Spring Boot

Spring Boot 提供了一个聚合 Spring Security 相关依赖项的启动器。使用启动器的最简单和首选方法是通过使用 IDE 集成（Eclipse 或 IntelliJ、NetBeans）或通过 start.spring.io 来使用 Spring Initializr。或者，您可以手动添加启动器，如以下示例所示：spring-boot-starter-security

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 属性来实现：

pom.xml

<properties>
	<!-- ... -->
	<spring-security.version>6.3.1</spring-security.version>
</properties>

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

pom.xml

<properties>
	<!-- ... -->
	<spring.version>6.1.9</spring.version>
</properties>

如果使用其他功能（如 LDAP、OAuth 2 等），则还需要包含相应的项目模块和依赖项。

没有 Spring Boot 的 Maven

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

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 依赖项集通常如下例所示：

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

pom.xml

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

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

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

Maven 存储库

所有 GA 版本（即以 . 结尾的版本）RELEASE）部署到 Maven Central，因此您无需在 pom 中声明其他 Maven 存储库。

如果使用 SNAPSHOT 版本，则需要确保定义了 Spring Snapshot 存储库：

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 存储库，如以下示例所示：

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 的依赖关系机制简介文档。

Gradle

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

带有 Gradle 的 Spring Boot

Spring Boot 提供了一个聚合 Spring Security 相关依赖项的启动器。使用启动器的最简单和首选方法是通过使用 IDE 集成（Eclipse 或 IntelliJ、NetBeans）或通过 start.spring.io 来使用 Spring Initializr。spring-boot-starter-security

或者，您可以手动添加启动器：

build.gradle

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

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

build.gradle

ext['spring-security.version']='6.3.1'

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

build.gradle

ext['spring.version']='6.1.9'

如果使用其他功能（如 LDAP、OAuth 2 等），则还需要包含相应的项目模块和依赖项。

没有 Spring Boot 的 Gradle

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

build.gradle

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

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

A minimal Spring Security Maven collection of dependencies 通常如下所示：

build.gradle

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

如果使用其他功能（如 LDAP、OAuth 2 等），则还需要包含相应的项目模块和依赖项。

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

build.gradle

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

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

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

Gradle 存储库

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

build.gradle

repositories {
	mavenCentral()
}

如果使用 SNAPSHOT 版本，则需要确保定义了 Spring Snapshot 存储库：

build.gradle

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

如果使用里程碑或候选发布版本，则需要确保定义了 Spring Milestone 存储库：

build.gradle

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