Skip to content

Improve migration guidance #2272

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Killian-fal wants to merge 1 commit into from
Closed

Improve migration guidance #2272

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions README.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
= Spring Authorization Server image:https://badges.gitter.im/Join%20Chat.svg[Gitter,link=https://gitter.im/spring-projects/spring-security?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge] image:https://github.com/spring-projects/spring-authorization-server/actions/workflows/continuous-integration-workflow.yml/badge.svg["Build Status", link="https://github.com/spring-projects/spring-authorization-server/actions/workflows/continuous-integration-workflow.yml"] image:https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle&labelColor=02303A["Revved up by Develocity", link="https://ge.spring.io/scans?&search.rootProjectNames=spring-authorization-server"]

== NOTICE:

[IMPORTANT]
====
Spring Authorization Server has https://spring.io/blog/2025/09/11/spring-authorization-server-moving-to-spring-security-7-0[moved to Spring Security 7.0].
All ongoing development now happens in Spring Security: https://github.com/spring-projects/spring-security/tree/main/oauth2[github.com/spring-projects/spring-security/tree/main/oauth2].
Copy link
Collaborator

@jgrandja jgrandja Jan 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this sentence is redundant as it's already stated in:

Going forward, new features will be added to Spring Security starting in 7.0

====

The *1.5.x* branch is the last generation of Spring Authorization Server. See the OSS and Enterprise https://spring.io/projects/spring-authorization-server#support[support timelines].

Expand Down
7 changes: 7 additions & 0 deletions docs/modules/ROOT/pages/getting-started.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@
[[getting-started]]
= Getting Started

[IMPORTANT]
====
Spring Authorization Server has https://spring.io/blog/2025/09/11/spring-authorization-server-moving-to-spring-security-7-0[moved to Spring Security 7.0] and this documentation is no longer updated for Spring Boot 4.
Copy link
Collaborator

@jgrandja jgrandja Jan 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't do updates to maintenance branches unless it's a bug fix.

The project page and GitHub project provide the same notice that indicates the move to Spring Security 7.0 and also provides a link to the blog announcement explaining the decision for the move. The blog announcement also provides a link to the new reference documentation location in Spring Security 7.

If you are on Spring Boot 4 (or migrating), use the Spring Security Authorization Server documentation:
https://docs.spring.io/spring-security/reference/servlet/oauth2/authorization-server/index.html[Spring Security Authorization Server Reference].
====

If you are just getting started with Spring Authorization Server, the following sections walk you through creating your first application.

[[system-requirements]]
Expand Down
7 changes: 7 additions & 0 deletions docs/modules/ROOT/pages/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@
[[top]]
= Spring Authorization Server Reference

[IMPORTANT]
====
Spring Authorization Server has https://spring.io/blog/2025/09/11/spring-authorization-server-moving-to-spring-security-7-0[moved to Spring Security 7.0] and this documentation is no longer updated for Spring Boot 4.
If you are on Spring Boot 4 (or migrating), use the Spring Security Authorization Server documentation:
https://docs.spring.io/spring-security/reference/servlet/oauth2/authorization-server/index.html[Spring Security Authorization Server Reference].
====

[horizontal]
xref:overview.adoc[Overview] :: Introduction, use cases and feature list
xref:getting-help.adoc[Getting Help] :: Links to samples, questions and issues
Expand Down
7 changes: 7 additions & 0 deletions docs/modules/ROOT/pages/overview.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
[[overview]]
= Overview

[IMPORTANT]
====
Spring Authorization Server has https://spring.io/blog/2025/09/11/spring-authorization-server-moving-to-spring-security-7-0[moved to Spring Security 7.0] and this documentation is no longer updated for Spring Boot 4.
If you are on Spring Boot 4 (or migrating), use the Spring Security Authorization Server documentation:
https://docs.spring.io/spring-security/reference/servlet/oauth2/authorization-server/index.html[Spring Security Authorization Server Reference].
====

This site contains reference documentation and how-to guides for Spring Authorization Server.

[[introducing-spring-authorization-server]]
Expand Down