Office365 Service Authentication

Owned by Ertan Tike
Last updated: Dec 30, 2022 by Selahattin Bostanci
1 min read

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.

Copyright © 2010 - 2023 Emakin. All rights reserved.