Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -231,34 +231,38 @@ Ensure that you have allocated the following user roles to the OIDC module and U
| User Role | OIDC Module Role |
| --- | --- |
| Administrator | OIDC.Administrator, UserCommons.Administrator |
| Anonymous | OIDC.Anonymous (for multiple IdPs only) |
| Anonymous | OIDC.Anonymous (optional) |
| User | OIDC.User |

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

### User Roles for Single IdP
### Allowing Anonymous User Role

#### User Roles for Single IdP

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.

### Allowing Anonymous Users for Multiple IdPs (Optional)
#### Allowing Anonymous Users for Multiple IdPs (Optional)

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.

{{< figure src="/attachments/appstore/platform-supported-content/modules/oidc/user-roles-anonymous.png" class="no-border" >}}

In the **Anonymous** tab of the app security settings, do the following:

1. Set **Allow anonymous users** to **Yes**
2. Select *Anonymous* as the **Anonymous user role**

{{< figure src="/attachments/appstore/platform-supported-content/modules/oidc/anonymous-user.png" class="no-border" >}}

{{% alert color="info" %}}
For multiple IdPs, you may have to add the *Anonymous* user role if it does not exist already.
{{% /alert %}}

{{% alert color="warning" %}}
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.
{{% /alert %}}

### Excluding Anonymous User Role

If you do not want to enable anonymous user, you can use single or multiple IdPs using the login endpoint `oauth/v2/login`, and you will be landed on the IdP's login page.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Meanwhile I learned and I think we can say:

We recommend to to not enable an anonymous userole.
Also in case of multiple IdPs, anonymous users are not needed. You can use a high-code non-mendix page to make the user select an IdP for login, which doesn't require anonymous userrole.
You can find a sample page here: .

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So with muliple IdPs we have 2 options:

  • using the dedicated endpoint
  • using an IdP-selection page (high code)
    (-using a Mendix page for IdP selection - not recommended because it requires anonymous users).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, these are very valid ( test comment )


### Configuring Navigation{#configure-nav}

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*.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.