Skip to content

Commit 965d162

Browse files
committed
Additional changes
1 parent c8cd41a commit 965d162

1 file changed

Lines changed: 5 additions & 33 deletions

File tree

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

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

Lines changed: 5 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -231,52 +231,24 @@ Ensure that you have allocated the following user roles to the OIDC module and U
231231
| User Role | OIDC Module Role |
232232
| --- | --- |
233233
| Administrator | OIDC.Administrator, UserCommons.Administrator |
234-
| Anonymous | OIDC.Anonymous (optional) |
235234
| User | OIDC.User |
236235

237236
{{< figure src="/attachments/appstore/platform-supported-content/modules/oidc/user-roles.png" >}}
238237

239-
### Allowing Anonymous User Role
238+
### End User Login When Using Single or Multiple IdPs
240239

241-
#### User Roles for Single IdP
240+
If a single Identity Provider (IdP) is configured in the OIDC SSO module, end users can be authenticated via the URL `https://<your-app-url>/oauth/v2/login`. When accessing the URL, users are automatically redirected to the configured IdP for authentication.
242241

243-
If a single Identity Provider (IdP) is configured in the OIDC SSO module, end-users can be authenticated via the URL `https://<your-app-url>/oauth/v2/login` This means you do not need to configure the *Anonymous* user role for a single IdP.
242+
If multiple IdPs are configured in the OIDC module, end users can access the same URL (`<your-app-url>/oauth/v2/login`) to initiate authentication. In this case, they will first be redirected to an IdP selection page, where they can choose the IdP they want to use for authentication.
244243

245-
#### Allowing Anonymous Users for Multiple IdPs (Optional)
246-
247-
The OIDC module supports multiple OIDC/OAuth-compatible IdPs. Optionally, if you allow your end-users to choose from multiple IdPs, or to have the option to log back into the app after they have logged out, you will need to give them access to the app before they have signed in to the app. Therefore, you need to give anonymous users access to your app.
248-
249-
{{< figure src="/attachments/appstore/platform-supported-content/modules/oidc/user-roles-anonymous.png" class="no-border" >}}
250-
251-
In the **Anonymous** tab of the app security settings, do the following:
252-
253-
1. Set **Allow anonymous users** to **Yes**
254-
2. Select *Anonymous* as the **Anonymous user role**
255-
256-
{{< figure src="/attachments/appstore/platform-supported-content/modules/oidc/anonymous-user.png" class="no-border" >}}
257-
258-
{{% alert color="warning" %}}
259-
Enabling anonymous users introduces a broader attack surface. If you choose this option, follow Mendix guidelines for [setting up anonymous user security](/howto/security/set-up-anonymous-user-security/) to mitigate potential risks.
244+
{{% alert color="info" %}}
245+
In OIDC SSO version 4.1.0 and above, you do not have to enable anonymous users for multiple IdPs. You can remove the `Anonymous` User Role from the module.
260246
{{% /alert %}}
261247

262-
### Excluding Anonymous User Role
263-
264-
Mendix recommends not to enable anonymous userrole. You can use the login endpoint `oauth/v2/login` for a single IdP.
265-
For multiple IdPs, anonymous users are not needed.
266-
267-
You have the following options with multiple IdPs:
268-
269-
1. using the dedicated endpoint - `oauth/v2/login`
270-
2. using a high-code non-Mendix page to select an IdP for login.
271-
272-
Mendix does not recommend using a Mendix page for an IdP selection as it requires anonymous users.
273-
274248
### Configuring Navigation{#configure-nav}
275249

276250
The OIDC SSO module works without a specified sign-in page. Therefore, in the navigation section of your app, set **Sign-in page** (in the **Authentication** section) to *none*.
277251

278-
If you are configuring navigation for web/responsive apps and want to allow your end-users to choose from a number of different IdPs (multiple IdPs), or to have the option to sign in back into the app after they have signed out, set a **Role-based home page** for role **Anonymous** to **OIDC.Login_Web_Button**. When configuring navigation for PWA apps, set the **Role-based home page** for the **Anonymous** role to `OIDC.Login_PWA_Online_Button` for online apps and `Login_PWA_Offline_Button` for offline apps. See [Role-Based Home Pages](/refguide/navigation/#role-based) in *Navigation* for more information.
279-
280252
In addition, administrators will need to have access to configure OIDC and also manage end-users. You can do this by including the pages `Administration.Account_Overview` and `OIDC.OIDC_Client_Overview` into the app navigation, or a separate administration page.
281253

282254
If you are testing phone web and phone web offline locally, use the URLs `http://localhost:8080/?profile=Phone` and

0 commit comments

Comments
 (0)