1E 9.x (on-premises)

On the Tachyon server where the Microsoft Office 365 connector will be executed, PowerShell needs to connect to Azure using MSOL, which requires the following two modules installed:

Install-Modules for Microsoft Office 365

Install-Module -Name AzureAD
Install-Module -Name MsOnline

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

In your Azure Active Directory console, go to the Enterprise applications node and click New application.

You need to create a non-gallery application, in the version of AAD we're using this is done by clicking the Create your own application button.

Provide a name for the application. The name of application should suggest the application is related to the Office 365 connector, for example: 1E O365 Connector. In this version of AAD we select the Integrate any other application you don't find in the gallery (Non-gallery) option and then clickCreatein the bottom left of the panel.

In the Overview tab for the new application, copy the Application ID value as this will be required for the connector.

Navigate back to the AAD blade and click the App registrations node of AAD.

Click on the application name for the new application.

Click on the API permissions node under the Manage section, then click Add a permission.

Click on the Microsoft Graph tile and then click on Application permissions.

You will see a long list of API permissions, scroll through them and check as appropriate using the following table as a guide.

When you have selected the correct permissions, click Add permissions. After they've been added, the permissions should like the picture shown opposite.

Click Grant admin consent for <organization>, where <organization> is the Organization you set when your InTune instance was created. This means that as an administrator for your organization, you're consenting that the users of the application can use these permissions. Click Yes to confirm.

Click on the Certificates & secretsnode, and then click on New client secret button

The Add a client secret form will open, add a description and select an expiry from the Expires options and then click Add.

Copy the new client secret Value and save it. It is important you save the client secret Value, as you won't be able to retrieve it after you perform another operation or leave this blade.

An AAD user with Reports Reader permissions must be made available in your organization's blade. The credentials for this user will be set in the Microsoft Office 365 connector when it is created in 1E.

These are the steps to add, test and run a Microsoft Office 365 connector.

Testing a Microsoft Office 365 connector

1. Select the Microsoft Office 365 connector by checking the box at the left-hand end of its entry in the Connectors table.

2. Click the Test button.

   1. The Test status column for the connector will display a clock icon

      

      indicating that the test has been queued for executing.

   2. If the test succeeds Test status will display a check icon

      , and the Last tested column will display the date and time the test succeeded.

   3. If the test fails the Test status will display a failed icon

      , and you'll need to check the details you entered for the connector.

3. If the test succeeds, you can proceed to run the connector to populate an inventory repository.

Running a Microsoft Office 365 connector

1. Click the Execute button.

2. In the Execute action popup subsequently displayed, use the Repository menu to select the inventory repository you want to populate.

3. Once the repository has been selected, you can then select the action to run. In the case of inventory repositories the actions will be restricted to inventory related actions. For a connector you will be looking for an action with the form Sync Data - <connector name>.

4. Select whether you want to clear any existing data in the repository by checking the Clean sync checkbox.

5. Click Execute button in the Execute action popup to start the sync.

6. When the sync starts, a number of actions are queued to be performed on the selected repository. To check the progress of the sync actions:

   1. Navigate to the Monitoring→Process log page.

   2. Here you can see the sequence of actions queued for the selected repository related to the Sync Data action selected.

   3. When each action has finished running you'll see a check icon

      appear in the Status column if it succeeds or a failed icon

      if it fails.

The following fields are available in the Add connector and Edit connector popups when the Microsoft Office 365 Connector type is selected, as shown in the picture opposite: