Skip to content

Commit 46c044f

Browse files
Merge pull request mendix#10991 from mendix/kv-oidc-updates-4041
OIDC SSO-4.4.0 updates
2 parents 1e1e440 + 009c2e2 commit 46c044f

1 file changed

Lines changed: 9 additions & 5 deletions

File tree

  • content/en/docs/marketplace/platform-supported-content/modules

content/en/docs/marketplace/platform-supported-content/modules/oidc.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -128,9 +128,9 @@ The OIDC module requires your app to be using Mendix 9.0 or above.
128128

129129
It requires the following Marketplace modules to be included in your app:
130130

131-
* [Encryption](https://marketplace.mendix.com/link/component/1011) – see [Encryption](/appstore/modules/encryption/) documentation.
131+
* [Encryption](https://marketplace.mendix.com/link/component/1011) (for version 4.3.0 and below) – see [Encryption](/appstore/modules/encryption/) documentation.
132132
* [Community Commons](https://marketplace.mendix.com/link/component/170) – see [Community Commons](/appstore/modules/community-commons-function-library/) documentation.
133-
* [Nanoflow Commons](https://marketplace.mendix.com/link/component/109515) – see [Nanoflow Commons](/appstore/modules/nanoflow-commons/) documentation.
133+
* [Nanoflow Commons](https://marketplace.mendix.com/link/component/109515) (for version 4.3.0 and below) – see [Nanoflow Commons](/appstore/modules/nanoflow-commons/) documentation.
134134
* [User Commons](https://marketplace.mendix.com/link/component/223053) (for version 3.0.0 and above)
135135

136136
{{% alert color="warning" %}}
@@ -205,8 +205,8 @@ This section provides an overview of updates for the OIDC SSO module across diff
205205

206206
| Mendix Version | OIDC SSO Module Version | Important Migration Changes | Additional Information |
207207
| --- | --- | --- | --- |
208-
| 10.24.0 and above | 4.4.0 | - | **Issued Tokens** tab has been removed from the OIDC Client Configuration page. |
209-
| 10.24.0 and above | 4.3.0 | - | Supporting multi-domain and sub-path |
208+
| 10.24.0 and above | 4.4.0 | Move the `Encryption.Encryptionkey` value to the `OIDC.Encryptionkey` constant. | Dependencies on the Encryption and Nanoflow Commons modules have been removed. <br> **Issued Tokens** tab has been removed from the OIDC Client Configuration page. |
209+
| 10.24.0 and above | 4.3.0 | - | Supporting multi-domain and sub-path. |
210210
| 10.24.0 and above | 4.2.1 | In version 4.2.1, automatic migration of the UserCommons has been removed. | Since migration steps were removed in 4.2.1, you must upgrade to OIDC SSO version 4.2.0 first to prevent data loss. This applies to the UserCommons, if you are migrating from any version below 3.0.0, always upgrade to 4.2.0 first, then move to the latest v4.2.1. |
211211
| 10.21.01 and above | 4.2.0 | In version 4.2.0, the module no longer automatically executes the UserCommons migration in the startup microflow. The migration step has been moved to a dedicated microflow, which you can trigger via a widget. | The `ASU_STARTUP` microflow has been moved under the **USE_ME** folder. |
212212
| 10.12.10 and above | 4.0.0 | Set `OIDC.ASU_OIDC_Startup` microflow as part of the after-startup microflow | From UserCommons 2.0.0, new users without IdP-specified time zone or language will use default App settings; existing users retain their previously set values. |
@@ -264,7 +264,11 @@ Admins can view their own token using a snippet in their custom page. They can f
264264

265265
### Setting Encryption Key
266266

267-
Follow the instructions to [set an encryption key in the Encryption module](/appstore/modules/encryption/#configuration). The constant to set is called `Encryption.EncryptionKey` and should be a random value 32 characters long. This key will be used to encrypt and decrypt values.
267+
Follow the instructions to [set an encryption key in the Encryption module](/appstore/modules/encryption/#configuration). For OIDC SSO V4.3.0 and below, set a constant called `Encryption.EncryptionKey` and assign it a random value 32-character value. Starting from version 4.4.0, set the encryption key in the `OIDC.Encryptionkey` constant using a random 32-character value. This key will be used to encrypt and decrypt values.
268+
269+
{{% alert color="info" %}}
270+
While upgrading from V4.3.0 to V4.4.0 or above, ensure that any value currently stored in the `Encryption.Encryptionkey` is moved to the `OIDC.Encryptionkey` constant, otherwise, existing IdP client authentication will fail.
271+
{{% /alert %}}
268272

269273
## IdP Configuration {#idpconfiguration}
270274

0 commit comments

Comments
 (0)