help • 4 Editing General Settings • Federated services via identity providers • Edit identity provider configuration
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 SwyxWare user based on a federated identity,
*cancel the assignment of the SwyxWare 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
An identity provider is activated.
1 Select General settings | Federated Services in the menu.
*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 SwyxWare user is retained in any case.
(default setting when updating the SwyxWare)
 
Remove SwyxWare user if not an admin
If the Entra ID identity is deleted, the associated SwyxWare user is also deleted. Unless he/she is an administrator.
 
Remove SwyxWare user
If the Entra ID identity is deleted, the associated SwyxWare user is also deleted. This also applies if the user is an administrator.
(default setting for the new installation of SwyxWare)
Activate synchronization for display names
Activate the checkbox if the display names of SwyxWare 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 SwyxWare 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 SwyxWare Clients.
2 Click on Save.
3 Select the Credentials tab.
* 
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.
4 Select the Identities tab.
*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 SwyxWare user must correspond to the UPN.
SwyxWare user
The Entra ID federated identity is assigned to the SwyxWare user.
 
The Entra ID federated identity is not yet assigned to a SwyxWare 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.16 Update Entra ID assignment.
(create)
Click on to create a new SwyxWare 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 SwyxWare user to an Entra ID identity. Make sure that the e-mail address of the SwyxWare 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 SwyxWare PowerShell module.
 
5 Select the Functions tab
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 SwyxWare. (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 active
Presence sync is disabled by configuration
Teams Presence Synchronization
6 Click on Save.