This is an automated email from the ASF dual-hosted git repository. ilgrosso pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/syncope.git
commit 62c0b077006185380ca8f0d4a1b62803ba11c466 Author: Francesco Chicchiriccò <[email protected]> AuthorDate: Fri Jan 16 17:23:55 2026 +0100 Updating Spring links --- pom.xml | 2 +- src/main/asciidoc/getting-started/introduction.adoc | 4 ++-- src/main/asciidoc/reference-guide/architecture/core.adoc | 11 ++++++----- src/main/asciidoc/reference-guide/concepts/entitlements.adoc | 2 +- src/main/asciidoc/reference-guide/concepts/reports.adoc | 2 +- src/main/asciidoc/reference-guide/concepts/tasks.adoc | 8 ++++---- .../asciidoc/reference-guide/concepts/typemanagement.adoc | 2 +- .../configuration/configurationparameters.adoc | 2 +- src/main/asciidoc/reference-guide/configuration/dbms.adoc | 8 ++++---- .../asciidoc/reference-guide/configuration/deployment.adoc | 10 +++++----- src/main/asciidoc/reference-guide/usage/actuator.adoc | 2 +- src/main/asciidoc/reference-guide/usage/core.adoc | 2 +- src/main/asciidoc/reference-guide/usage/customization.adoc | 10 +++++----- src/main/asciidoc/reference-guide/usage/loggers.adoc | 2 +- src/main/asciidoc/reference-guide/usage/metrics.adoc | 4 ++-- 15 files changed, 36 insertions(+), 35 deletions(-) diff --git a/pom.xml b/pom.xml index c8f4bb6751..cfbed9d624 100644 --- a/pom.xml +++ b/pom.xml @@ -2203,7 +2203,7 @@ under the License. <link>https://commons.apache.org/proper/commons-lang/javadocs/api-release/</link> <link>https://commons.apache.org/proper/commons-jexl/apidocs/</link> <link>https://tika.apache.org/3.2.3/api/</link> - <link>https://docs.spring.io/spring-boot/3.4/api/java/</link> + <link>https://docs.spring.io/spring-boot/3.5/api/java/</link> <link>https://docs.spring.io/spring-framework/docs/6.2.x/javadoc-api/</link> <link>https://docs.spring.io/spring-security/site/docs/6.5.x/api/</link> <link>https://www.flowable.com/open-source/docs/javadocs/</link> diff --git a/src/main/asciidoc/getting-started/introduction.adoc b/src/main/asciidoc/getting-started/introduction.adoc index e74249d295..74d03049e5 100644 --- a/src/main/asciidoc/getting-started/introduction.adoc +++ b/src/main/asciidoc/getting-started/introduction.adoc @@ -144,9 +144,9 @@ all-Java implementation can be extended for this purpose. from a provided list - including one based on https://www.flowable.org/[Flowable^], the reference open source http://www.bpmn.org/[BPMN 2.0^] implementations - or define new, custom ones. * *_Persistence_* manages all data (users, groups, attributes, resources, ...) at a high level -using a standard https://en.wikipedia.org/wiki/Jakarta_Persistence[Jakarta Persistence 3.1] approach. The data is persisted to an underlying +using a standard https://en.wikipedia.org/wiki/Jakarta_Persistence[Jakarta Persistence 3.2] approach. The data is persisted to an underlying database, referred to as *_Internal Storage_*. Consistency is ensured via the comprehensive -https://docs.spring.io/spring-framework/reference/6.2/data-access/transaction.html[transaction management^] +https://docs.spring.io/spring-framework/reference/7.0/data-access/transaction.html[transaction management^] provided by the Spring Framework. + Globally, this offers the ability to easily scale up to a million entities and at the same time allows great portability with no code changes: PostgreSQL, MySQL, MariaDB and Oracle are fully supported deployment options. diff --git a/src/main/asciidoc/reference-guide/architecture/core.adoc b/src/main/asciidoc/reference-guide/architecture/core.adoc index ab683d3550..e3b794bdff 100644 --- a/src/main/asciidoc/reference-guide/architecture/core.adoc +++ b/src/main/asciidoc/reference-guide/architecture/core.adoc @@ -33,7 +33,7 @@ The rich pre-defined set of endpoints can be <<extensions,extended>> by adding n given Apache Syncope deployment to complement the native features with domain-specific operations. At a technical level, the RESTful interface is a fully-compliant -https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services[Jakarta RESTful Web Services 3.1^] implementation based on +https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services[Jakarta RESTful Web Services 4.0^] implementation based on http://cxf.apache.org[Apache CXF^], natively dealing with JSON payloads. More details are available in the dedicated <<core-usage,usage>> section. @@ -80,10 +80,11 @@ https://camunda.org/[Camunda^] or http://jbpm.jboss.org/[jBPM^], can be written ==== Persistence All data (users, groups, attributes, resources, ...) is internally managed at a high level using a standard -https://en.wikipedia.org/wiki/Jakarta_Persistence[Jakarta Persistence 3.1] approach based on https://openjpa.apache.org[Apache OpenJPA^]. -The data is persisted into an underlying -database, referred to as *_Internal Storage_*. Consistency is ensured via the comprehensive -https://docs.spring.io/spring-framework/reference/6.2/data-access/transaction.html[transaction management^] +https://en.wikipedia.org/wiki/Jakarta_Persistence[Jakarta Persistence 3.1] approach based on +https://hibernate.org/orm/[Hibernate ORM^]. +The data is persisted into an underlying database, referred to as *_Internal Storage_*. Consistency is ensured via the +comprehensive +https://docs.spring.io/spring-framework/reference/7.0/data-access/transaction.html[transaction management^] provided by the Spring Framework. Globally, this offers the ability to easily scale up to a million entities and at the same time allows great portability diff --git a/src/main/asciidoc/reference-guide/concepts/entitlements.adoc b/src/main/asciidoc/reference-guide/concepts/entitlements.adoc index f4863c59b3..88f835e63e 100644 --- a/src/main/asciidoc/reference-guide/concepts/entitlements.adoc +++ b/src/main/asciidoc/reference-guide/concepts/entitlements.adoc @@ -30,7 +30,7 @@ ifeval::["{snapshotOrRelease}" == "snapshot"] https://github.com/apache/syncope/blob/master/core/idrepo/logic/src/main/java/org/apache/syncope/core/logic/RealmLogic.java[RealmLogic^] endif::[] , the -https://docs.spring.io/spring-security/reference/6.4/servlet/authorization/method-security.html#authorization-expressions[`hasRole` expression^] +https://docs.spring.io/spring-security/reference/6.5/servlet/authorization/method-security.html#authorization-expressions[`hasRole` expression^] is used together with one of the standard entitlements to restrict access only to Users owning the `REALM_SEARCH` entitlement. diff --git a/src/main/asciidoc/reference-guide/concepts/reports.adoc b/src/main/asciidoc/reference-guide/concepts/reports.adoc index 428933142b..7f8ca84359 100644 --- a/src/main/asciidoc/reference-guide/concepts/reports.adoc +++ b/src/main/asciidoc/reference-guide/concepts/reports.adoc @@ -34,4 +34,4 @@ endif::[] providing the custom logic to extract information from Syncope and generate output according to the configured mime type * scheduling information: ** when to start -** https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron expression^] +** https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron expression^] diff --git a/src/main/asciidoc/reference-guide/concepts/tasks.adoc b/src/main/asciidoc/reference-guide/concepts/tasks.adoc index 5d265251f4..78b07d96a9 100644 --- a/src/main/asciidoc/reference-guide/concepts/tasks.adoc +++ b/src/main/asciidoc/reference-guide/concepts/tasks.adoc @@ -101,7 +101,7 @@ When defining a pull task, the following information must be provided: * <<pull-templates,entity templates>> * scheduling information: ** when to start -** https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron expression^] +** https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron expression^] [NOTE] ==== @@ -189,7 +189,7 @@ When defining a push task, the following information must be provided: * optional <<pushactions,push action(s)>> * scheduling information: ** when to start -** https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron expression^] +** https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron expression^] [NOTE] ==== @@ -258,7 +258,7 @@ When defining a macro task, the following information must be provided: list, update or execute the given macro task * scheduling information: ** when to start -** https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron expression^] +** https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron expression^] ===== MacroActions @@ -510,7 +510,7 @@ endif::[] providing the custom logic to execute * scheduling information: ** when to start -** https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron expression^] +** https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron expression^] [TIP] ==== diff --git a/src/main/asciidoc/reference-guide/concepts/typemanagement.adoc b/src/main/asciidoc/reference-guide/concepts/typemanagement.adoc index 426e571092..4b86130953 100644 --- a/src/main/asciidoc/reference-guide/concepts/typemanagement.adoc +++ b/src/main/asciidoc/reference-guide/concepts/typemanagement.adoc @@ -47,7 +47,7 @@ https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/text/DateForma ** `Dropdown` - allows to specify an <<implementations,implementation>> which will dynamically return the value(s) that can be selected ** `Encrypted` -*** secret key (stored or referenced as https://docs.spring.io/spring-framework/reference/6.2/core/beans/environment.html#beans-using-propertysource[Spring property^]) +*** secret key (stored or referenced as https://docs.spring.io/spring-framework/reference/7.0/core/beans/environment.html#beans-using-propertysource[Spring property^]) *** cipher algorithm *** whether transparent encryption is to be enabled, e.g. attribute values are stored as encrypted but available as cleartext on-demand (requires AES ciphering) diff --git a/src/main/asciidoc/reference-guide/configuration/configurationparameters.adoc b/src/main/asciidoc/reference-guide/configuration/configurationparameters.adoc index bfb339bdb2..b4f9d80046 100644 --- a/src/main/asciidoc/reference-guide/configuration/configurationparameters.adoc +++ b/src/main/asciidoc/reference-guide/configuration/configurationparameters.adoc @@ -38,7 +38,7 @@ behaviors at runtime, expecially with high-availability. * `jwt.lifetime.minutes` - validity of https://en.wikipedia.org/wiki/JSON_Web_Token[JSON Web Token^] values used for <<rest-authentication-and-authorization,authentication>> (in minutes); * `notificationjob.cronExpression` - -https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron^] expression describing how +https://docs.spring.io/spring-framework/reference/7.0/integration/scheduling.html#scheduling-cron-expression[cron^] expression describing how frequently the pending <<tasks-notification,notification tasks>> are processed: empty means disabled; [NOTE] Restarting the deployment is required when changing value for this parameter. diff --git a/src/main/asciidoc/reference-guide/configuration/dbms.adoc b/src/main/asciidoc/reference-guide/configuration/dbms.adoc index d1eaf1f812..f9a1ad7c00 100644 --- a/src/main/asciidoc/reference-guide/configuration/dbms.adoc +++ b/src/main/asciidoc/reference-guide/configuration/dbms.adoc @@ -40,7 +40,7 @@ persistence.domain[0].poolMinIdle=5 as `core/src/main/resources/core-postgresql.properties`. Do not forget to include `postgresql` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. [WARNING] @@ -73,7 +73,7 @@ persistence.domain[0].poolMinIdle=5 as `core/src/main/resources/core-mysql.properties`. Do not forget to include `mysql` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. [CAUTION] @@ -109,7 +109,7 @@ persistence.domain[0].poolMinIdle=5 as `core/src/main/resources/core-mariadb.properties`. Do not forget to include `mariadb` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. [CAUTION] @@ -157,7 +157,7 @@ persistence.domain[0].poolMinIdle=5 as `core/src/main/resources/core-oracle.properties`. Do not forget to include `oracle` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. [WARNING] diff --git a/src/main/asciidoc/reference-guide/configuration/deployment.adoc b/src/main/asciidoc/reference-guide/configuration/deployment.adoc index 6e2068c139..4588c0833d 100644 --- a/src/main/asciidoc/reference-guide/configuration/deployment.adoc +++ b/src/main/asciidoc/reference-guide/configuration/deployment.adoc @@ -24,7 +24,7 @@ Jakarta EE containers. [WARNING] The only exception is <<secure-remote-access>> that, being based on Spring Cloud Gateway - which in turn is built on -https://docs.spring.io/spring-framework/reference/6.2/web-reactive.html[Spring WebFlux^] and +https://docs.spring.io/spring-framework/reference/7.0/web-reactive.html[Spring WebFlux^] and https://projectreactor.io/docs[Project Reactor^], is only available as standalone application. [CAUTION] @@ -51,10 +51,10 @@ applications as standalone fat JAR or WAR files. [TIP] Spring Boot applications can also be -https://docs.spring.io/spring-boot/3.4/how-to/deployment/installing.html[installed as system services^]. +https://docs.spring.io/spring-boot/3.5/how-to/deployment/installing.html[installed as system services^]. [TIP] -https://docs.spring.io/spring-boot/3.4/reference/features/spring-application.html#features.spring-application.virtual-threads[Virtual Threads^] can be enabled but JDK >= 24 is required in order to run properly. +https://docs.spring.io/spring-boot/3.5/reference/features/spring-application.html#features.spring-application.virtual-threads[Virtual Threads^] can be enabled but JDK >= 24 is required in order to run properly. .Run Core application as standalone under GNU / Linux ==== @@ -74,7 +74,7 @@ $ java -Dsyncope.conf.dir=/opt/syncope/conf \ -jar /opt/syncope/lib/syncope.war ---- Further options can be passed to last command, according to Spring Boot -https://docs.spring.io/spring-boot/3.4/appendix/application-properties/index.html[documentation^]; +https://docs.spring.io/spring-boot/3.5/appendix/application-properties/index.html[documentation^]; for example: * `--spring.config.additional-location=/path` + @@ -300,7 +300,7 @@ javadocPaths=/WEB-INF/lib/syncope-common-idrepo-rest-api-${syncope.version}-java as `core/src/main/resources/core-wildfly.properties`. Do not forget to include `widlfly` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html[Spring Boot profile^] for the Core application. [WARNING] diff --git a/src/main/asciidoc/reference-guide/usage/actuator.adoc b/src/main/asciidoc/reference-guide/usage/actuator.adoc index c89a271d60..e618df0e66 100644 --- a/src/main/asciidoc/reference-guide/usage/actuator.adoc +++ b/src/main/asciidoc/reference-guide/usage/actuator.adoc @@ -23,7 +23,7 @@ Spring Boot's actuator endpoints let you monitor and interact with Syncope compo Each individual endpoint can be enabled / disabled and exposed over HTTP (pre-defined, under the `/actuator` subcontext) or JMX. -Besides a number of https://docs.spring.io/spring-boot/3.4/reference/actuator/endpoints.html[built-in endpoints^], +Besides a number of https://docs.spring.io/spring-boot/3.5/reference/actuator/endpoints.html[built-in endpoints^], more are made available for each component, as reported below. [NOTE] diff --git a/src/main/asciidoc/reference-guide/usage/core.adoc b/src/main/asciidoc/reference-guide/usage/core.adoc index 5916fc4d58..fb3b3a944a 100644 --- a/src/main/asciidoc/reference-guide/usage/core.adoc +++ b/src/main/asciidoc/reference-guide/usage/core.adoc @@ -98,7 +98,7 @@ The set of RESTful services provided by Apache Syncope can be divided as: . endpoints disclosing information about the given Syncope deployment (available <<schema,schema>>, configured <<extensions,extensions>>, Groups, ...), requiring some sort of shared authentication defined by the `anonymousKey` value in the `security.properties` file - for more information, read about Spring Security's -https://docs.spring.io/spring-security/reference/6.4/servlet/authentication/anonymous.html#page-title[Anonymous Authentication^]; +https://docs.spring.io/spring-security/reference/6.5/servlet/authentication/anonymous.html#page-title[Anonymous Authentication^]; . endpoints for self-service (self-update, password change, ...), requiring user authentication and no entitlements; . endpoints for administrative operations, requiring user authentication with authorization granted by the related <<entitlements,entitlements>>, handed over to users via <<roles,roles>>. diff --git a/src/main/asciidoc/reference-guide/usage/customization.adoc b/src/main/asciidoc/reference-guide/usage/customization.adoc index e188494e98..43dcb17b3c 100644 --- a/src/main/asciidoc/reference-guide/usage/customization.adoc +++ b/src/main/asciidoc/reference-guide/usage/customization.adoc @@ -155,7 +155,7 @@ endif::[] ===== Extending configuration Apache Syncope <<architecture,components>> are built on https://spring.io/projects/spring-boot[Spring Boot^], hence designing and extending Syncope configuration very much comes down to -https://docs.spring.io/spring-boot/3.4/index.html[their guide^], some aspects of which are briefly +https://docs.spring.io/spring-boot/3.5/index.html[their guide^], some aspects of which are briefly highlighted here. To design your own configuration class, take inspiration from the following sample: @@ -236,7 +236,7 @@ $ mkdir /opt/syncope/conf [TIP] ==== The `conf` directory must be configured for deployment, following Spring Boot's -https://docs.spring.io/spring-boot/3.4/reference/features/external-config.html[Externalized Configuration^] +https://docs.spring.io/spring-boot/3.5/reference/features/external-config.html[Externalized Configuration^] settings; with above reference: * <<standalone>>: `--spring.config.additional-location=/opt/syncope/conf/` @@ -383,7 +383,7 @@ elasticsearch.numberOfReplicas=1 as `core/src/main/resources/core-elasticsearch.properties`. Do not forget to include `elasticsearch` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html[Spring Boot profile^] for the Core application. If needed, customize the `@Bean` declarations from @@ -436,7 +436,7 @@ opensearch.numberOfReplicas=1 as `core/src/main/resources/core-opensearch.properties`. Do not forget to include `opensearch` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. If needed, customize the `@Bean` declarations from @@ -508,7 +508,7 @@ endif::[] . Do not forget to include `openfga` as -https://docs.spring.io/spring-boot/3.4/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] +https://docs.spring.io/spring-boot/3.5/reference/features/profiles.html#features.profiles.adding-active-profiles[Spring Boot profile^] for the Core application. If needed, customize the `@Bean` declarations from diff --git a/src/main/asciidoc/reference-guide/usage/loggers.adoc b/src/main/asciidoc/reference-guide/usage/loggers.adoc index fd96f23c90..60ca82e74c 100644 --- a/src/main/asciidoc/reference-guide/usage/loggers.adoc +++ b/src/main/asciidoc/reference-guide/usage/loggers.adoc @@ -19,7 +19,7 @@ === Loggers Spring Boot actuator includes the ability to -https://docs.spring.io/spring-boot/3.4/reference/actuator/loggers.html[view and configure the log levels^] of all +https://docs.spring.io/spring-boot/3.5/reference/actuator/loggers.html[view and configure the log levels^] of all Syncope modules at runtime. In addition, Console provides a UI to view the list of logger’s configuration and set their level, for all diff --git a/src/main/asciidoc/reference-guide/usage/metrics.adoc b/src/main/asciidoc/reference-guide/usage/metrics.adoc index 98a697acbe..a146254d52 100644 --- a/src/main/asciidoc/reference-guide/usage/metrics.adoc +++ b/src/main/asciidoc/reference-guide/usage/metrics.adoc @@ -19,7 +19,7 @@ === Metrics Monitoring performance to ensure reliability and efficiency can be achieved by leveraging -https://docs.spring.io/spring-boot/3.4/reference/actuator/metrics.html[Spring Boot's metrics^]. +https://docs.spring.io/spring-boot/3.5/reference/actuator/metrics.html[Spring Boot's metrics^]. [[metrics-core]] ==== Core @@ -36,7 +36,7 @@ This can be enabled by adding the following dependency to `core/pom.xml`: ---- Additional dependencies might be required, depending on the -https://docs.spring.io/spring-boot/3.4/reference/actuator/metrics.html#actuator.metrics.export[actual monitoring system in use^]. +https://docs.spring.io/spring-boot/3.5/reference/actuator/metrics.html#actuator.metrics.export[actual monitoring system in use^]. [[metrics-wa]] ==== WA
