Автоматизация с помощью AppleScript и spcli

Запускайте сохраненные соединения и группы тегов из скриптов, сохраняя при этом конфигурацию соединений в приложении.

Встроенный справочник

Откройте Автоматизация. Он предоставляет вкладки AppleScript и Командная строка (spcli) с редактируемыми примерами и элементами управления копированием. Начните с перечисления имен, а не с угадывания их.

Автоматизация – это функция версии Pro после общей семидневной пробной версии. macOS может запросить у вызывающего приложения, например Терминала, разрешение на управление Secure Pipes. Разрешите это только тому абоненту, которому вы доверяете.

Список подключений через AppleScript

osascript -e 'tell application "Secure Pipes" to list connections'

Используйте возвращаемое имя в последующих командах. Если имена повторяются, используйте полное имя с типом подключения, указанным в приложении.

tell application "Secure Pipes"
    connect connection "Database Tunnel (Local Forward)"
    connection status "Database Tunnel (Local Forward)"
end tell

Запуск соединения является асинхронным. Проверьте статус, а не предполагайте, что возврат команды означает, что туннель готов. Аутентификация, доверие хоста и ошибки могут потребовать внимания пользователя.

Управление группами подключений

Группы — это теги, присвоенные профилям подключения. Групповые команды действуют на соответствующие профили:

tell application "Secure Pipes"
    list connection groups
    connect group "engineering"
    disconnect group "engineering"
end tell

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

Установите и используйте spcli

В разделе Генерал → Инструмент командной строки выберите Установить spcli, если он не установлен. Откройте терминал и запустите:

spcli --help

Используйте справку установленной версии и вкладку Командная строка (spcli) для получения точных команд и параметров. Не допускайте использования закрытых ключей и паролей в аргументах команд, истории оболочки и сценариях. spcli работает на основе сохраненных настроек приложения; это не замена авторизации на стороне сервера.

Общие команды spcli

Начните с обнаружения только для чтения:

spcli list connections
spcli list groups
spcli list connections --json

Замените приведенное ниже имя демонстрационного подключения точным именем, возвращаемым установленным приложением. Запускайте каждую команду, когда вам нужно это действие; этот блок не является сценарием для одновременного запуска.

spcli connect "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)"
spcli status "Database Tunnel (Local Forward)" --json
spcli disconnect "Database Tunnel (Local Forward)"

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

Для тега с именем engineering используйте spcli connect-group "engineering" или spcli disconnect-group "engineering". Сначала проверьте членство: эти команды влияют на всю соответствующую группу.

Команда	Эффект
spcli start	Запустите Secure Pipes, не показывая его окно.
spcli show	Показать и активировать окно приложения
spcli hide	Скрыть окна приложения, не выходя из него
spcli shutdown	Выйдите из приложения; активные соединения остановлены

Для сценариев проверьте код выхода: 0 означает успешную команду, 1 — ошибку, сообщенную приложением, 2 — недопустимое использование, 3 — проблему запуска приложения или разрешения автоматизации, а 4 — ошибку отправки события Apple, тайм-аут или ошибку ответа. --json доступен для команд списка и статуса. Сохраняйте возвращаемый текст состояния, а не предполагайте, что это непереведенная константа.

Скрипты и действия после подключения

Настройки для каждого подключения могут запускать локальный сценарий или поддерживаемое действие завершения после подключения. Удаленная пересылка также предоставляет возможность удаленного сценария. Они отделены от AppleScript, управляющего приложением.

Включайте только те сценарии, которые вы понимаете и которым доверяете. Не помещайте секреты в экспортированные примеры скриптов. Используйте шаблон ограниченного ожидания состояния из встроенных примеров, когда более поздняя задача зависит от готовности соединения, и обрабатывайте состояния сбоя вместо того, чтобы ждать вечно.