Как настроить диплинки в браузере для входа в Пачку

Эта статья для тех, кто установил десктоп-приложение Пачки и хочет авторизоваться в нём через SSO, но после входа в браузере приложение не открывается автоматически.

Как работает вход через SSO

1. Вы нажимаете «Войти через SSO» в десктоп-приложении.
2. Открывается браузер с формой входа вашего провайдера (Keycloak, Azure AD, Яндекс 360 и др.).
3. После успешной авторизации браузер вызывает ссылку pachca://…, и приложение открывается автоматически.

Если на шаге 3 ничего не происходит и вы остаётесь в веб-версии — браузер не может или не разрешает открыть ссылку pachca://…. Проверьте работу диплинков по шагам ниже.

Самая частая причина

Пользователь ранее нажал «Запретить» (или «Блокировать», «Не открывать») в окне, где браузер предлагал открыть Pachca. Браузер запоминает этот выбор и больше не спрашивает разрешение. Решение — сбросить это ограничение в настройках браузера (см. шаг 1).

Шаг 1. Проверить, работает ли диплинк в браузере

Откройте браузер и введите в адресную строку:

pachca://profile

Если всё работает корректно, появится системное окно с вопросом «Хотите разрешить этому сайту открыть приложение «Pachca»?». Нажмите «Разрешить» — приложение должно открыться. После этого повторите вход через SSO — теперь браузер должен корректно перебросить вас в приложение.

Если окно не появилось — скорее всего, схема pachca:// заблокирована в браузере. Проверьте настройки:

• Chrome: chrome://settings/handlers → если Пачка в списке заблокированных — удалите. Также: Настройки → Конфиденциальность → Настройки сайтов → Дополнительные разрешения → Обработчики протоколов.
• Yandex Browser: browser://settings/handlers → аналогично Chrome.
• Opera: opera://settings/handlers → аналогично Chrome.
• Safari: Safari не даёт блокировать отдельные схемы. Если не работает — причина не в браузере, переходите к шагу 2.
• Edge: edge://settings/content/applicationLinks → убедитесь, что внешние ссылки разрешены.

После изменений перезапустите браузер и попробуйте pachca://profile снова.

Шаг 2. Проверка через терминал (без браузера)

Чтобы понять, виноват браузер или регистрация протокола в системе, вызовите диплинк напрямую:

• Windows: нажмите Win + R, введите pachca://profile и нажмите Enter.

• macOS: откройте Terminal (Cmd + Пробел → введите «Terminal») и выполните open pachca://profile.

• Linux: откройте терминал (Ctrl + Alt + T) и выполните xdg-open pachca://profile.

• Если приложение открылось — протокол зарегистрирован корректно, проблема в браузере (вернитесь к шагу 1).

• Если нет — схема не зарегистрирована в системе, переходите к шагу 3.

Шаг 3. Переустановить приложение

macOS

1. Закройте Пачку.
2. Перетащите Пачку из Приложений в Корзину.
3. Скачайте и установите Пачку заново.
4. Обязательно запустите приложение хотя бы один раз.

Windows

1. Параметры → Приложения → найдите Пачку → Удалить.
2. Скачайте и установите заново.
3. Запустите приложение хотя бы один раз.

Linux

1. Удалите пакет (sudo apt remove pachca / sudo dnf remove pachca или аналог).
2. Установите заново.
3. Запустите приложение хотя бы один раз.

После переустановки повторите шаг 2.

Шаг 4. Ручная регистрация схемы

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

macOS

# Узнать путь к приложению
mdfind "kMDItemCFBundleIdentifier == 'com.pachca.*'"

# Принудительно перерегистрировать
/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -f /Applications/Pachca.app

Windows (PowerShell от администратора)

# Замените путь на актуальный
$exePath = "C:\Users\$env:USERNAME\AppData\Local\Programs\pachca\Pachca.exe"

New-Item -Path "Registry::HKEY_CLASSES_ROOT\pachca" -Force
Set-ItemProperty -Path "Registry::HKEY_CLASSES_ROOT\pachca" -Name "(Default)" -Value "URL:Pachca Protocol"
New-ItemProperty -Path "Registry::HKEY_CLASSES_ROOT\pachca" -Name "URL Protocol" -Value "" -Force
New-Item -Path "Registry::HKEY_CLASSES_ROOT\pachca\shell\open\command" -Force
Set-ItemProperty -Path "Registry::HKEY_CLASSES_ROOT\pachca\shell\open\command" -Name "(Default)" -Value "`"$exePath`" `"%1`""

Linux

# Создайте файл
cat > ~/.local/share/applications/pachca-handler.desktop << 'EOF'
[Desktop Entry]
Name=Pachca
Exec=pachca %u
Type=Application
MimeType=x-scheme-handler/pachca;
EOF

# Зарегистрируйте
xdg-mime default pachca-handler.desktop x-scheme-handler/pachca
update-desktop-database ~/.local/share/applications/

Если после всех шагов не заработало — напишите в поддержку. Поясните, на каком шаге вы остановились и где видите ошибку.