Basics
Data protection
Information security
App Customization & Deployment
Mobile App Deployment & Distribution
Analytics
Project management
Miscellaneous
Languages
OpenID Connect (OIDC) is a simple identity layer on top of the OAuth 2.0 protocol. It allows tchop to verify the identity of a user based on the authentication performed by an authorization server and obtain basic profile information about the user in an interoperable and REST-like manner. It uses security tokens containing assertions to pass information about a user between the following:
This section demonstrates how to create an OIDC SSO application integration between Azure Active Directory and your tchop environment. Steps in this section take place on the Azure Active Directory platform. These instructions are for example purposes only and may not reflect the current Azure Active Directory or your identity provider UI. Refer to the your identity provider documentation for instructions.
➡️
You must have an active Azure Active Directory account populated with user names.
To configure the integration for tchop:
Click Add a Redirect URI.
Under Platform configurations, click Add a platform.
Select Web.
Enter the following Redirect URI:
Sign-in redirect URIs:
For WebApp: Enter https://[ORGANISATION].[DOMAIN] /webapp/auth/login.
For example: https://meganews.tchop.io/webapp/auth/login
For Mobile Apps:
<android_bundle_id>://login-callback<android_bundle_id>://oidc/login-callback<iOS_bundle_id>://login-callbackSign-out redirect URIs (Only required for Mobile App):
➡️
[ORGANISATION].[DOMAIN] /webapp/auth/login[CHANNEL1-ORGANISATION].[DOMAIN] /webapp/auth/login[CHANNEL2-ORGANISATION].[DOMAIN] /webapp/auth/login[CHANNEL3-ORGANISATION].[DOMAIN] /webapp/auth/login⚠️
Please check: Some OIDC providers support wildcard on the redirect url eg https://.tchop.it/webapp/auth/login, so we don’t need hardcode all possible combination of subdomains. Just add “https://.tchop.it/webapp/auth/login” to the redirect URL
.
➡️
The proper format of the Issuer URL is https://login.microsoftonline.com/{tenant_id}/v2.0. You will find the tenant_id in Azure AD (Microsoft Entra ID) → Default Directory → Overview.
Now, you are ready to create an OIDC service provider on the tchop server. Refer to the section “Creating an OIDC service provider” for details.