Настройка импорта досок из Miro

Создание и подключение приложения для импорта

Для настройки импорта досок из Miro в наше приложение необходимо выполнить следующие шаги:

1. Получение аккаунта разработчика на портале разработчик Miro

Перейдите на портал разработчиков Miro и зарегистрируйте свой аккаунт как аккаунт разработчика.

2. Создание приложения в Miro

Перейдите в раздел Your apps и выберите Create a new app. Название приложения может быть произвольным.

3. Настройка приложения

• App URL: Очистите это поле и нажмите Save. Этот параметр не нужен.
• Redirect URI for OAuth2.0: Обязательно укажите URI. Принцип его формирования таков: https://${domain}/miro/login.
  domain — равен значению domain из конфигурационного файла приложения (config.json)

• App Credentials: В этом разделе содержатся необходимые нам clientId и secret.

• Permissions: Выставьте для приложения следующие разрешения:
  • boards:read
  • identity:read
  • team:read

• App Publication Status: Статус приложения может оставаться в состоянии Draft, это не мешает работе импорта.

4. Настройки в config.json

В корневой секции файла config.json добавьте следующую запись:

"miro": {
    "clientId": "********",
    "secret": "****************",
    "debug": true
}

В поле clientId впишите значение Client ID из настроек вашего приложения Miro.
В поле secret впишите значение Client secret из настроек вашего приложения Miro.

Возможные неполадки и их исправление

Ошибка "error":"Cant authorize"

• Проверьте доступность для следующий ресурсов из контейнера приложения:
  https://api.miro.com
  https://miro.com

Для этого запустите curl из контейнера с приложением:

docker exec -it editboard /bin/bash

curl -v https://api.miro.com

curl -v https://miro.com

В случае ошибок при выполнении запроса, необходимо обеспечить приложению доступ до указанных ресурсов

• Повышение значения параметра proxy_read_timeout до 300
• Включение access log в конфигурации nginx приложения,в случае, если необходима дополнительная информация

Импортированные доски не обрабатываются

В config.json не указан необходимый тип сервера.

"type": [
  "api",
  "socket",
  "upload",
  "redis",
  "admin",
  "coordinator",
  "convert_documents",
  "convert_video",
  "miro"<<<
  ],