Office365 Service Authentication

This document describes how to allow Office365 API's server to server access for emakin rest clients.

Creating Service Account

Before allowing the access you need to register emakin as an application. This step is already configured for cloud configuration and required only for on-premises.

1. Login to https://apps.dev.microsoft.com
2. Select type of an application as a "Web"
3. Enter name of application (ex: emakin)
4. Enter callback paths as following addresses
   1. https://emakin.com/oauth/callback
   2. http://emakin.com/oauth/callback
   3. https://www.emakin.com/oauth/callback
   4. http://www.emakin.com/oauth/callback
5. Create a new application secret by clicking on "Generate New Key Pair"

6. Download the generated PFX file.

Configuring Emakin for Office365 Login Service

1. Start a new Edit Domain task from the Administration menu.
2. Expand the Office 365 login service
3. Enter the registered Office 365 credentials
    

4. In a service account key; you can specify the following formats;

   1. If certificate is stored in local server

      1. FILE;<CertificateFilePath>;<CertificatePassword>

   2. If you don't have local access to the server you can also specify with: 
      1. BASE64;<CertificateBase64>;<CertificatePassword>
      2. URL;<CertificateFileUrl>;<CertificatePassword>

Configuring Emakin for One Drive for Business Integration

1. If you want to enable One Drive; add new element into fileServices section.
    

   <fileServices>
     <add clientType="Desktop" />
     <add clientType="Webcam" />
     <add clientType="OneDrive" scope="Files.Read.All"/>
   </fileServices>

2. If you want to allow offline access to OneDrive API without user interaction, please  add the "offline" scope with space seperated.

Related articles

• Page:
  Google Service Authentication
• Page:
  Office365 Service Authentication
• Page:
  Populate a Dropdown with Data from a REST API
• Page:
  Developing the Retrieve Process
• Page:
  $Rest
• Page:
  Rest
• Page:
  Rest.Create