SSH(Secure Shell) 커넥터 메서드

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • SSH(Secure Shell) 커넥터 방식은 SSH 연결을 설정하고, 설정된 연결을 통해 명령을 실행하고, 세션의 연결을 끊습니다.

    커넥트

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

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

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

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

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

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

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

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

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

    False인 경우 이 연결에서 실행되는 모든 명령은 셸을 실행하지 않습니다.

    기본값은 True입니다.

    데이터 입력 부울
    키보드 대화형 인증 암호는 과제로.

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

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

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

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

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

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

    데이터 입력 문자열

    RunCommand

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

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

    예: echo hello.

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

    기본값은 30입니다.

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

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

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

    연결 해제

    명령을 실행한 후 Disconnect 메서드를 사용하여 설정된 연결을 끊습니다.

    다음 예제에서는 Disconnect 메서드를 추가한 후의 전체 자동화를 보여 줍니다.

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