Microsoft Teams Services

enaio® 11.10

The 'msteams-client' and 'msteams-actions' services enable you to integrate in Microsoft Teams and transfer documents from Microsoft Teams to the user repository of enaio® client.

enaio® users can create enaio® documents in Microsoft Teams, thus giving Microsoft Teams users access to enaio® documents and their index data. Microsoft Teams users can edit and upload documents again if the enaio® user enabled this when they created the document.

enaio® users create a temporary token for a document in enaio®, paste it into the enaio® app for Microsoft Teams, and specify whether editing is permitted. The enaio® app for Microsoft Teams then shows the document and index data.

If a document is edited, the e-mail address of the Microsoft Teams user will be shown in the document history.

If Office 365 is installed and enabled, then documents can be edited there.

Configuration of the Services

Microsoft Teams Services are installed using enaio® service-manager. The following configurations are required if enaio® gateway and enaio® service-manager are installed on different servers.

msteamsactions-prod.yml

The msteamsactions-prod.yml configuration file located in the \service-manager\config\ directory must be extended:

gateway:
  proxy:
    osrenditioncache: "http://<gateway>"
    osrest: "http://<gateway>"
    msteamsactions: "http://<msteams-actions-IP>:7112/"
                                                            

The address of enaio® gateway and enaio® service-manager with the Microsoft Teams Services must be specified according to your installation. The default port of the 'msteams-actions' service is 7112.

enaio® gateway: application-prod.yml

The application-prod.yml file located in the \services\OS_Gateway\apps\os_gateway\config directory is also modified:

endpoints:
  - endpoint:
    name: msteamsactions
    url: 'http://<msteams-actions-IP>:7112'
                                                            

The address of enaio® service-manager with the Microsoft Teams Services must be specified according to your installation. The default port of the 'msteams-actions' service is 7112.

CORS Access

The configuration of enaio® gateway must also modified:

Add the following entry to the application-prod.yml file located in the \services\OS_Gateway\apps\os_gateway\config\ directory:
```
cors.enabled: true
cors.allowed.headers: "x-enaio-data"
```
Add the following entry to the msteamsactions-prod.yml file located in the \service-manager\config\ directory:

security: 
  gateway:
    cors:
      enabled: true                    
                                                                

Restrictions for CORS access

If CORS access is not to be enabled in the application-prod.yml file of enaio® gateway using cors.enabled: true in general, then the following can be added to the msteamsactions-prod.yml file of enaio® service-manager:

security: 
  gateway:
    cors:
      enabled: false
  allowed:
    origins: "https://msteams.prod.enaio.io"
                                                            

Configuring the Integration

The enaio® app for Microsoft Teams is a component of the \Backend\Service-Manager installation directory. It is available via the Microsoft Teams Admin Center. Users can then integrate it into Microsoft Teams as a tab.

The enaio® URL – the enaio® gateway address – and the enaio® webclient URL – default: <gateway/osweb> – are specified when installing the enaio® app for Microsoft Teams.

Please contact OPTIMAL SYSTEMS Support if addresses have been changed or entered incorrectly.

Installing the Microsoft Teams Services adds the 'Share in Microsoft Teams' function to the context menu of documents in enaio® client. This function generates a temporary token for the document, which is pasted into the enaio® app for Microsoft Teams and opens the document.

Add a function call in the context menu for enaio® webclient and enaio® webclient as a desktop application using the tools.json file. Add the function itself to a webclient event using enaio® editor-for-events.

Validity of the Token

The token is valid for 60 seconds by default. It can no longer be pasted after this. You can change this time period via the msteamsactions-prod.yml configuration file located in the \service-manager\config\ directory using the following entry:

token:
  duration:
    sec: 60
                                                            

Office 365

If Office 365 is integrated into enaio®, then the integration for editing Office documents can be enabled.

Add the following to the msteamsactions-prod.yml configuration file located in the \service-manager\config\ directory:

edit:
  office365:
    enabled: true
                                                            

The application-prod.yml file located in the \services\OS_Gateway\apps\os_gateway\config directory is also modified:

endpoints:
  - endpoint:
    name: msteamsactions
    url: 'http://<msteams-actions-IP>:7112'
  - endpoint:
    name: office365
    url: 'http://<office365-IP>:8099'
  - endpoint:
    name: dashlet365
    url: 'http://<dashlet365-IP>:8091'
                                                            

The address of enaio® service-manager with the services must be specified according to your installation.