Skip to content

Commit a2f251e

Browse files
committed
Proofread
1 parent 0b69355 commit a2f251e

File tree

1 file changed

+17
-0
lines changed
  • content/en/docs/appstore/use-content/platform-supported-content/modules

1 file changed

+17
-0
lines changed

content/en/docs/appstore/use-content/platform-supported-content/modules/oidc.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -899,12 +899,29 @@ Page URLs and Microflow URLs are supported with OIDC SSO for Mendix version 10.6
899899
3. The user is redirected to the OIDC login page for authentication.
900900
4. After successful log in, the user is directed to the desired page using page URLs and microflow URLs within the application.
901901

902+
If you are building a new app using the OIDC SSO module (Mendix version 10.6 and above) and you are using Page URLs and Microflow URLs, follow the same steps as above.
903+
902904
The Page and Microflow URLs fully support multiple IdPs, allowing users to trigger the login and choose the IdP on the OIDC login page.
903905
For more information, see the [Migrating to Page and Microflow URLs](/appstore/modules/deep-link/#migrate-page-micro) section of the *Deep Link*.
904906

905907
Starting from Studio Pro 10.9.0, you can use the primitive parameters as **Query string** parameters in microflows. Check the checkbox in the parameter table to configure a microflow parameter to use as a **Query string** parameter.
906908
For more information, see the [URL](/refguide/microflow/#url) section of the *Microflow Properties*.
907909

910+
##### Steps for OIDC SSO Version v4.1.0 and above
911+
912+
In OIDC SSO version 4.1.0 and above, you do not have to enable anonymous users.
913+
914+
You can disable this setting by navigating to **Security > Anonymous users** and setting **Allow anonymous users** to **No**.
915+
916+
1. To use the Page URL functionality, replace the content of `login.html` with the content of `login-with-mendixsso-automatically.html` (located in the `resources\mendixsso\templates` folder) and save it as `login.html`.
917+
918+
2. To implement the SSO redirection, replace the code in the `<script>` tag of your login page (for example, `login.html`) with one of the following pieces of code, depending on whether you want automatic or manual redirection:
919+
920+
* For automatic redirection, use `window.onload` to automatically redirect users to the SSO login page. `const returnURL = encodeURIComponent(window.location.search+window.location.hash);` `self.location = '/oauth/v2/login?cont='+returnURL;`
921+
* For manual redirection: add an onclick event to the button that manually triggers the SSO login. `window.location.href='/oauth/v2/login?cont=' + encodeURIComponent(window.location.search + window.location.hash);`
922+
923+
Once the above changes are applied, end users can directly navigate to the desired page. If not logged in, they will be redirected to the IdP login page for authentication. After successful log in, they will be directed to the desired page using page and microflow URLs.
924+
908925
#### Using Deep Link Module{#using-deep-link}
909926

910927
{{% alert color="warning" %}}

0 commit comments

Comments
 (0)