Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

  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 in the following formats;

    1. If certificate is stored in local server

      1. FILE;<CertificateFilePath>;<CertificatePassword>

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

...

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

    Code Block
    languagexml
    <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.

...

Filter by label (Content by label)
showLabelsfalse
max57
spacesEMK
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "rest" , "office365" ) and type = "page" and space = "EMK"in ( "EMKDOC" , "EMKDEV" )
labelsrest office365

Page Properties
hiddentrue


Related issues