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

그룹을 시작하기 전에 모든 구성원을 검토하세요. 그룹 작업은 여러 실제 리스너를 시작할 수 있습니다. 전체 그룹이 아닌 하나의 프로필을 중지하려면 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와 별개입니다.

이해하고 신뢰하는 스크립트만 활성화하세요. 내보낸 스크립트 예제에 비밀을 입력하지 마세요. 이후 작업이 연결 준비에 따라 달라지는 경우 내장 예제의 제한된 상태 대기 패턴을 사용하고 영원히 기다리는 대신 실패 상태를 처리하세요.