Connecting to Office 365

An authenticated connection to Office 365 is required in order to access emails, or files from Microsofts Services. This guide is a walk-through to establish an OAuth application connection, based up on Microsofts interface in the year 2022.

Prerequisite

The following prerequisites must be fulfilled for a successful connection to Microsoft Office 365 authentication service:

Creating the Azure AD Application

You are about to create a new application now. This application will provide the authentication credentials for the OAuth connection we want to add to INETAPP.

  • Go to https://portal.azure.com and log in
  • Select Azure Active Directory from the overview
  • Select App registrations from the sidebar menu
  • Click New registration from the menu

In the newly opened page you have to configure your application:

  • Enter a meaningful name to distinguish the application
  • Select the Supported account types - there is a Help me choose... link describing the differences of the options. Usually the first (Single Tenant) option should suffice
  • Enter the Redirect URL displayed in the configuration dialog of the INETAPP server, where a new connection is created. Check, that you selected Web as the Redirect URL type.
  • Click Register at the bottom of the dialog
Figure 1: Configuration Dialog
Figure 2: Azure AD Application Registration

Obtaining the Client ID

The Client ID is displayed in the overview, directly after creating the application. It is displayed as Application (client) ID in the Essentials section of the application, directly below the applications name. Paste the Client ID into the OAuth Connection dialog.

Obtaining the Client Secret

The Client Secret has to be created separately. You can use the link Add a certificate or secret in the essentials section to navigate there.

  • Navigate to the Certificates & secrets section of the application
  • Click New client secret in the Client secrets tab
  • Enter a Description and set the Expiration time in the sidepanel
  • Click Add

You must now copy the new entry from the Value column from the table and paste it into the OAuth Connection dialog.

Note: The Secret ID is considered a password, so please keep it in a safe place.