From 915a4768889db081bdce5aadc54eae92b9b60529 Mon Sep 17 00:00:00 2001 From: bramvonk Date: Tue, 18 Nov 2025 18:38:52 +0100 Subject: [PATCH 1/2] Add missing ui.oauth.scopes, first copy documentation from swagger-ui documentation... The implementation is here: https://github.com/springdoc/springdoc-openapi/blob/main/springdoc-openapi-starter-common/src/main/java/org/springdoc/core/properties/SwaggerUiOAuthProperties.java#L103 --- src/docs/asciidoc/ui-properties.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/src/docs/asciidoc/ui-properties.adoc b/src/docs/asciidoc/ui-properties.adoc index ecce440..480125d 100644 --- a/src/docs/asciidoc/ui-properties.adoc +++ b/src/docs/asciidoc/ui-properties.adoc @@ -36,6 +36,7 @@ |springdoc.swagger-ui.oauth.realm | | `String`. realm query parameter (for OAuth 1) added to authorizationUrl and tokenUrl. |springdoc.swagger-ui.oauth.appName | | `String`. OAuth application name, displayed in authorization popup. |springdoc.swagger-ui.oauth.scopeSeparator | | `String`. OAuth scope separator for passing scopes, encoded before calling, default value is a space (encoded value %20). +|springdoc.swagger-ui.oauth.scopes | | string array or scope separator (i.e. space) separated string of initially selected oauth scopes, default is empty array |springdoc.swagger-ui.csrf.enabled | `false` | `Boolean`. To enable CSRF support |springdoc.swagger-ui.csrf.use-local-storage | `false` | `Boolean`. To get the CSRF token from the Local Storage. |springdoc.swagger-ui.csrf.use-session-storage | `false` | `Boolean`. To get the CSRF token from the Session Storage. From 5328cd02a153487e0510d8b367c171fd8e439ca4 Mon Sep 17 00:00:00 2001 From: bramvonk Date: Tue, 18 Nov 2025 18:41:02 +0100 Subject: [PATCH 2/2] Adapt the documentation to springdoc This is the best I could do :) --- src/docs/asciidoc/ui-properties.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/asciidoc/ui-properties.adoc b/src/docs/asciidoc/ui-properties.adoc index 480125d..8ba76ce 100644 --- a/src/docs/asciidoc/ui-properties.adoc +++ b/src/docs/asciidoc/ui-properties.adoc @@ -36,7 +36,7 @@ |springdoc.swagger-ui.oauth.realm | | `String`. realm query parameter (for OAuth 1) added to authorizationUrl and tokenUrl. |springdoc.swagger-ui.oauth.appName | | `String`. OAuth application name, displayed in authorization popup. |springdoc.swagger-ui.oauth.scopeSeparator | | `String`. OAuth scope separator for passing scopes, encoded before calling, default value is a space (encoded value %20). -|springdoc.swagger-ui.oauth.scopes | | string array or scope separator (i.e. space) separated string of initially selected oauth scopes, default is empty array +|springdoc.swagger-ui.oauth.scopes | | `List of Strings`. List of Strings or scope separator (i.e. space) separated string of initially selected oauth scopes, default is empty array. |springdoc.swagger-ui.csrf.enabled | `false` | `Boolean`. To enable CSRF support |springdoc.swagger-ui.csrf.use-local-storage | `false` | `Boolean`. To get the CSRF token from the Local Storage. |springdoc.swagger-ui.csrf.use-session-storage | `false` | `Boolean`. To get the CSRF token from the Session Storage.