Office 365 Integration

Introduction

This document explains how to configure the Office 365 integration via API Rest

The Office 365 integration allows:

• Create, update and disable users (accounts in Soffid)
• Assign a password when creating and updating passwords
• Assign a default license at creation

Note, this integration only includes account reconciliation and propagation (no roles and no authoritative data management).

Prerequisites

• Office 365 must be internally connected to Azure.

Documentation

Webs

• Soffid portal → https://portal.office.com
• Office portal→ https://www.office.com

Microsoft Graph

Microsoft's test tool for testing purposes.

• Microsoft Graph → https://developer.microsoft.com/en-us/graph/graph-explorer/preview

API

Enlaces a páginas útiles del API del websercice REST

• Usuario → https://docs.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
• Asignar licencia → https://docs.microsoft.com/en-us/graph/api/user-assignlicense?view=graph-rest-1.0&tabs=http
• Operadores → https://docs.microsoft.com/en-us/graph/api/singlevaluelegacyextendedproperty-get?view=graph-rest-1.0&tabs=http

Otros enlaces

• Autenticación → https://docs.microsoft.com/es-es/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth#bk_register
• Asignar permisos al usuario de servicio → https://www.qnap.com/en/how-to/tutorial/article/how-to-obtain-authentication-for-adding-a-new-office-365-domain-in-boxafe/

Peticiones de ejemplo

• https://graph.microsoft.com/v1.0/users
• https://graph.microsoft.com/v1.0/users/test@soffid.com
• https://graph.microsoft.com/v1.0/users/test@soffid.com?$select=assignedLicenses
• https://graph.microsoft.com/v1.0/users/test@soffid.com/licenseDetails
• POST https://graph.microsoft.com/v1.0/users/test@soffid.com/assignLicense
  {"addLicenses":[{"disabledPlans":[],"skuId":"3b555118-da6a-4418-894f-7df1e2096870"}],"removeLicenses":[]}