Page Comparison

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. Open the workflow.config file to add Office365 as login service

2. Add a new element as into loginServices section.

   Code Block

   language	xml

   <add clientType="Office365" enabled="true" clientId="<applicationClientId>" clientSecret="<applicationClientSecret>" scope="User.ReadBasic.All" serviceAccountId="<applicationClientId>" serviceAccountKey="<pathToPFXFile>;<password>" />Start a new Edit Domain task from the Administration menu.
3. Expand the Office 365 login service
4. Enter the registered Office 365 credentials
   Image Added 

5. 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.
    

   Code Block
   language xml
   <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 , please  add the "offline" scope with space seperated.

...