AppleScript および spcli で自動化する

アプリ内で接続構成を維持しながら、保存された接続とタグ付けされたグループをスクリプトから開始します。

組み込みのリファレンスを使う

自動化を開きます。編集可能な例とコピー コントロールを備えた AppleScript タブと コマンド ライン (spcli) タブが提供されます。まずは名前を推測するのではなくリストアップしてみましょう。

自動化は、7 日間の共通の試用期間終了後は 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

グループを開始する前に、すべてのメンバーを確認してください。グループ操作では、複数の実リスナーを開始できます。グループ全体ではなく 1 つのプロファイルを停止するには、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 Event の送信、タイムアウト、または応答の失敗を意味します。 --json はリストおよびステータスコマンドで使用できます。返されたステータス テキストを、翻訳されていない定数であると想定せずに保存します。

スクリプトと接続完了時の処理

接続ごとの設定では、接続後にローカル スクリプトまたはサポートされている完了アクションを実行できます。リモート転送では、remote-script オプションも公開されます。これらは、アプリを制御する AppleScript とは別のものです。

理解して信頼できるスクリプトのみを有効にしてください。エクスポートされたスクリプトの例にはシークレットを含めないでください。後のタスクが接続の準備ができているかどうかに依存する場合は、組み込み例の制限付きステータス待機パターンを使用し、永久に待機するのではなく障害状態を処理します。