Как это работает
Коннектор индексирует файлы на Яндекс Диске: ваши и файлы общих папок, которыми с этим аккаунтом поделились другие пользователи. Документы из «Яндекс Документов» лежат на Диске обычными файлами (.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 появится, если подключить собственное приложение Яндекса:- На 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. - В
deployment/docker_compose/.envзадайтеWEB_DOMAIN(адрес, по которому открывают Yahont),YANDEX_DISK_CLIENT_IDиYANDEX_DISK_CLIENT_SECRETсо страницы приложения. - Выполните
docker compose up -dв каталогеdeployment/docker_compose.
Индексирование
В форме коннектора:- Папка (необязательно): путь от корня Диска, как папка называется на Диске, например
Документы/Договоры. Можно вставить адрес папки из браузера (https://disk.yandex.ru/client/disk/…) илиdisk:/Документы. Пустое поле — весь Диск, включая общие папки. - Максимальный размер файла, МБ (в дополнительных настройках): по умолчанию 20, от 1 до 100. Файлы больше пропускаются.
Проверка подключения
Проверки запускаются после добавления аккаунта и кнопкой Запустить проверки:- Sign in to Yandex Disk: Яндекс принял токен (показывает логин аккаунта).
- Find the root folder: папка из поля Папка существует (при пустом поле читается весь Диск).
Отклонённый токен ставит коннектор на паузу. Лимит запросов, работы на стороне Яндекса и сбои сети паузу не ставят:
коннектор повторит запуск позже.
Замена токена
На странице коннектора в блоке Аккаунт для аутентификации раскройте карточку аккаунта, нажмите кнопку с карандашом Обновить учётные данные и введите новый токен. Если коннектор на паузе, нажмите Управление индексом → Возобновить индексацию и синхронизацию. Аккаунт, подключённый через вход Яндекса, заменяется новым входом. Аккаунт нельзя удалить, пока им пользуется коннектор: сначала удалите коннектор.Ограничения
- Один коннектор — одна папка или весь Диск. Для нескольких папок нужно несколько коннекторов.
- Каждое обновление обходит всё дерево папок, поэтому на большом Диске запуск идёт дольше.
- Права доступа Диска не переносятся: документы доступны в Yahont по настройкам доступа коннектора.
- Переименование файла не меняет дату изменения: новое название появится после следующего изменения файла или полной переиндексации.
- Файл, который Яндекс не отдал для скачивания, пропускается. Он вернётся в индекс, когда изменится, или при полной переиндексации.
- На Диске с тысячами фото и включённым Извлечением и описанием изображений первая индексация идёт долго и расходует запросы к модели. Если фото не нужны, укажите папку с документами или выключите эту настройку.
- Общие диски организации Яндекс 360, Телемост, вложения писем и форматы
.odt,.odsне поддерживаются.

