跳到主要内容
版本:5.1.1

安全

Doubao 中英对照 Security

Spring Data REST 与 Spring Security 配合得很好。本节展示了如何使用方法级安全来保护您的 Spring Data REST 服务的示例。

@Pre 与 @Post 安全​

以下来自 Spring Data REST 测试套件的示例展示了 Spring Security 的前置授权模型(最完善的安全模型):

示例 1. spring-data-rest-tests/spring-data-rest-tests-security/src/test/java/org/springframework/data/rest/tests/security/PreAuthorizedOrderRepository.java

@PreAuthorize("hasRole('ROLE_USER')") 1
public interface PreAuthorizedOrderRepository extends CrudRepository<Order, UUID> {

@PreAuthorize("hasRole('ROLE_ADMIN')")
@Override
Optional<Order> findById(UUID id);

@PreAuthorize("hasRole('ROLE_ADMIN')") 2
@Override
void deleteById(UUID aLong);

@PreAuthorize("hasRole('ROLE_ADMIN')")
@Override
void delete(Order order);

@PreAuthorize("hasRole('ROLE_ADMIN')")
@Override
void deleteAll(Iterable<? extends Order> orders);

@PreAuthorize("hasRole('ROLE_ADMIN')")
@Override
void deleteAll();
}
  • 这个 Spring Security 注解保护了整个仓库。Spring Security SpEL 表达式表明,主体的角色集合中必须包含 ROLE_USER。

  • 要更改方法级设置,您必须重写方法签名并应用 Spring Security 注解。在本例中,该方法以「用户必须拥有 ROLE_ADMIN 才能执行删除」的要求覆盖了仓库级设置。

上面的示例展示了一个扩展 CrudRepository 的标准 Spring Data 仓库定义,并做了一些关键改动:为访问各个方法指定特定的角色:

important

仓库级与方法级的安全设置不会叠加。相反,方法级设置会覆盖仓库级设置。

前面的示例说明,CrudRepository 实际上有四个删除方法。您必须重写所有删除方法,才能正确地保护它。

@Secured 安全​

以下示例展示了 Spring Security 较早的 @Secured 注解,它纯粹基于角色:

示例 2. spring-data-rest-tests/spring-data-rest-tests-security/src/test/java/org/springframework/data/rest/tests/security/SecuredPersonRepository.java

@Secured("ROLE_USER") 1
@RepositoryRestResource(collectionResourceRel = "people", path = "people")
public interface SecuredPersonRepository extends CrudRepository<Person, UUID> {

@Secured("ROLE_ADMIN") 2
@Override
void deleteById(UUID aLong);

@Secured("ROLE_ADMIN")
@Override
void delete(Person person);

@Secured("ROLE_ADMIN")
@Override
void deleteAll(Iterable<? extends Person> persons);

@Secured("ROLE_ADMIN")
@Override
void deleteAll();
}
  • 这与前面的示例产生相同的安全检查,但灵活性较低。它仅允许以角色作为限制访问的手段。

  • 同样,这表明删除方法需要 ROLE_ADMIN。

备注

如果您是从新项目开始,或首次应用 Spring Security,建议使用 @PreAuthorize。如果您已在应用的其他部分使用带 @Secured 的 Spring Security,则可以继续沿用这种方式,而无需重写所有内容。

启用方法级安全​

要配置方法级安全,以下是来自 Spring Data REST 测试套件的一段简短代码:

示例 3. spring-data-rest-tests/spring-data-rest-tests-security/src/test/java/org/springframework/data/rest/tests/security/SecurityConfiguration.java

@Configuration 1
@EnableWebSecurity
@EnableMethodSecurity(securedEnabled = true, prePostEnabled = true) 2
class SecurityConfiguration { 3
...
}
  • 这是一个 Spring 配置类。

  • 它使用 Spring Security 的 @EnableGlobalMethodSecurity 注解来同时启用对 @Secured 和 @Pre/@Post 的支持。注意:您不必两者都用。这个特定用例是为了证明两种版本都能与 Spring Data REST 配合工作。

  • 该类扩展了 Spring Security 的 WebSecurityConfigurerAdapter,后者用于安全的纯 Java 配置。

配置类的其余部分不再列出,因为它遵循标准做法,您可以在 Spring Security 参考文档中阅读相关内容。