Skip to content
/ WebDavMailRuCloud Public
forked from yar229/WebDavMailRuCloud

The WebDAV emulator for RU-clouds: Cloud.Mail.Ru & Disk.Yandex.Ru

License

MIT license
9 stars 60 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

ZZZConsulting/WebDavMailRuCloud

BranchesTags
 
 

Repository files navigation

The WebDAV emulator for RU-clouds: Cloud.Mail.Ru & Disk.Yandex.Ru

The root project by YaR229

The fork project by ZZZConsulting

@ZZZConsulting:

Важно!

Чтобы обновленная версия с исправлением удаления быстрее дошла до пользователей, тестирование было незначительным, не продолжительным и на весьма ограниченном наборе сценариев. Перед полноценным использованием новой версии РЕКОМЕНДУЕТСЯ проверить работу со своим облачным Диском - что-нибудь создать, загрузить, удалить и т.д, убедиться, что нет сбоев и все работает верно. А в случае ошибок - писать в Issue. Так же, рекомендуется сохранить предыдущую версию, чтобы было к чему вернуться, в случае чего.

Последняя протестированная версия API Яндекса - 383.0.0.

Последние изменения:

  1. Исправлено удаление для Яндекс.Диска, которое перестало работать какое-то время назад.
  2. Значительно переработало кеширование. В частности, после удаления файла из папки, кеш папки больше не сбрасывается и не перечитывается с сервера. Когда в папке тысячи файлов разница во времени работы существенна. Обратной стороной стали фантомы в кеше, победить которые до конца не выходит. Если проблема фантомов начинает мешать, стоит уменьшить время кеширования и/или через браузер делать действия приводящее к сбросу кеша (см. следующий пункт).
  3. Если операция с Диском идет, минуя данный сервис, то сервис о ней не знает, а значит кеш теряет актуальность. В данной версии улучшен контроль внешний изменений на Диске через историй изменений файлов.

Пароль для Disk.Yandex.Ru

При обращении к Disk.Yandex.Ru через эмулятор WEBDAV, всегда следует указывать основной пароль учетной записи. Не работает, если использовать пароль, созданный в Пароли приложений.

Пароль для Cloud.Mail.Ru

При обращении к Cloud.Mail.Ru через эмулятор WEBDAV работают пароли, созданные в Пароли для внешних приложений. Рекомендуется использовать такой пароль.

Это ВАЖНО!

Не смотря на то, что лицензия все обговаривает (да кто ж её читает?), необходимо напомнить, что за ВАШИ данные несете ответственность только ВЫ! Программное обеспечение может содержать ошибки. И даже в случае, когда оно прошло самое лучше тестирование, которое может быть, конкретно в Вашей среде, с Вашими настройками, Вашими параметрами, серверами, задержками, файлами и чем угодно еще, программное обеспечение может дать сбой и повести себя не так, как того от него ожидали. Поэтому, каждый раз, перед тем, как начать использовать новую версию программы на важных для Вас данных, проверьте, что конкретно у Вас и в Вашей среде эта новая версия работает корректно и без критических ошибок, что как минимум она не портит Ваши данные. Авторы данного программного обеспечения не гарантируют правильность его работы, не гарантируют правильность и сохранность данных, и не несут ответственность за последствия применения данного программного обеспечения. Используя данное программное обеспечение, ВЫ берете на себя ответственность за сохранность Ваших данных. Никто специальным вредительством не занимается, но ошибки в ПО есть всегда! Тем более, что используется неофициальные API, от чего правильное функционирование программы может прекратиться в любой момент.

ВАЖНОЕ по части облака Яндекса (disk.yandex.ru)!

Выбор в настройках учетной записи опцией входа «обычный пароль» и Требование пройти дополнительную проверку при входе (с кодом через СМС или email) не связаны. Это две разные сущности.

В случае, когда пользователь выбирает вход «по паролю и СМС», подтверждение кодом будет при каждом входе. А когда «обычный пароль», то в случаях, когда проверка спровоцирована.

Проверку может «спровоцировать» полный выход из аккаунта, использование разных браузеров, разных устройств, очистка cookie, использование режима «Инкогнито» и VPN.

Если используете облако Яндекса с логином и паролем, попытка использования другой версии эмулятора может привести к невозможности дальнейшего входа только по логину и паролю!

Requirements

Usage        ENG

  -p, --port            (Default: 801) WebDAV emulator port or several ports separated by `,`.
  -h, --host            (Default: "http://127.0.0.1") WebDAV emulator host with protocol
                        (http://* for http://0.0.0.0).
  --maxthreads          (Default: 5) Maximum concurrent listening connections to the service.
  --maxconnections      (Default: 10) Maximum concurrent connections to cloud server per instance.
  --use-locks           (Default: false) Use locking feature.
  --cache-listing       (Default: 30) Timeout of in-memory cache of file and folder names
                        of the cloud in seconds. 0 disables the cache.
  --cache-listing-depth (Default: 1) Folder hierarchy depth when listing folders content.
                        Always equals 1 when cache-listing > 0.
                        To maximize performance
                        set cache-listing-depth=1 and cache-listing between 600 and 1800.
  --use-deduplicate     (Default: false) Enable deduplication (upload speedup, put by hash),
                        see Using deduplication readme section.
  --disable-links       (Default: false) Disable support for shared folder and links
                        stored in item.links.wdmrc files.

  --protocol            (Default: Autodetect) Cloud protocol
                        * Autodetect - see Auto-detect protocol readme section
                        * WebM1Bin   - (Cloud.Mail.Ru) mix of mobile and DiskO protocols
                        * WebV2      - (Cloud.Mail.Ru) [deprecated] desktop browser protocol
                        * YadWeb     - (Disk.Yandex.Ru) desktop browser protocol,
                                       see Disk.Yandex.Ru readme section

  --install <service name>          Install as Windows service (Windows .Net 4.8/7.0/8.0 versions only).
  --install-display <display name>  'Display name' of the service when installed as Windows service
                                    (Windows .Net 4.8/7.0/8.0 versions only).
  --uninstall <service name>        Uninstall Windows service (Windows .Net 4.8/7.0/8.0 versions only).

  --proxy-address <socks|https|http>://<address>:<port>   Use proxy
  --proxy-user <username>                                 Proxy user name
  --proxy-password <password>                             Proxy password

  --100-continue-timeout-sec  (Default: 1) Timeout in seconds,
                              to wait until the 100-Continue is received if chuck transfer.
  --response-timeout-sec      (Default: 100) Timeout in seconds,
                              to wait until 1-st byte from server is received.
  --read-write-timeout-sec    (Default: 300) Timeout in seconds,
                              the maximum duration of read or write operation.
                              If your Internet connection is slow
                              or you upload/download large files increase the value.
  --cloud-instance-timeout    (Default: 30) Cloud instance (server+login) expiration timeout in minutes.
                              On request the service creates one instance per cloud and login.
                              After specified period of time without requests the instance is recycled.

  --help                Display this help screen.
  --version             Display version information.

  -user-agent           Overrides default 'user-agent' header in requests to cloud servers.
  -sec-ch-ua            Overrides default 'sec-ch-ua' header in requests to cloud servers.

Параметры        RUS

  -p, --port            (По умолчанию: 801) Порт (или список портов через `,`),
                        на которых эмулятор WebDAV принимает подключения.
  -h, --host            (По умолчанию: "http://127.0.0.1") адрес и протокол для приема
                        входящих подключений к эмулятору WebDAV (http://* для http://0.0.0.0).
  --maxthreads          (По умолчанию: 5) Максимальное количество одновременно
                        обрабатываемых подключений к эмулятору WebDAV.
  --maxconnections      (По умолчанию: 10) Максимальное количество соединений
                        каждого экземпляра эмулятора WebDAV к облачным серверам.
  --use-locks           (По умолчанию: false) Использовать блокировки
                        одновременного доступа к файлам.
  --cache-listing       (По умолчанию: 30) Таймаут в секундах хранения в памяти
                        списков файлов папок облачных серверов.
                        0 для выключения кеширования списков файлов.
  --cache-listing-depth (По умолчанию: 1) Сколько уровней вложенности папок
                        за раз читать с сервера. Всегда равно 1, если cache-listing > 0.
                        Для максимизации производительности задать
                        cache-listing-depth = 1 и cache-listing от 600 до 1800.
  --use-deduplicate     (По умолчанию: false) Включить deduplication
                        (ускорение загрузки по хэшу), см. раздел deduplication.
  --disable-links       (По умолчанию: false) Отключить поддержку общих папок и ссылок,
                        хранимых в файлах item.links.wdmrc.

  --protocol            (По умолчанию: Autodetect) Протокол работы с облаком
                        * Autodetect - см. раздел Auto-detect protocol
                        * WebM1Bin   - (Cloud.Mail.Ru) гибрид для мобильных и DiskO
                        * WebV2      - (Cloud.Mail.Ru) [устарел] протокол для браузера на ПК
                        * YadWeb     - (Disk.Yandex.Ru) протокол браузера на ПК,
                                       см. раздел Disk.Yandex.Ru readme

  --install <service name>          Установка сервисом Windows
                                    (только для сборок для Windows версий .Net 4.8/7.0/8.0).
  --install-display <display name>  Отображаемое имя для сервиса
                                    (только для сборок для Windows версий .Net 4.8/7.0/8.0).
  --uninstall <service name>        Удаление сервиса из Windows
                                    (только для сборок для Windows версий .Net 4.8/7.0/8.0).

  --proxy-address <socks|https|http>://<address>:<port>   Установка прокси-сервера
  --proxy-user <username>                                 Установка user name для прокси-сервера
  --proxy-password <password>                             Установка password для прокси-сервера

  --100-continue-timeout-sec  (По умолчанию: 1) Таймаут в секундах
                              на получение 100-Continue от сервера при блочной передаче.
  --response-timeout-sec      (По умолчанию: 100) Таймаут в секундах
                              на получение 1-го байта ответа от сервера.
  --read-write-timeout-sec    (По умолчанию: 300) Таймаут в секундах
                              на получение последнего байта данных от сервера.
                              Увеличьте значение при медленном интернете
                              или при загрузке/скачивании больших файлов.
  --cloud-instance-timeout    (По умолчанию: 30) Таймаут в минутах
                              на прекращение работы экземпляра (по облаку и логину) сервиса.
                              Эмулятор WebDAV на каждую пару облако+логин создает свой экземпляр сервиса.
                              При отсутствии обращений к экземпляру сервиса в течение указанного периода,
                              память освобождается от экземпляра сервиса.

  --help                Справка о параметрах на английском языке.
  --version             Версия программы.

  -user-agent           Переопределяет стандартный 'user-agent' в заголовках обращений к облачным серверам.
  -sec-ch-ua            Переопределяет стандартный заголовок 'sec-ch-ua' в обращениях к облачным серверам.

Hasher.exe usage

Calculating hashes for local files

  --files            (Group: sources) Filename(s)/wildcard(s) separated by space

  --lists            (Group: sources) Text files with wildcards/filenames separated by space

  --protocol         (Default: WebM1Bin) Cloud protocol to determine hasher

  -r, --recursive    (Default: false) Perform recursive directories scan

  --help             Display this help screen.

  --version          Display version information.

Using deduplication (upload speedup, put by hash)

Edit <Deduplicate> section in wdmrc.config:

  <Deduplicate>
    <!-- Path for disk file cache -->
    <Disk Path = "d:\Temp\WDMRC_Cache" />

    <!--
      Cache: on disk or in-memory file caching
      Target:  path with filename in cloud, .NET regular expression,
               see https://docs.microsoft.com/ru-ru/dotnet/standard/base-types/regular-expressions
      MinSize: minimum file size
      MaxSize: maximum file size
      -->
    <Rules>
      <!-- cache any path/file contains "EUREKA" in disk cache-->
      <Rule Cache="Disk" Target = "EUREKA" MinSize = "0" MaxSize = "0" />

      <!-- small files less than 15000000 bytes will be cached in memory -->
      <Rule Cache="Memory" Target = "" MinSize = "0" MaxSize = "15000000" />

      <!-- files larger than 15000000 bytes will be cached on disk -->
      <Rule Cache="Disk" Target = "" MinSize = "15000000" MaxSize = "0" />
    </Rules>
  </Deduplicate>

Then run with --use-deduplicate command line key.

Cloud protocol and Autodetect        ENG

Direct use of WebDAV with Cloud.Mail.Ru or Disk.Yandex.Ru is full of problems. The WebDAV emulator is made to solve the problems using unofficial APIs. We call the subset of API methods used to achieve a desired result a protocol. When user going to reach a cloud through WebDAV emulator, the WebDAV emulator must choose:

  • what cloud should be used (Cloud.Mail.Ru or Disk.Yandex.ru),
  • what protocol (API) must be used,
  • what kind of authentication must be used (basic login+password or browser).

Autodetect. How it works

Step 1. The Cloud

If user specified login in email style (e.g. [email protected] or [email protected]) the Cloud is determined by email domain. Otherwise (e.g. login is John) the Cloud is determined by protocol parameter of the application.

Step 2. The Protocol

In case when the Cloud is determined and the Protocol is not, the WebDAV emulator uses

  • WebM1Bin protocol for Cloud.Mail.Ru and
  • YadWeb protocol for Disk.Yandex.Ru.

Step 3. The Authentication type

The WebM1Bin protocol has only one type of authentication - login and password.

The YadWeb protocol for Disk.Yandex.Ru has two types of authentication:

  • login and password and
  • browser authentication using BrowserAuthenticator application.

By default the login+password authentication is used.

If BrowserAuthenticator is configured in wdmrc.config and user password equals to BrowserAuthenticator password the browser authentication is used.

User can give the WebDAV emulator the suggestion which type of authentication to use by appending symbol ! or ? in login string at leftmost position. ? means the browser authentication must be used. ! means the browser authentication must not be used.

The leftmost symbols ! and ? are removed from login while talking to clouds.

If browser authentication is not used, a user have to fill password with password of cloud account. The WebDAV emulator with YadWeb emulates browser, so the main password of the account must be used to connect to the cloud! Application password generated in Yandex account will fail!

If browser authentication is used, a user have two options. In both cases BrowserAuthenticator application is going to authenticate incoming request by matching incoming password against password on Settings window. The first options is to pass to WebDAV emulator exact value of password on Settings window of the BrowserAuthenticator application. The second option is to pass empty password to WebDAW emulator. That means WebDAW emulator should take the password from password attribute of the BrowserAuthenticator tag in wdmrc.config.

If you change password in Settings window of BrowserAuthenticator application quite often, you may want to setup password once in wdmrc.config and use login with empty password.

If you believe some one except you can try to connect to you BrowserAuthenticator application,you can put wrong password into password attribute of the BrowserAuthenticator tag in wdmrc.config and use login and correct password (equal to password in Settings window of BrowserAuthenticator application) while connecting to WebDAW emulator.

Cloud protocol and Autodetect        RUS

Использование WebDAV с облаками Cloud.Mail.Ru и Disk.Yandex.Ru не лишено проблем. Эмулятор WebDAV создан чтобы решить эти проблемы с использованием неофициального APIs. Подмножество методов API для работы с облаком называется протоколом. Когда пользователь использует эмулятор WebDAV, пытаясь подключиться к облаку, эмулятору WebDAV необходимо решить:

  • к какому облаку будет подключение (Cloud.Mail.Ru или Disk.Yandex.ru),
  • какой протокол (API) следует использовать,
  • какой тип аутентификации должен быть использован (просто login+password или аутентификация через браузер).

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

Шаг 1. Определение облака

Если пользователь задал login в формате email (например, [email protected] or [email protected]) облако определяется по домену из email (часть после символа @). В остальных случаях (например, login задан как John) облако определяется протоколом из параметра protocol при запуске приложения.

Шаг 2. Определение протокола

Если облако уже определено, а протокол еще нет, эмулятор WebDAV использует

  • протокол WebM1Bin для Cloud.Mail.Ru и
  • протокол YadWeb для Disk.Yandex.Ru.

Шаг 3. Тип аутентификации

Протокол WebM1Bin имеет только один тип аутентификации - по login и password.

Для протокола YadWeb для облака Disk.Yandex.Ru есть два варианта:

  • по login и password и
  • аутентификация через специальный браузер - BrowserAuthenticator.

По умолчанию YadWeb используется login+password.

Если в конфигурационном задан BrowserAuthenticator, то есть в файле wdmrc.config задан тэг BrowserAuthenticator и атрибут password, и переданный пользователем пароль совпадает с паролем в конфигурации BrowserAuthenticator, то считается, что требуется аутентификация через браузер.

Для большей надежности пользователь может давать эмулятору WebDAV подсказки, добавляя знаки ! или ? в login в первую позицию. ? в начале означает обязательную аутентификацию через браузер. ! в начале означает недопустимость аутентификации через браузер.

Начальные символы ! и ? удаляются из логина, передаваемого дальше на облачный сервер.

Если аутентификация через браузер не используется, password заполняется основным паролем учетной записи Яндекса. Пароли приложений создаваемые в учетной записи для доступа сторонних приложений здесь не подходят, т.к. эмулятор WebDAV работает не как другие приложения, а имитирует доступ браузера к облаку.

Если используется аутентификация через браузер, существует два варианта заполнить password. В обоих случаях приложение BrowserAuthenticator при всех входящих подключениях сверяет переданный пароль с паролем, заданным в окне настроек приложения BrowserAuthenticator. Вариант первый: передать в эмулятор WebDAV пароль, в точности соответствующий заданному в окне настроек приложения BrowserAuthenticator. Вариант второй: передать в эмулятор WebDAV пустой пароль. Это заставит эмулятор WebDAV при обращении к приложению BrowserAuthenticator использовать пароль, заданный в wdmrc.config в тэге BrowserAuthenticator.

Если пароль в настройках приложения BrowserAuthenticator меняется достаточно часть, можно положиться на вариант с пустым паролем и задавать его только в одном месте - в конфигурационном файле.

Но если есть риски, что к приложению BrowserAuthenticator может подключиться кто-то сторонний, есть смысл указывать пароль от приложения BrowserAuthenticator в каждом подключении к WebDAV emulator, а в wdmrc.config в тэге BrowserAuthenticator специально установить неправильный пароль.

Disk.Yandex.Ru        ENG

Issues of WebDAV by Disk.Yandex.Ru

  • It seems like WebDAV of Disk.Yandex.Ru is limited by speed since 2019.
  • After file uploading Yandex servers calculating hash. E.g. for a 10GB file it may take ~1..2 minutes depending on server load. So most of WebDAV clients drops connection on timeout.
  • There's no WebDAV info in official help now. WTF?
  • Since 2019 Yandex states that WebDAV is OK for all supported applications made by Yandex, also Yandex does not support and does not guarantee correct work of any third party application with their WebDAV.

To bypass the limit issue the WebDAV emulator uses the unofficial Disk.Yandex.Ru Web API. The salvation have 2 steps:

1) Disk.Yandex.Ru WebDAV authentication

To get in to Disk.Yandex.Ru you have to be authenticated by Yandex by any of two ways:

  • By login & password only. The account must be configured for log in using login and password only. Yandex account security have an option to create Application passwords. Do not use Application password when you connecting to this WebDAW service! You must use the main account password only because this service emulates you on the web using browser. Fill the login field with email (e.g. [email protected] instead of John).

  • By standard web site authentication using specially designed browser called BrowserAuthenticator. The BrowserAuthenticator application is designed to be run at Windows startup. It hides in system tray and waits for incoming authentication request from the WebDAV emulator. When requested, BrowserAuthenticator shows a browser window allowing you to log into cloud using login and password or login and password and SMS or even QR code. When you successfully logged in, the program takes all data from the browser and sends it back to the WebDAV emulator, then the service talks to cloud servers using you authentication information. Because your authentication information is used, you must keep cache with the information secured! For more information read the BrowserAuthenticator section.

2) File operations with Disk.Yandex.Ru

Once authenticated all file operations such as reading, writing, creating, deleting, and so on are available for use. Because the WebDAV emulator emulates you using a browser the Issue is not applied. Unfortunately, there is no guarantee the service is going to work infinitely long. Time to time Yandex makes unexpected changes in their programs.

Disk.Yandex.Ru        RUS

«Косяк» с WebDAV от Disk.Yandex.Ru

  • С конца 2019 года при загрузке файлов на Disk.Yandex.Ru по WebDAV были введены ограничения.
  • После загрузки файла, сервера Яндекса стали столь долго подсчитывать хэши файлов, что общая скорость оказать значительно ниже приемлемого уровня. Например, после загрузки 10 ГБ расчет хэша может занять ~1-2 минуты, из-за чего большинство клиентов отваливаются по таймауту.
  • При этом сам Яндекс заявляет, что в WebDAV все хорошо, их же приложения с WebDAV прекрасно работают, а за работу чужих приложений с их WebDAV они не отвечают.

При всех тормозах с WebDAV Яндекс.Диск очень даже быстро работает через браузер. В качестве обходного пути эмулятор WebDAV использует неофициальное Web API, прикидываясь браузером. Проблема решается в 2 шага:

1) Аутентификация на Disk.Yandex.Ru

Чтобы подключиться к Disk.Yandex.Ru нужно аутентифицироваться любым из двух способов:

  • Только login + password. В разделе безопасности учетной записи должен быть настроен вход только по логину и паролю. Пароли приложений, которые позволяет создавать Яндекс для доступа сторонних приложений, не должны применяется. Эмулятор WebDAV работает не как другие сторонние приложения, он прикидывается браузером, а потому для него не подходят пароли приложений. Заполнять password нужно только основным паролем учетной записи! Заполнять login необходимо полным email (например, [email protected], не кратким John), во избежание проблем при определении облака и т.д.

  • Стандартная аутентификация в специальном созданном браузере BrowserAuthenticator. Приложение BrowserAuthenticator создано так, чтобы запускаться при старте Windows. При запуске приложение скрывается в области системных иконок чтобы не мешаться. Будучи запущенным, приложение BrowserAuthenticator ожидает входящих подключений от эмулятора WebDAV, а получив вызов открывает окно браузера. позволяя войти в учетную запись облака. Если вход успешно состоялся, информация со страницы и куки браузера, содержащие информацию об аутентификации, приложением BrowserAuthenticator передаются обратно в эмулятор WebDAV. Информации, собираемой приложением BrowserAuthenticator и передаваемой эмулятору WebDAV достаточно чтобы без участия пользователя и от его имени сделать что угодно на облачном сервере! По этой причине охраняйте доступ к папкам, где расположена программа BrowserAuthenticator и кеш эмулятора WebDAV! Подробности читайте в разделе BrowserAuthenticator.

2) Дисковые операции с Disk.Yandex.Ru

После аутентификации все операции по чтению, записи, созданию и удалению доступны для использования. И т.к. эмулятор WebDAV имитирует работу пользователя в браузере на облачном сервере, все работает достаточно шустро. При этом следует помнить, что применяется неофициальное API, из-за чего корректная работа может прекратиться в любой момент.

BrowserAuthenticator        ENG

is a specially designed browser meant be run at Windows startup. It hides in system tray and waits for incoming authentication request from the WebDAV emulator. When requested, BrowserAuthenticator shows a browser window allowing you to log into cloud using login and password only or login and password and SMS code or even QR code. When you successfully logged in, the program takes all data from the browser and sends it back to the WebDAV emulator, then the service talks to cloud servers using you authentication information.

Remember!

The WebDAV emulator impersonates you using you credentials and security cookies taken from the BrowserAuthenticator application when you logged in! Both the WebDAV emulator and the BrowserAuthenticator application store the security information on drives. Read the following instruction very carefully!

Step-by-step setup of BrowserAuthenticator

  1. You need to choose the location for the BrowserAuthenticator. When BrowserAuthenticator runs it creates subfolders below folder where it is placed. It means it should have enough rights to create and delete folders and files. One of subfolders is going to have security information enough to connect to your cloud without your interaction, so the place must be secured!

One of the best options for hosting BrowserAuthenticator is %userprofile%\AppData\Local\Applications\BrowserAuthenticator (you need to create the folders yourself in %userprofile%\AppData\Local) or any other folder in %userprofile%\AppData\Local of your choice.

  1. Download BrowserAuthenticator-*-windows.zip package and extract it's content to the BrowserAuthenticator folder.

  2. Press Win+R and run shell:startup. Put shortcut of the BrowserAuthenticator program in startup folder, so the BrowserAuthenticator will be started everytime you log in to Windows. Don't make copy of the BrowserAuthenticator in startup folder, the shortcut only! Start the BrowserAuthenticator manually for the first time.

  3. Since it started the BrowserAuthenticator stays in system tray until you system reboot or you manually exit it using menu on tray icon. Use mouse double click on the BrowserAuthenticator tray icon to open up Settings window of the application.

  4. On the Setting Window setup then port and the password for incoming connections. Type in an email and press Test to check the browser is functional. For the password you can use any text string. To get things easy you can generate password by clicking the blue text under the field.

  5. Go to WebDAV emulator application folder. Open the wdmrc.config and edit the <BrowserAuthenticator> tag (add the tag if it's missing).

Attributes of <BrowserAuthenticator>:

  • Url="http://localhost:<port>/" - type in the address of the PC running BrowserAuthenticator application, port is the port you set in Settings window on the previous step. localhost could be replaced by any wold wide IP address reachable by WebDAV emulator.

  • Password is the text string you set in Settings window on the previous step. You should keep the Password in secret. Otherwise someone could connect to you BrowserAuthenticator application and steal you browser cookies, you credentials and you cloud data!

  • CacheDir is the full path to a folder where WebDAW emulator is going to keep information received from BrowserAuthenticator application. It contains browser cookies, the information enough to connect to your cloud impersonating you! Keep the folder secured as much as possible!

On step 1, you have created a folder for BrowserAuthenticator application somewhere in %userprofile%\AppData\Local Make another subfolder in BrowserAuthenticator application folder and put it's path into CacheDir attribute, so this way you have to keep in secret only one location not two.

In cage you don't want to cache information received from BrowserAuthenticator application remove the CacheDir attribute or put an empty string as a value.

BrowserAuthenticator        RUS

-- это специальный браузер, предназначенный к запуску вместе с Windows, чья иконка располагается в системной области внизу экрана среди иконок массы других запущенный программ.

BrowserAuthenticator ожидает запросов на аутентификацию от эмулятора WebDAV, а получив такой, открывает окно браузера и ждет, когда пользователь войдет в нужную облачную учетную запись. Используя браузер, пользователь может войти в учетную запись, у которой могут быть установлены любые настройки входа: только login и password, login + password + код из СМС, или даже вход по even QR-коду или ключу.

Как только вход в нужную учетную запись состоялся, BrowserAuthenticator собирает со страницы необходимые данные, добавляет к ним куки с информацией об аутентификации, и отправляет обратно в эмулятор WebDAV, который используя полученную информацию а значит, представляясь вошедшим в учетную запись пользователем, совершает затребованные действия на облачном сервере.

Помните!

Позволяя получить ваши данные, Вы даете передаете достаточно сведений, чтобы без Вашего участия можно было сделать на облачном сервере что угодно от Вашего имени! Поэтому охраняйте доступ к папкам, где расположено приложение BrowserAuthenticator, а также где расположен эмулятором WebDAV кеш данных, полученных от BrowserAuthenticator, от посторонних!

Внимательно прочитайте следующую инструкцию по настройке приложения BrowserAuthenticator!

Установка и настройка BrowserAuthenticator

  1. Сначала выберите место для приложения BrowserAuthenticator. Когда приложение работает, оно создает папки и файлы рядом со своим исполняемым файлом. По этой причине у приложения должно быть достаточно прав на создание и удаление папок и файлов внутри выбранной под приложения папке. Кроме того, в создаваемых папках будет секретная информация, позволяющая получить доступ к облачным данным пользователей, которые будут аутентифицироваться через BrowserAuthenticator, поэтому к папкам должен быть ограничен доступ.

Одним из лучших будет создание папки где-нибудь в %userprofile%\AppData\Local, например, %userprofile%\AppData\Local\Applications\BrowserAuthenticator (необходимые папки нужно создать вручную).

  1. Скачайте пакет BrowserAuthenticator-*-windows.zip, затем распакуйте его содержимое в папку, выбранную под приложение BrowserAuthenticator.

  2. Нажмите Win+R и запустите shell:startup. Поместите ярлык приложения BrowserAuthenticator в открывшейся папке автозапуска. Это позволит приложению BrowserAuthenticator запускаться каждый раз при запуске Windows, при входе в учетную запись. Не делайте копию приложения в папку автозапуска, помещайте туда только ярлык на приложение! Для первого раза запустите приложение BrowserAuthenticator вручную.

  3. При запуске приложение BrowserAuthenticator помещает свою иконку в системной области внизу экрана среди иконок других приложений. Приложение остается запущенным до перезагрузки или выхода из учетной записи. Приложение может быть закрыто через меню у иконки приложения в системной области. Дважды щелкните мышью по иконке приложения BrowserAuthenticator для открытия окна с Настройками приложения..

  4. В окне Настроек приложения задайте порт для входящих соединений и пароль. Введите email облачной учетной записи и нажмите Test для проверки работоспособности встроенного браузера. В качестве пароля можно использовать любую не пустую текстовую строку. Для простоты под полем ввода можно щелкнуть по голубой надписи чтобы создать новый Guid, который и будет новым паролем.

  5. Перейдите в папку с установленным эмулятором WebDAV. Откройте wdmrc.config и отредактируйте тэг <BrowserAuthenticator> (добавьте тэг, если он отсутствует).

Атрибуты тэга <BrowserAuthenticator>:

  • Url="http://localhost:<port>/" - URL, включающий адрес и порт ПК с запущенным приложением BrowserAuthenticator, port - номер порта, заданный в коне Настроек приложения BrowserAuthenticator на предыдущем шаге инструкции. localhost может быть заменен на любой иной IP, расположенный в любом конце света, главное чтобы к нему имел возможность подключиться эмулятор WebDAV.

  • Password - пароль, тестовая строка, заданная в качестве пароля в окне Настроек приложения BrowserAuthenticator на предыдущем шаге инструкции. Этот пароль следует хранить в секрете, т.к. зная пароль этот пароль и email можно получить доступ ко всем данным пользователя в облаке!

  • CacheDir - полный путь к папке, куда эмулятор WebDAW сохраняет полученную от приложения BrowserAuthenticator информацию для доступа к облаку. Папка и сохраняемые данные должны храниться в секрете и быть недоступными посторонним, т.к. хранимой в папке информации достаточно для полного доступа к данным в облаке!

На 1-м шаге инструкции создавалась папка для приложения BrowserAuthenticator где-то внутри %userprofile%\AppData\Local. Внутри папки с приложением BrowserAuthenticator можно создать еще одну под кеш, и указать ее путь в атрибуте CacheDir. Таким образом в безопасности и недоступности нужно будет хранить всего одну папку - ту, где установлено приложение BrowserAuthenticator.

В случае, если кеш для эмулятора WebDAW с информацией от приложения BrowserAuthenticator не нужен или не желателен, нужно удалить атрибут CacheDir или задать пустую строку вместо пути к папке.

Using as Windows service        ENG

Using as Windows service (dotNet48 package only).

  • Run cmd with Administrator rights
  • Then, for example, wdmrc.exe --install wdmrc -p 801 --maxthreads 15
  • net start wdmrc

Using as Windows service (dotNet7Win/dotNet8Win packages only).

  • For install: Run cmd with Administrator rights, change parameters and values, then run wdmrc.exe --install WebDavService --maxthreads 10 --maxconnections 20 --port 801 --cache-listing 600 --read-write-timeout-sec 600

  • For uninstall: Run cmd with Administrator rights, type in and run wdmrc.exe --uninstall WebDavService

Установка сервисом Windows        RUS

Установка сервисом Windows (для пакета dotNet48).

  • Запустить cmd в режиме Запуск от имени администратора
  • Затем ввести, например, wdmrc.exe --install wdmrc -p 801 --maxthreads 15
  • net start wdmrc

Установка сервисом Windows (для пакетов dotNet7Win/dotNet8Win).

  • Установка: Запустить cmd в режиме Запуск от имени администратора, затем откорректировать параметры и запустить wdmrc.exe --install WebDavService --maxthreads 10 --maxconnections 20 --port 801 --cache-listing 600 --read-write-timeout-sec 600

  • Удаление: Запустить cmd в режиме Запуск от имени администратора, затем запустить wdmrc.exe --uninstall WebDavService

Features

How to use encryption

Using XTS AES-256 on-the-fly encryption/decryption

  • Set (en/de)cryption password

    • with >>crypt passwd special command
      or
    • Add # and separator string to your login: [email protected]#_SEP_
    • After your mail.ru password add separator string and password for encrypting: MyLoginPassword_SEP_MyCryptingPassword

  • Mark folder as encrypted using >>crypt init command

  • After that files uploaded to this folder will be encrypted

Commands
Commands executed by making directory with special name.
Parameters with spaces must be screened by quotes.

  • >>join SHARED_FOLDER_LINK Clone shared cloud.mail.ru file/folder to your account
  • >>join #filehash filesize [/][path]filename Clone cloud.mail.ru file to your account by known hash and size
  • >>link SHARED_FOLDER_LINK [linkname] Link shared folder without wasting your space (or manually edit file /item.links.wdmrc)
  • >>link check Remove all dead links (may take time if there's a lot of links)
  • >>move /full/path/from /full/path/to Fast move (if your client moves inner items recursively)
  • >>copy /full/path/from /full/path/to Fast copy (if your client copies inner items recursively)
  • >>lcopy x:/local/path/from /full/server/path/to If file already in cloud, add it by hash without uploading
  • >>rlist [[/]path] [list_filename] list [path] to [list_filename]
  • >>del [[/]path] Fast delete (if your client makes recursive deletions of inner items)
  • >>share [[/]path] Make file/folder public
    • and create .share.wdmrc file with links
  • >>sharev [[/]path] [resolution] Make media file public
    • resolution = 0p (all), 240p, 360p, 480p, 720p, 1080p
    • and create .share.wdmrc file with public and direct play links
  • >>pl [[/]path] [resolution] Make media file public
    • resolution = 0p (all), 240p, 360p, 480p, 720p, 1080p
    • and create .share.wdmrc file with public and direct play links
    • and create .m3u8 playlist file
  • >>crypt init Mark current folder as encrypted
  • >>crypt passwd password_for_encryption_decryption Set password for encryption/decryption

Settings in wdmrc.exe.config

  • Logging
    <config><log4net>
    It's standard Apache log4net configurations, take a look for examples Additionally you can use protocol and port properties taken from command-line parameters.

  • Default video resolution for generated m3u playlists <config><DefaultSharedVideoResolution>
    Values: 0p auto, m3u contains links to all available resolutions 240p ~ 352 x 240 360p ~ 480 x 360 480p ~ 858 x 480 720p ~ 1280 x 720 1080p ~ 1920 x 1080

  • Default User-Agent
    <config><DefaultUserAgent>
    Default user-agent for web requests to cloud.

  • Special command prefix
    <config><AdditionalSpecialCommandPrefix>
    custom special command prefix instead of >>. Make possible to use special commands if client doesn't allow >>.

  • Enable/disable WebDAV properties
    <config><WebDAVProps>
    set false on properties you don't need to speedup listing on large catalogs / slow connections.

  • 2 Factor Authentication
    At this time you can use

    • <TwoFactorAuthHandler Name = "AuthCodeConsole"/> - asks for authcode in application console
    • <TwoFactorAuthHandler Name = "AuthCodeWindow"/> - asks for authcode in GUI window (only for .NET Framework releases)
    • <TwoFactorAuthHandler Name = "AuthCodeFile">
    <Param Name = "Directory" Value = "d:"/>
    <Param Name = "FilenamePrefix" Value = "wdmrc_2FA_"/>
</TwoFactorAuthHandler>
      user must write authcode to file. For example, user [email protected] writes code to d:\[email protected].

    Be careful, this methods does not usable when application started as a service/daemon.
    You can make your own 2FA handlers inherited from ITwoFaHandler and put it in separate dll which name starts with MailRuCloudApi.TwoFA

Connect with (almost any) file manager that supports WebDAV using Basic authentication with no encryption and

  • your cloud.mail.ru email and password
  • or anonymous login if only public links list/download required (WinSCP script example)

Automatically split/join when uploading/downloading files larger than cloud allows.

Russian FAQ
geektimes.ru - Снова про WebDAV и Облако Mail.Ru
glashkoff.com - Как бесплатно подключить Облако Mail.Ru через WebDAV
manjaro.ru - Облако Mail.Ru подключаем через эмулятор WebDAV как сетевой диск


Using from Windows Explorer requires enabled Basic Auth for WebDAV * Press Win+R, type `regedit`, click OK * HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters * Right click on the BasicAuthLevel and click Modify * In the Value data box, type 2, and then click OK. * Reset computer (or run `cmd` with admin rights and then `net stop webclient`, `net start webclient`)
Use as Windows disk ``` net use ^disk^: http://^address^:^port^ ^your_mailru_password^ /USER:^your_mailru_email^ ```
Faster WebDAV Performance in Windows 7 Windows 7 client might perform very bad when connecting to any WebDAV server. This is caused, because it tries to auto-detect any proxy server before any request. Refer to KB2445570 for more information.
  • In Internet Explorer, open the Tools menu, then click Internet Options.
  • Select the Connections tab.
  • Click the LAN Settings button.
  • Uncheck the “Automatically detect settings” box.
  • Click OK until you’re out of dialog.
By default, Windows limits file size to 5000000 bytes, you can increase it up to 4Gb * Press Win+R, type `regedit`, click OK * HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters * Right click on the FileSizeLimitInBytes and click Modify * Click on Decimal * In the Value data box, type 4294967295, and then click OK. * Reset computer (or run `cmd` with admin rights and then `net stop webclient`, `net start webclient`)
Wrong disk size when mapped as Windows drive [Microsoft says - "It's not a bug, it's by design"](https://support.microsoft.com/en-us/kb/2386902)

Linux

(tested under Elementary OS and Lubuntu)

See also

Mount with davfs2

  • mkdir /mnt/<folder>
  • edit /etc/davfs2/davfs2.conf set use_locks 0
  • sudo mount --rw -t davfs http://<address>:<port> /mnt/<folder>/ -o uid=<current_linux_user>

As a service (daemon)

CERTIFICATE_VERIFY_FAILED exception Issue 56 default installation of Mono doesn’t trust anyone

In short:

# cat /etc/ssl/certs/* >ca-bundle.crt
# cert-sync ca-bundle.crt
# rm ca-bundle.crt

Mac OS X

Use any client supports webdav.

Remarks

  • RaiDrive
  • NetDrive
  • rclone mount
  • Total Commander:
    • requires to update WebDAV plugin to v.2.9
    • turn on (connection properties) -> Send\Receive accents in URLs as UTF-8 Unicode
  • WebDrive:
    • disable (disk properties) -> HTTP Settings -> Do chunked upload for large files.
  • CarotDAV:
    • check (connection properties) -> Advanced -> Don't update property.
  • avoid using Unicode non-printing characters such as right-to-left mark in file/folder names

Big thanks

See also

A beer for YaR229

About

The WebDAV emulator for RU-clouds: Cloud.Mail.Ru & Disk.Yandex.Ru

Resources

Readme

License

MIT license
Activity

Stars

9 stars

Watchers

3 watching

Forks

1 fork
Report repository

Releases 11

Актуализация под Яндекс API 389.3.0 Latest
Dec 18, 2024
+ 10 releases

Languages

  • C# 99.0%
  • Other 1.0%