diff --git a/website/content/docs/updates/important-changes.mdx b/website/content/docs/updates/important-changes.mdx index 610d4043b9..32298034c5 100644 --- a/website/content/docs/updates/important-changes.mdx +++ b/website/content/docs/updates/important-changes.mdx @@ -15,7 +15,7 @@ valid_change_types: >- # Important changes -**Last updated**: 2025-06-20 +**Last updated**: 2025-06-30 Always review important or breaking changes and remediation recommendations before upgrading Vault. @@ -147,6 +147,27 @@ None. ## Known issues +### UI login fails for auth mounts with underscores and unauthenticated listing ((#ui-login-underscore)) + +| Change | Affected version | Fixed version +| ------------ | ---------------- | -------------------- +| Known issue | 1.20.0 | 1.20.1 + +Login requests to auth methods mounted at paths using underscores (e.g. `oidc_test`) +with `listing_visibility="unauth"` fail because the GUI calls the wrong +endpoint. Mounts with dashes (e.g. `oidc-test`) work correctly. + +#### Recommendation + +As a workaround, you can log in to the GUI using the following steps: + +1. Navigate directly to the URL for the desired method type (e.g. `${VAULT_ADDR}/ui/vault/auth?with=oidc`) +1. Click "Sign in with other methods ->" +1. Select the method type from the dropdown +1. Click **Advanced settings** and provide the correct path (e.g., `oidc_test`). + +We also recommend creating a [custom GUI message](/vault/docs/ui/custom-message) describing the workaround steps for users. + ### Duplicate unseal/seal wrap HSM keys ((#hsm-keys)) | Change | Status | Affected version | Fixed version diff --git a/website/content/partials/release-notes/change-summary/1_20.mdx b/website/content/partials/release-notes/change-summary/1_20.mdx index 15c174aaba..59b838f454 100644 --- a/website/content/partials/release-notes/change-summary/1_20.mdx +++ b/website/content/partials/release-notes/change-summary/1_20.mdx @@ -11,3 +11,4 @@ Found | Fixed | Workaround | Edition | Issue ------ |------- | ---------- | ---------- | ----- 1.20.0 | No | **Yes** | All | [Duplicate unseal/seal wrap HSM keys](/vault/docs/v1.20.x/updates/important-changes#hsm-keys) 1.20.0 | No | **Yes** | Enterprise | [Development cluster setting overwritten on secondary cluster reload](/vault/docs/v1.20.x/updates/important-changes#development-cluster-reload) +1.20.0 | No | **Yes** | All | [UI login fails for auth mounts with underscores and unauthenticated listing](/vault/docs/v1.20.x/updates/important-changes#ui-login-underscore)