Connect to Office 365 with a Service Account

Allow the One Touch Dial service to read the Office 365 calendars. Connecting with a service account grants the One Touch Dial service the ability to read the calendars in the organization that are associated with the service account.

Alternatively you may choose to connect as an application which provides a simpler method of connecting, but with reduced control.

Prerequisite

When connecting a Microsoft calendar with a service account you can limit the permissions of the connected account to maintain a higher level of control over calendar permissions granted to the One Touch Dial application.

Create a Service Account

Note: When using a service account to connect to the calendar, you need to delegate access rights to mailboxes for the service account.

The following example is a Microsoft PowerShell script that creates a service account for Office 365. It is recommended to set the password for the account to never expire.

New-MsolUser -DisplayName "OneTouchDial Account" -FirstName "OneTouchDial" -LastName "Account" -UserPrincipalName "onetouchdial.account@yourdomain.com" -UsageLocation US -LicenseAssignment yourdomain:ENTERPRISEPREMIUM -Password "a_hard_password" -PasswordNeverExpires $true -ForceChangePassword $false

Note: If you are setting up a hybrid configuration using both an Office 365 and Exchange integration in One Touch Dial, the fully qualified domain name will need to be used for the Office 365 service account and the Office 365 mailboxes set up in One Touch Dial.

Delegate Access Rights

If you are using a service account to manage One Touch Dial access, you need to allow the service account to review the mailbox account.

Note: When using a service account to connect to your calendar, you need to delegate access rights to mailboxes for the service account. For additional information on delegating access rights, see the Microsoft documentation.

The following provides an example of delegating access rights of a single mailbox's calendar to a service account for Office 365.

Add-MailboxFolderPermission -Identity "VTC01@yourdomain.com:\Calendar" -User "onetouchdial.account@yourdomain.com" -AccessRights "Reviewer"

Verify the mailbox permissions with the following command

Get-MailboxFolderPermission "VTC01@yourdomain.com:\Calendar"

Allow the One Touch Dial application to read the Office 365 calendars. Connecting with a service account grants the One Touch Dial application the ability to read the calendars in your organization that are associated with the service account.

Procedure

  1. In the Calendars tab, click the Office 365 Connect button.
  2. Select the Connect with Service Account option.
  3. Enter the service account to use. A page listing the permissions required to access the Office 365 calendars display. Hover the mouse over the "question mark" icons next to each bullet point to see how the One Touch Dial application uses the data.
  4. Click Accept to grant the One Touch Dial application permissions to access the Office 365 calendars.
  5. You are brought back to the Calendars tab where a Connected with service account message displays if the integration is successful.

Connect

  1. In the Calendars tab, click the Office 365 Connect with Service Account button.
  2. Sign in with the service account to use for calendaring.
  3. Consent to grant One Touch Dial the requested access to the service account.
  4. You will be redirected to the One Touch Dial portal and can now view the integration status.

Disconnect

Disconnect the calendars by removing the calendar integration.

  1. In the Calendars tab, click the Office 365 Disconnect button.
  2. Click Disconnect again to confirm.

Reconnect

If you are already integrated to Office 365 but need to reconnect the integration.

  1. In the Calendars tab, click the Office 365 Reconnect button.
  2. Click the Office 365 Connect with Service Account button.
← As an ApplicationConfigure Room Mailbox →