Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

Info

You can connect an Identity Provider (IdP) like Microsoft Azure AD to your instance.

Note

It is recommended to create a new application in the Azure portal for V4 application login.

Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

...

Overview

ConnectSecure supports the following providers.

...

Getting Started

Note

If a user already exists in Zitadel and is linked to Microsoft SSO, they may still be prompted for Zitadel TOTP MFA when logging in via the ConnectSecure portal. To address this, there are two methods available:

Disable Force MFA in Zitadel Settings: Disabling Force MFA in Zitadel settings will prevent the prompt for TOTP MFA. However, please note that after disabling this setting, normal local users will not be prompted for TOTP MFA either.

Remove the user from Zitadel and Reconfigure with SSO: Another approach is to remove the user from Zitadel and then configure them again with SSO. By doing so, the user should no longer be prompted for Zitadel TOTP MFA during login.

To set up an Authentication Provider, log in at https://authprod.myconnectsecure.com and complete these steps:

  1. Click on the Settings header at the top

  2. Click on the Identity Providers section on the left

  3. Tap on the tile of the provider

...

Providers

Each provider has unique values and integration requirements. Please check out the setup guide for the individual provider(s) as required.

Microsoft

Microsoft Azure AD Configuration

Register a new client

  1. Browse to the App app registration menus and create a dialog to create a new app.

  2. Give the application a name and choose who should be able to login can log in (Single-Tenant, Multi-Tenant, Personal Accounts, etc.). This setting will also have an impact on how to configure the provider is configured later on in ZITADEL.

  3. Choose "Web" in the redirect uri URI field and add the URL:

  1. Save the Application (client) ID and the Directory (tenant) ID from the detail page separately as these needs need to be copied into the ConnectSecure portal.

    image-20240111-102931.pngimage-20240111-103345.png

     

Add client secret

...

  1. Click on client credentials on the detail page of the application or use the menu "Certificates & secrets"

  2. Click on "+ New client secret," and enter a description and an expiry date, add the secret afterwardsafterward

  3. Copy the value of the secret. You will not be able to see the value again after some time

...

To allow ZITADEL to get the information from the authenticating user, you have to configure what kind of optional claims should be returned in the token.

...

  1. Go to "API permissions" in the side menu

  2. Make sure Ensure the permissions include "Microsoft Graph": email, profile, and User. Read

  3. The "Other permissions granted" should include "Microsoft Graph: openid"

...

To Add an Identity Provider in Your ConnectSecure Instance.

  1. Login to the ConnectSecure portal and Click on Profile.

...

  • Click on the Company Logo.

...

  • Navigate to the Settings.

  • Modify your login policy in the menu Login Behavior and Security.

  • Enable the attribute External IDP allowed.

    image-20240111-111706.png

Go to the Identity Providers Overview

Go to the Settings page of your instance or organization and choose "Identity Providers.".

In the table, you can see all the providers you have configured. Also, you will see all provider templates that are available to be configured.

...

  • The Microsoft template has everything you need preconfigured. You only have to add the client ID and secret, you have created in the previous step before.

  • You can configure the following settings if you like, ; a useful default will be filled if you don't change anything:

...

  • Once the details are filled in and options are selected, click on Create.

...

  • Under the Identity Provider table, select the created record and Click on set as available.

...

  • This completes setting up and adding Microsoft Azure AD Provider.

ConnectSecure portal

...

login using Microsoft

  • Login to the ConnectSecure Portal and enter the Tenant Name.

  • Click on Use External Authentication to login log in to the portal.

...

  • Provide all the fields (Give Name, FamilyName, Username, E.mail, Phone number, Language) and click on Register to create a user in the ConnectSecure portal.

...

  • Once the email address has been Successfully verified and The user will created with NO ROLE assigned to it. Admin should assign the Role as per the requirement.

  • The Admin user can assign the role to IDP so the user can login and access the ConnectSecure portal.

    image-20240111-123154.png

 

  • This completes the Microsoft Azure AD Authentication Providers SetupProvider Setup.

...

Get Support

If you have an integration-related inquiry, please email support@connectsecure.com with the details, and our Support Team will assist you.