SSH(Secure Shell) 커넥터 메서드

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • SSH(Secure Shell) 커넥터 메서드는 SSH 연결을 설정하고, 설정된 연결을 통해 명령을 실행하고, 세션의 연결을 끊습니다.

    커넥트

    SSH 연결을 설정합니다. 원격 머신에 연결하는 데 필요한 정보를 제공합니다.

    설정 아이콘( 설정 아이콘)을 선택하여 인증 유형을 선택합니다.

    지원되는 인증 유형은 Password, KeyboardInteractive 및 KeyFileAuthentication입니다.Password, KeyboardInteractive 및 KeyFileAuthentication을 인증 유형으로 표시하는 인증 유형 구성 창입니다.

    암호는 기본 인증 유형입니다.

    표 1. 커넥트 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    호스트 이름 원격 서버의 호스트 이름 또는 IP 주소입니다. 데이터 입력 문자열
    사용자 이름 SSH 계정의 사용자 이름입니다. 데이터 입력 문자열
    암호

    암호의 보안 문자열 표현입니다. SSH 계정의 암호입니다.

    SecureStringEncode 구성 요소를 사용하여 다음 예제에 나와 있는 것처럼 보안 문자열 암호를 인코딩할 수 있습니다. 자세한 내용은 SecureStringEncode 구성요소 사용 문서를 참조하십시오.
    그림 1. 암호 매개변수를 사용하는 연결 방법
    SecureStringEncode 구성 요소는 인코딩된 암호를 전달하기 위해 Connect 메서드에 연결됩니다.

    이 작업을 수행한 후 원격 서버에 연결할 수 있습니다.

    데이터 입력 보안 문자열
    포트 옵션입니다. SSH 연결을 위한 포트 번호입니다. 기본값은 22입니다. 데이터 입력 정수
    CreateShell 옵션입니다. 예일 경우 연결 성공 시 셸 스트림이 작성됩니다. 이 연결에서 실행되는 모든 명령은 셸을 사용합니다.

    False인 경우 이 연결에서 실행 중인 명령은 셸이 적용되지 않습니다.

    기본값은 True입니다.

    데이터 입력 부울
    KeyboardInteractiveAuth 과제로서의 암호.

    True인 경우 서버는 클라이언트에 암호를 입력하라는 메시지를 표시하여 사용자의 ID를 확인합니다. 암호 매개변수에 제공된 값은 클라이언트의 응답으로 공유됩니다.

    이 매개변수는 인증 유형에서 KeyboardInteractive 를 선택한 경우에만 나타납니다.

    데이터 입력 부울
    키 파일 경로 개인 키의 경로입니다.

    이 매개변수는 인증 유형에서 KeyFileAuthentication 을 선택한 경우에만 나타납니다.

    데이터 입력 문자열
    암호 구문 옵션입니다. 개인 키가 Passphrase를 사용하여 암호화된 경우 Passphrase 매개변수 내에 개인 키를 사용할 수 있는 동일한 값이 제공됩니다.

    이 매개변수는 인증 유형에서 KeyFileAuthentication 을 선택한 경우에만 나타납니다.

    데이터 입력 문자열

    실행 명령

    SSH 연결을 설정한 후 RunCommand 메서드를 사용하여 설정된 연결을 통해 명령을 실행합니다.

    표 2. RunCommand 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    명령 메시지 또는 스크립트와 같이 원격 SSH 서버에서 실행되어야 하는 명령은 원격 서버가 이해할 수 있는 유효한 셸 명령 또는 실행 가능한 명령일 수 있습니다.

    예: echo hello.

    그림 2. RunCommand 메서드 - 명령 매개변수
    명령 매개변수 RunCommand 메서드에 "echo hello"로 입력된 명령
    데이터 입력 문자열
    시간 제한 옵션입니다. 대화형 셸을 사용할 때 SSH 서버에서 명령 출력을 기다리는 최대 시간(초)을 지정하는 매개변수입니다.

    기본값은 30입니다.

    데이터 입력 정수
    돌아가기 실행된 명령의 결과입니다.

    예를 들어 자동화를 실행한 후 반환 매개변수의 데이터 미리 보기에 "hello"가 표시됩니다.

    그림 3. RunCommand 메서드의 반환 매개변수
    명령이 실행된 후 데이터가 hello로 미리 보기됩니다.
    데이터 출력 문자열

    연결 해제

    명령을 실행한 후 연결 끊기 방법을 사용하여 설정된 연결을 끊습니다.

    다음 예는 연결 해제 방법을 추가한 후의 전체 자동화를 보여줍니다.

    그림 4. 연결 해제 방법
    SSH 커넥터 자동화 워크플로우 예시.