Конфигурация быстрого запуска VPN

Общие сведения

Функция быстрого запуска VPN позволяет запускать и останавливать VPN нажатием на соответствующую кнопку на панели быстрого запуска в режиме «Мобильный» ОС СН.

Конфигурационный файл

Настройки быстрого запуска VPN задаются в конфигурационном файле /etc/xdg/vpn-helperrc.

Отображение кнопки быстрого запуска VPN задается в секции [GENERAL] параметром Enabled (по умолчанию false).

Файлы скриптов запуска, остановки и проверки статуса VPN указываются в секции [SCRIPTS]:

1. Start — скрипт запуска VPN (по умолчанию /usr/lib/astra-mobile/astra-mobile-vpn-start).
2. Status — скрипт проверки статуса VPN (по умолчанию /usr/lib/astra-mobile/astra-mobile-vpn-status). Периодичность проверки статуса задается в секции [GENERAL] параметром UpdateTimeout (по умолчанию —  3 секунды).
3. Stop — скрипт остановки VPN (по умолчанию /usr/lib/astra-mobile/astra-mobile-vpn-stop).

Выполнение скриптов от учетной записи root задается параметром AsRoot. При значении true запуск выполняется от от учетной записи root, при значении false — от имени текущего пользователя.

Скрипты по умолчанию

Скрипт запуска

Скрипт запуска VPN по умолчанию — /usr/lib/astra-mobile/astra-mobile-vpn-start.

Секция Функции содержит описания функций, включающих поддерживаемые по умолчанию реализации VPN с нужными параметрами.

Секция Выбор реализации содержит закомментированные вызовы этих функций.

Скрипт проверки статуса

Скрипт проверки статуса VPN по умолчанию — /usr/lib/astra-mobile/astra-mobile-vpn-status.

Секция Функции содержит описания функций, проверяющих статус поддерживаемых по умолчанию реализаций VPN.

Секция Выбор реализации содержит закомментированные вызовы этих функций.

Скрипт остановки

Скрипт остановки VPN по умолчанию — /usr/lib/astra-mobile/astra-mobile-vpn-stop.

Секция Функции содержит описания функций, выключащих поддерживаемые по умолчанию реализации VPN.

Секция Выбор реализации содержит закомментированные вызовы этих функций.

Порядок настройки быстрого запуска VPN

OpenConnect

1.  Отредактировать скрипт запуска VPN (/usr/lib/astra-mobile/astra-mobile-vpn-start):
   

   function main() {
    disconnect
 
#     connect_not_mpl
    connect_openconnect_impl
#     connect_vipnet_impl
#     connect_continent_ap_impl
#     connect_imitation_impl
 
    return $?
}



2.  В скрипте запуска VPN (/usr/lib/astra-mobile/astra-mobile-vpn-start) указать параметры подключения:
   
   local URL="<URL-адрес сервера VPN>"
local GROUP="<Рабочая группа>"
local USERNAME="<Имя пользователя>"
local PASSWORD="<Пароль>"

ВНИМАНИЕ! Хранение логина и пароля в открытом виде небезопасно! Рекомендуется настроить подключение по сертификатам и доработать соответствующим образом скрипт запуска.
   
   
3. Отредактировать скрипт проверки статуса VPN (/usr/lib/astra-mobile/astra-mobile-vpn-status):
   
   function main() {
#     status_not_mpl
    status_openconnect_impl
#     status_vipnet_impl
#     status_continent_ap_impl
#     status_imitation_impl
 
    return $?
}


4. Отредактировать скрипт остановки VPN (/usr/lib/astra-mobile/astra-mobile-vpn-stop):
   
   function main() {
#     disconnec_not_mpl
    disconnect_openconnect_impl
#     disconnect_vipnet_impl
#     disconnect_continent_ap_impl
#     disconnect_imitation_impl
 
    return $?
}


5. В конфигурационном файле /etc/xdg/vpn-helperrc включить запуск от учетной записи root:
   
   AsRoot=true

ViPNet

1.  Отредактировать скрипт запуска VPN (/usr/lib/astra-mobile/astra-mobile-vpn-start):
   

   function main() {
    disconnect
 
#     connect_not_mpl
#     connect_openconnect_impl
     connect_vipnet_impl
#     connect_continent_ap_impl
#     connect_imitation_impl
 
    return $?
}



2. Отредактировать скрипт проверки статуса VPN (/usr/lib/astra-mobile/astra-mobile-vpn-status):
   
   function main() {
#     status_not_mpl
#     status_openconnect_impl
     status_vipnet_impl
#     status_continent_ap_impl
#     status_imitation_impl
 
    return $?
}


3. Отредактировать скрипт остановки VPN (/usr/lib/astra-mobile/astra-mobile-vpn-stop):
   
   function main() {
#     disconnec_not_mpl
#     disconnect_openconnect_impl
     disconnect_vipnet_impl
#     disconnect_continent_ap_impl
#     disconnect_imitation_impl
 
    return $?
}


4. Если предполагается использование одного общего ключа (заданного учетной записи root), то включить запуск от учетной записи root, указав в конфигурационном файле /etc/xdg/vpn-helperrc параметр AsRoot=true. Если предполагается использование индивидуального ключа для каждого пользователя, то указать AsRoot=false.

Континент-АП

1.  Отредактировать скрипт запуска VPN (/usr/lib/astra-mobile/astra-mobile-vpn-start):
   

   function main() {
    disconnect
 
#     connect_not_mpl
#     connect_openconnect_impl
#     connect_vipnet_impl
     connect_continent_ap_impl
#     connect_imitation_impl
 
    return $?
}
   
   

2. В скрипте запуска VPN (/usr/lib/astra-mobile/astra-mobile-vpn-start) указать параметры подключения:
   
   local NAME="<Имя пользователя>"
local PASS="<Пароль>"

ВНИМАНИЕ! Хранение логина и пароля в открытом виде небезопасно! Рекомендуется настроить подключение по сертификатам и доработать соответствующим образом скрипт запуска.
   
   
3. Отредактировать скрипт проверки статуса VPN (/usr/lib/astra-mobile/astra-mobile-vpn-status):
   
   function main() {
#     status_not_mpl
#     status_openconnect_impl
#     status_vipnet_impl
     status_continent_ap_impl
#     status_imitation_impl
 
    return $?
}


4. Отредактировать скрипт остановки VPN (/usr/lib/astra-mobile/astra-mobile-vpn-stop):
   
   function main() {
#     disconnec_not_mpl
#     disconnect_openconnect_impl
#     disconnect_vipnet_impl
     disconnect_continent_ap_impl
#     disconnect_imitation_impl
 
    return $?
}


Использование других реализаций

Если используется реализация VPN, не поддерживаемая по умолчанию, необходимо либо доработать существующие скрипты, либо написать новые и указать их расположение в конфигурационном файле /etc/xdg/vpn-helperrc (см. Конфигурационный файл). В качестве шаблонов можно использовать скрипты по умолчанию (см. Скрипты по умолчанию).

Скрипт запуска VPN должен удовлетворять следующим требованиям:

• При успешном запуске VPN программа должна возвращать 0;
• При неуспешном запуске VPN программа должна возвращать 1;
• Запуск VPN не должен блокировать программу, т. е. программа выполняется, запускает VPN и сразу завершается. Процесс VPN должен продолжать существовать.

Скрипт проверки статуса VPN должен удовлетворять следующим требованиям:

• При активном VPN программа должна возвращать 0;
• При неактивном VPN программа должна возвращать 1;
  
• В случае если программа существует но по какой либо причине не удаётся реализовать функционал, программа должна возвращать -1. В данном случае система будет игнорировать обновление статуса, как будто эта программа не указана в конфигурационном файле. Рекомендуется не использовать данное поведение, а в конфигурационном файле сделать путь к программе пустым (Status=).
  

Скрипт остановки VPN должен удовлетворять следующим требованиям:

• При успешной остановке VPN программа должна возвращать 0;
• При неуспешной остановке VPN программа должна возвращать 1.