4.20.6 Edit identity provider configuration
Among other things, you can
activate/deactivate an identity provider configuration,update the data for the connection to the identity provider,Entra ID only
Check connection status,create a new Swyx user based on a federated identity,cancel the assignment of the Swyx user to the federated identity,Activate/deactivate contact, calendar and Teams synchronization.You can track the configuration changes under the Maintenance | Federated services log list, see Protocols | Federated services protocol.
To edit identity provider configurations
The general settings of an identity provider appear.|
Label
|
Explanation
|
|---|---|
|
Activated
|
Clear the checkbox if you do not want to use federated services or if you want to activate a different identity provider configuration.
|
|
Name
|
Name the configuration with a unique name. The name of the configuration is displayed to the user in the client login dialog box.
|
|
Application (client) ID,
Directory (tenant) ID
Document metadata
|
Edit the details as described here 4.20.3 Create identity provider configuration
|
|
Entra ID only
|
|
|
Connection status
|
Check Installation
The credentials for the connection to the identity provider are valid.
Invalid
The connection to the identity provider has been interrupted.
You must update the credentials, see 4.20.5 Change login data for Entra ID
|
|
Action to be performed when the Entra ID identity is removed
|
None
The assigned Swyx user is retained in any case.
(default setting when updating the Swyx)
Remove Swyx user if not an admin
If the Entra ID identity is deleted, the assigned Swyx user is also deleted. Unless he/she is an administrator.
Remove Swyx user
If the Entra ID identity is deleted, the associated Swyx user is also deleted. This also applies if the user is an administrator.
(default setting for the new installation of Swyx)
|
|
Activate synchronization for display names
|
Activate the checkbox if the display names of Swyx users should be updated automatically: The display names are adapted to the display names in the identity provider's user account.
This function is activated by default in a new Swyx installation.
This function is deactivated by default for an existing Swyx configuration.
Note that the user can use the display name to log on to Swyx clients.
|
Note the expiration date of the certificate for Entra ID. If the certificate is no longer valid, the connection to Entra ID is interrupted. You must generate a new certificate in Swyx Control Center and upload it to the Azure Portal, see 4.20.5 Change login data for Entra ID.
|
Label
|
Explanation
|
|---|---|
|
Login data type
|
Type of login data for the connection to Entra ID. Client Secret or Certificate.
|
|
Download certificate
|
If you use the "Certificate" credential type, you must upload the certificate generated in the Swyx Control Center to the Microsoft Azure Portal, see 4.20.5 Change login data for Entra ID.
Click on the button to download the certificate.
|
|
Certificate fingerprint
|
Digital thumbprint of the certificate for Entra ID.
|
|
Expiration date of the certificate
|
The time and date when the validity of the certificate expires. You must update the certificate before the expiration date.
|
The list of Entra ID identities appears. |
Label
|
Explanation
|
|---|---|
|
Name
|
The display name of the Entra ID federated identity.
|
|
UPN
|
User Principal Name of the Entra ID federated identity.
For a successful assignment, the e-mail address of the Swyx user must correspond to the UPN.
|
|
Swyx User
|
The Entra ID federated identity is assigned to the Swyx user.
 The Entra ID federated identity is not yet assigned to a Swyx user. |
|
(edit)
|
In the line of an assigned federated identity, click on to remove an assignment that is no longer correct, for example.
You will be redirected to the Edit user dialog ( Entra ID tab), see 9.17 Update Entra ID assignment.
|
|
(create)
|
Click on to create a new Swyx user with the data of this Entra ID.
You will be redirected to the create user configuration wizard, see 9.3 Creating Users.
The assigned Entra ID identity then appears in the list of identities marked with .
|
You can also assign an existing Swyx user to an Entra ID identity. Make sure that the e-mail address of the Swyx user corresponds to the desired Entra ID and click on to select the Entra ID identity from the list of unassigned identities, see 9.4 Editing Users’ general settings.
You can edit the assignment of multiple users using the Swyx PowerShell module.
|
Label
|
Explanation
|
|---|---|
|
Authentication
|
Activate the option to enable federated authentication via the Entra ID.
|
|
Contact Synchronization
|
Activate the option to enable contact synchronization via the Entra ID.
|
|
Calendar Synchronization
|
Activate the option to enable calendar synchronization via the Entra ID.
|
|
Teams Presence Synchronization
|
Activate the option to enable the presence status via the Entra ID, see 4.22 Defining expert settings
|
|
Teams Presence Synchronization
|
Teams to Swyx
Synchronization only Microsoft Teams presence status towards Swyx. (default setting)
Bidirectional
Select the option to additionally forward the Swyx status "Speaking" to Microsoft Teams.
|
|
Last access
|
The date and time of the last status request from Microsoft Teams.
|
|
Last status message
|
Last message from the teams presence service:
Presence sync started
Teams Presence Synchronization is activ
Presence sync is disabled by configuration
Teams Presence Synchronization
|