4. User Configuration

User connection, Microsoft 365 authentication, Exchange credentials and folder selection.

Connecting a Microsoft 365 User

With Microsoft 365, each user connects their own account directly from the vtenext user profile.

Procedure

  1. Open the user profile.
  2. Locate the Exchange section.
  3. Click Connect.
  4. Sign in with the correct Microsoft account.
  5. Confirm the requested authorization.
  6. Return to vtenext.
  7. Select synchronization folders if requested.
  8. Save.

Microsoft 365 Connect button

When the connection is complete and folders are configured, the profile shows Connected.

Microsoft 365 Connected status

Which account to use

Unless impersonation is configured, the e-mail address in the vtenext user profile must match the Microsoft account being connected.

Warning
Do not use the same e-mail address for two different vtenext users. This can cause synchronization issues and problems when handling calendar invitations, especially with external users.

Warning when Microsoft access expires

In the new Exchange Connector versions, vtenext checks Microsoft 365 authorization status. If one or more accounts are disconnected or their access has expired, a popup appears in the vtenext Calendar.

Exchange synchronization requires your attention
The warning lists accounts with Exchange access expired and provides a Renew access action. The user must renew the Microsoft authorization to restore normal synchronization.
  1. Identify the account shown as Exchange access expired.
  2. Click Renew access.
  3. Complete Microsoft sign-in and authorization again.
  4. Return to vtenext and verify that the warning disappears.
  5. Run a synchronization test if the account remained disconnected for a significant period.

Exchange synchronization requires your attention popup

If Connect or Renew access still fails

Verify that Microsoft sign-in completes all the way back to vtenext, that the vtenext session has not expired and that Office365 configuration is correct. See User Cannot Connect.

When to reconnect

Use Connect or Renew access when Microsoft authorization expires or is revoked, after an Exchange configuration reset, or when requested by support. If the Proxy/Custom App mode changes, follow Changing Exchange Type or Connection Method.

Configuring an Exchange Server User

With Exchange Server, the user is configured from their vtenext profile using Exchange credentials.

Required data

Check at least:

Exchange Server user configuration

Credential test

When user preferences are saved, the connector attempts to sign in to Exchange. If the credentials are valid, the profile is saved normally; if the credentials are incorrect or another connection problem exists, vtenext reports the issue and prevents the configuration from being saved.

If the test reports an invalid username or password, correct the credentials first. Do not continue changing folders or restarting synchronization until the Exchange login works.

Folder selection

Once access has been validated, select the folders used for Calendar, Tasks and Contacts. The connector can show both default and custom mailbox folders.

After saving

  1. Create a test event in vtenext.
  2. Verify that it appears in the selected Exchange calendar.
  3. Modify it in Exchange.
  4. Verify that the change returns to vtenext.

Repeat the test for any other enabled modules.

Exchange password changes

If the user changes their Exchange password, update the password in the vtenext profile as well. Synchronization can stop until the password is updated.

Selecting or Changing Synchronization Folders

Each user uses a specific folder for each synchronized data type.

Normally, users select:

Microsoft 365

After connecting with Connect, vtenext shows the available folders in the Microsoft account.

For Tasks, available Microsoft To Do lists are shown. The Flagged Emails list is not used as a synchronization folder. For Contacts, the main Contacts folder is also available.

Exchange Server

With Exchange Server, vtenext can show both default folders and custom mailbox folders.

Calendar folder selection

Task folder selection

Contacts folder selection

Which folder to choose

Use a dedicated, clearly named folder when vtenext data should be separated from the user's personal data. If the business process requires the default folder, select it knowingly because changes made there can be synchronized back to vtenext.

Creating folders
Synchronization folders can also be created directly from the folder selection interface.

Changing a folder that is already in use

Warning — delicate procedure
Folders already used by an active user must not be changed directly. The change requires administrator involvement and must be planned in advance with your vtenext vendor or partner.

Once a folder has been used for synchronization, vtenext and Exchange have stored relationships between synchronized entities. Simply switching folders can therefore cause conflicts, duplicates or incorrect behavior for previously synchronized Contacts, Events, Tasks and other records.

The procedure must be planned and generally includes:

  1. identify the affected users and folders;
  2. agree on the intervention with the vtenext vendor or partner;
  3. stop or control synchronization during the intervention;
  4. remove the synchronization information for records previously synchronized with Exchange, according to the administrator procedure;
  5. select the new folders;
  6. restart synchronization in a controlled way;
  7. validate the result with test records before closing the activity.
Do not perform this change independently
On a production system, do not change folders or delete synchronization references without an agreed procedure. The operation must be assessed case by case to avoid lost associations, duplicates or conflicts between vtenext and Exchange.

Resource Users and Impersonation

The Is Resource and Impersonation options are intended for specific scenarios and should not be enabled for every user.

Is Resource

Use Is Resource when the vtenext profile represents an Exchange resource, such as a mailbox or calendar dedicated to a meeting room, equipment or another company resource.

For a normal person with their own mailbox, this option is generally not required.

Impersonation

Use Impersonation when the Exchange environment has been configured so that one account can operate on another user's or resource mailbox.

The required permissions must already exist in Microsoft/Exchange. Enabling the option in vtenext does not automatically grant them.

Before using these options

Confirm with the Microsoft/Exchange administrator:

If no special setup exists, use the standard one-vtenext-user-to-one-Exchange-mailbox configuration.