Skip to main content
Логотип Яндекс Диска

Как это работает

Коннектор индексирует файлы на Яндекс Диске: ваши и файлы общих папок, которыми с этим аккаунтом поделились другие пользователи. Документы из «Яндекс Документов» лежат на Диске обычными файлами (.docx, .xlsx) и индексируются как файлы. Индексируются форматы, которые поддерживает Yahont: PDF, DOCX, XLSX, CSV, TXT, PPTX и другие. Изображения индексируются, только если в Настройки индекса включено Извлечение и описание изображений. Файлы из «Корзины», файлы больше лимита размера и неподдерживаемые форматы (в том числе .odt и .ods) пропускаются без скачивания. Коннектор только читает Диск: он ничего не меняет и не удаляет. Ссылка в источнике ответа открывает папку файла в веб-версии Диска. Используется технология Яндекса.

Настройка

Вход через Яндекс в Yahont Cloud

1

Откройте коннектор

Откройте Панель администратора → Добавить коннектор и выберите Яндекс Диск в разделе Хранилища.
2

Войдите через Яндекс

В блоке Учётная запись для аутентификации откройте Новая учётная запись Яндекс Диск, вкладка OAuth. В строке Войти через Яндекс Диск нажмите Подключить.
3

Разрешите доступ

На странице Яндекса выберите аккаунт, чей Диск нужно индексировать, и разрешите доступ. Yahont запрашивает только чтение Диска. Аккаунт появится в списке сохранённых аккаунтов, проверки подключения запустятся сами.
Подключить можно любой аккаунт Яндекса. Токен обновляется сам. Все аккаунты, подключённые так, сначала называются одинаково (Yandex_Disk OAuth Credential): переименуйте аккаунт кнопкой с карандашом рядом с названием.

Ручной токен

Способ для Yahont CE и запасной вариант в облаке.
1

Зарегистрируйте приложение

На oauth.yandex.ru создайте приложение под своим аккаунтом Яндекса, тип Для доступа к API. Платформа Веб-сервисы, Redirect URI https://oauth.yandex.ru/verification_code. Права: Чтение всего Диска (cloud_api:disk.read) и Доступ к информации о Диске (cloud_api:disk.info). Других прав не давайте.
2

Выпустите токен

Откройте https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID приложения> и разрешите доступ. Токен появится на странице и в адресной строке после #access_token=.
3

Добавьте токен в Yahont

Откройте Добавить коннектор → Яндекс Диск → Новая учётная запись Яндекс Диск, вкладка API-токен. Вставьте токен в поле OAuth-токен. Поле Отображаемое имя необязательное.
Выпускайте токен своего приложения для своего аккаунта и не передавайте его третьим лицам. Такой токен не обновляется сам. Когда Яндекс перестанет его принимать, выпустите новый и замените его.

Свой вход через Яндекс в Yahont CE

По умолчанию в CE доступен только ручной токен. Вкладка OAuth появится, если подключить собственное приложение Яндекса:
  1. На oauth.yandex.ru создайте приложение типа Для авторизации пользователей, платформа Веб-сервисы, права Чтение всего Диска (cloud_api:disk.read) и Доступ к информации о Диске (cloud_api:disk.info). Redirect URI: <адрес Yahont>/connector/oauth/callback/yandex_disk, например https://yahont.example.ru/connector/oauth/callback/yandex_disk.
  2. В deployment/docker_compose/.env задайте WEB_DOMAIN (адрес, по которому открывают Yahont), YANDEX_DISK_CLIENT_ID и YANDEX_DISK_CLIENT_SECRET со страницы приложения.
  3. Выполните docker compose up -d в каталоге deployment/docker_compose.
Дальше действуйте как в разделе вход через Яндекс.

Индексирование

В форме коннектора:
  • Папка (необязательно): путь от корня Диска, как папка называется на Диске, например Документы/Договоры. Можно вставить адрес папки из браузера (https://disk.yandex.ru/client/disk/…) или disk:/Документы. Пустое поле — весь Диск, включая общие папки.
  • Максимальный размер файла, МБ (в дополнительных настройках): по умолчанию 20, от 1 до 100. Файлы больше пропускаются.
Поле Обновлять каждые (по умолчанию 30 минут) забирает файлы, изменённые с прошлого запуска. Очищать каждые (по умолчанию 7 дней) убирает из индекса файлы, удалённые на Диске. Индексировать документы после исключает файлы, изменённые раньше этой даты. Чтобы сменить папку, нажмите Изменить настройки, измените поле Папка и нажмите Просмотреть изменения. Yahont покажет план: папка внутри прежней — очистка лишнего, папка выше — полная переиндексация, другая папка — переиндексация с очисткой.

Проверка подключения

Проверки запускаются после добавления аккаунта и кнопкой Запустить проверки:
  • Sign in to Yandex Disk: Яндекс принял токен (показывает логин аккаунта).
  • Find the root folder: папка из поля Папка существует (при пустом поле читается весь Диск).
Отклонённый токен ставит коннектор на паузу. Лимит запросов, работы на стороне Яндекса и сбои сети паузу не ставят: коннектор повторит запуск позже.

Замена токена

На странице коннектора в блоке Аккаунт для аутентификации раскройте карточку аккаунта, нажмите кнопку с карандашом Обновить учётные данные и введите новый токен. Если коннектор на паузе, нажмите Управление индексом → Возобновить индексацию и синхронизацию. Аккаунт, подключённый через вход Яндекса, заменяется новым входом. Аккаунт нельзя удалить, пока им пользуется коннектор: сначала удалите коннектор.

Ограничения

  • Один коннектор — одна папка или весь Диск. Для нескольких папок нужно несколько коннекторов.
  • Каждое обновление обходит всё дерево папок, поэтому на большом Диске запуск идёт дольше.
  • Права доступа Диска не переносятся: документы доступны в Yahont по настройкам доступа коннектора.
  • Переименование файла не меняет дату изменения: новое название появится после следующего изменения файла или полной переиндексации.
  • Файл, который Яндекс не отдал для скачивания, пропускается. Он вернётся в индекс, когда изменится, или при полной переиндексации.
  • На Диске с тысячами фото и включённым Извлечением и описанием изображений первая индексация идёт долго и расходует запросы к модели. Если фото не нужны, укажите папку с документами или выключите эту настройку.
  • Общие диски организации Яндекс 360, Телемост, вложения писем и форматы .odt, .ods не поддерживаются.