6.5 Release preparations

Update redirect URL for SSO login

The Collaboard release 6.5 will include a major change for authentication.

We will be supporting authentication via the via standard OAuth 2.0 (PKCE) Flow, thus moving authentication from app-internal to app-external. Collaboard authentication will work like logging in to a Google or Microsoft account.

To facilitate a seamless transition we ask for your assistance.
During SSO sign in your SSO server redirects back to our app URL, and this URL has changed, because the login pages have changed to the new auth app supporting oauth2 PKCE.

What does it mean to you and what do you need to do?

If you are using SSO to login to Collaboard, we need you to add another redirect URL to your SSO app.

We will update your SSO configuration in Collaboard.

IMPORTANT
If you do not add the necessary redirect URL, your SSO login will fail with release 6.5!!!

Release dates

You need to add the required redirect URL by

Release on WEB: 28.08.2024
Release on CH: 28.08.2024
Release on DE: 02.09.2024
Release for on premise: CW 37

Adding the redirect URL

web.collaboard.app

Customers using OAuth SSO (ADFS, Google, Microsoft, Apple etc.)
need to add to their SSO app redirect URLs the following:
```
https://api.collaboard.app/auth/oauth2/externallogincallback/oauth
```
Customers using SAML SSO
need to add to their SSO app redirect URLs the following:
```
https://api.collaboard.app/auth/oauth2/externallogincallback/saml
```

ch.collaboard.app

Customers using OAuth SSO (ADFS, Google, Microsoft, Apple etc.)
need to add to their SSO app redirect URLs the following:
```
https://ch-api.collaboard.app/auth/oauth2/externallogincallback/oauth
```
Customers using SAML SSO
need to add to their SSO app redirect URLs the following:
```
https://ch-api.collaboard.app/auth/oauth2/externallogincallback/saml
```

de.collaboard.app

Customers using OAuth SSO (ADFS, Google, Microsoft, Apple etc.)
need to add to their SSO app redirect URLs the following:
```
https://de.collaboard.app/server/auth/oauth2/externallogincallback/oauth
```
Customers using SAML SSO
need to add to their SSO app redirect URLs the following:
```
https://de.collaboard.app/server/auth/oauth2/externallogincallback/saml
```

On premise customers

Please refer to the 6.5 release notes for further information. Essentially, you need to do the following:

Customers using OAuth SSO (ADFS, Google, Microsoft, Apple etc.)
need to add to their app redirect URLs the following:
```
<server_url>/auth/oauth2/externallogincallback/oauth
```

Customers using SAML SSO
need to add to their app redirect URLs the following:

<server_url>/auth/oauth2/externallogincallback/saml


Example:

https://collaboard-onprem-install.customer.com/server/auth/oauth2/externallogincallback/oauth

Troubleshooting and support

Please contact us for further assistance.