--- sourceDocument: 호주 워크플로우 빌드 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/build-workflows Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 워크플로우 빌드 ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # SSH 단계 # SSH 단계 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분 SSH 단계는 ServiceNow® MID 서버를 통해 외부 \*nix 시스템에서 SSH 명령을 실행합니다. 이 단계에서는 \*nix 시스템에 대한 스크립트와 명령도 저장합니다. 주: * 이 단계를 수행하려면 통합 허브 구독이 필요합니다. 자세한 내용은 [법무 일정 - 통합 허브 개요를](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf) 참조하십시오. * 통합 허브 SSH만 지원합니다 ServiceNow . {#ssh-step-action-designer__ul_idx_5dn_qhb} ## 역할 및 가용성 {#ssh-step-action-designer__section_anz_xst_khb} SSH 단계는 작업 단계로 워크플로우 스튜디오 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 생성할 수 있습니다. ## 입력 삭제 {#ssh-step-action-designer__section_gqd_cy4_qhb} 악의적인 사용자가 대상 서버에서 임의의 명령을 실행할 가능성을 제거하려면 모든 사용자 입력을 이스케이프하십시오. [Sanitize 셸 인수 변환 함수](https://servicenow-prod.fluidtopics.net/OmoYhGWo2N3ACpTfAFdrtw "삭제 셸 인수 변환 함수를 사용하여 Bash 셸 스크립팅에 사용되는 문자열 데이터 알약에서 잠재적으로 안전하지 않은 명령 삽입을 제거합니다.")를 사용하여 인수를 삭제하여 명령 필드에서 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 확인합니다. 이 변환 함수 범주는 데이터 알약이 명령 입력에 드롭될 때 자동으로 나타납니다. ## 필드 {#ssh-step-action-designer__section_fls_2tt_khb} {#ssh-step-action-designer__table_qhj_3tt_khb__entry__2} | 필드 | 설명 | |-|-| | 연결 상세 정보 || | 연결 | 사용할 연결 유형입니다. * 연결 인라인 정의: 동작 단계 내에서 연결 정보를 정의합니다. * 연결 별칭 사용: 연결 별칭 테이블을 사용하여 연결 정보를 정의합니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 동작을 업데이트할 필요가 없습니다. {#ssh-step-action-designer__ul_bfs_tvt_khb} 연결 및 자격 증명에 대한 자세한 내용은 [자격 증명, 연결 및 별칭 소개를 참조하십시오.](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US) | | 연결 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 [자격 증명, 연결 및 별칭을 참조하십시오.](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US) 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다. 이 필드는 연결 목록에서 연결 별칭 사용을 선택한 경우에 사용할 수 있습니다. | | 자격 증명 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 자격 증명 별칭입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명을 구성하지 않아도 됩니다. 마찬가지로 자격 증명 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 [자격 증명, 연결 및 별칭을 참조하십시오.](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US) 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다. 이 필드는 연결 목록에서 연결 인라인 정의 를 선택한 경우에 사용할 수 있습니다. 주: SSH 단계에는 SSH 개인 키 자격 증명 또는 SSH 자격 증명을 지원하는 자격 증명 레코드가 필요합니다. 이 단계는 MID 서버 서비스 계정 사용 옵션이 선택된 Windows 자격 증명을 지원하지 않습니다. | | 호스트 | 대상 서버의 호스트 이름 또는 IP 주소입니다. 이 필드는 연결 목록에서 연결 인라인 정의(Define Connection Inline )를 선택한 경우에 사용할 수 있습니다. | | 포트 | 서버와 통신할 포트 번호입니다. 이 필드는 연결 목록에서 연결 인라인 정의(Define Connection Inline )를 선택한 경우에 사용할 수 있습니다. 주: 1에서 65535 사이의 유효한 값을 제공합니다. 다른 값을 제공하면 기본적으로 값이 22 로 설정됩니다. | | MID 선택 | 특정 MID 서버 또는 MID 클러스터를 선택하는 옵션입니다. 다음 옵션 중 하나를 선택합니다. * MID 서버 자동 선택: ServiceNow 인스턴스에서 수동 입력 없이 MID MID 서버 서버를 선택합니다. * 특정 MID 서버: 인스턴스에서 ServiceNow 지정한 것을 사용합니다 MID 서버 . * 특정 MID 클러스터: 인스턴스는 ServiceNow 지정한 MID 클러스터를 사용합니다. MID 클러스터는 인스턴스에서 ServiceNow 여러 통합을 처리하고 통합 속도를 개선할 수 있는 MID Server 그룹입니다. 자세한 내용은 [Configure a MID Server cluster](https://www.servicenow.com/docs/access?context=t_ConfigureAMIDServerCluster&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 문서를 참조하십시오. {#ssh-step-action-designer__ul_pxl_vdb_htb} 이 필드는 연결 목록에서 연결 인라인 정의 를 선택한 경우에 사용할 수 있습니다. | | MID 애플리케이션 | 를 MID 서버 사용하여 SSH 단계를 실행하는 옵션입니다. 이 필드는 연결 목록에서연결 인라인 정의를 선택하고 MID 선택 목록에서MID 서버 자동 선택을 선택한 경우에 사용할 수 있습니다. | | 역량 | 의 역량입니다 MID 서버. SSH를 선택합니다. 이 필드는 연결 목록에서연결 인라인 정의를 선택하고 MID 선택 목록에서MID 서버 자동 선택을 선택한 경우에 사용할 수 있습니다. | | MID 서버 | 필요한 MID 서버데이터 알약입니다. 이 필드는 연결 목록에서 연결 인라인 정의 를 선택하고 MID 선택 목록에서 특정 MID 서버를 선택한 경우에 사용할 수 있습니다. | | MID 클러스터 | 사용하려는 MID 클러스터에 대한 데이터 정제입니다. 이 필드는 연결 목록에서 연결 인라인 정의 를 선택하고 MID 선택 목록에서 특정 MID 클러스터 를 선택한 경우에 사용할 수 있습니다. | | SSH 구성 || | 작업 디렉터리 | 명령이 실행되는 대상 호스트의 선택적 대상 디렉터리입니다. | | 명령 | 대상 디렉터리에서 실행되는 명령입니다. 명령에는 스크립트도 포함될 MID 서버 수 있습니다. 자세한 내용은 [고급 SSH 스크립트 옵션을](https://servicenow-prod.fluidtopics.net/iceL5ce4ltuaJ8M9IQJY8w#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb) 참조하십시오. 주: 전처리 [스크립트 단계를](https://servicenow-prod.fluidtopics.net/tn2KwvYCpDvkMaj8pR3xmg "재사용 가능한 동작 내에서 실행하도록 사용자 지정 JavaScript를 추가합니다. 대부분의 핵심 작업과 단계는 일반적인 사용 사례에 적합하지만 스크립트 단계를 빌드하여 핵심 단계에서 충족하지 않는 동작을 실행할 수 있습니다.") 사용해 인수를 삭제함으로써 명령 필드에서 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 확인합니다. 자세한 내용은 [이스케이프 클래스 및 함수를 사용하여 인수 정리](https://servicenow-prod.fluidtopics.net/fp3Acem1ye2ao5MAghYNPw#jdbc-step__section_gqd_cy4_qhb)를 참조하세요. | | 장기간 실행 | 실행하는 데 기본 시간인 120초보다 오래 걸릴 수 있는 명령에 대해 SSH 연결 시간 제한을 비활성화하는 옵션입니다. 선택하면 완료될 때까지 엔진이 실행 스레드에서 분리됩니다. | | Sudo 모드 | 스크립트를 실행할 수 있는 권한을 상승시키는 옵션입니다. | [ ] {#ssh-step-action-designer__table_qhj_3tt_khb}자세한 내용은 [SSH 자격 증명을](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US) 참조하십시오. ## 작업 오류 평가 {#ssh-step-action-designer__id_lg2_4s3_15b} 이 단계가 실패할 경우 : 데이터 유형: Choice 다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 단계 상태 코드 또는 메시지를 사용하려면 다음 문서를 참조하십시오 [작업 오류 평가](https://servicenow-prod.fluidtopics.net/h3JedAXkUCYgRja3yw7kEw "단계를 포착하고 계속 실행하는 작업을 활성화합니다. 특정 오류 조건이 발생하는 시기를 식별하고 고유한 작업 상태 코드, 상태 메시지 및 오류 상태를 반환합니다."). ## 고급 SSH 스크립트 옵션 {#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb} 대상 호스트에서 스크립트를 실행 MID 서버 하려면 스크립트 유형을 지정하고 스크립트 이름을 `${syncFile()}` 매개변수에 전달합니다. 시스템은 이 매개변수를 사용하여 스크립트 파일 \[ecc_agent_script_file\] 테이블에서 MID 서버 명명된 스크립트를 찾아 대상 호스트에서 실행합니다. 예를 들어 bash 스크립트는 다음과 같이 표현할 수 있습니다. bash ${syncFile("")} argument1 argument2 argument3 기본 스크립트(`main_script.bash`)는 대상 호스트에 있는 별도의 파일(`.my_profile`)뿐만 아니라 다른 스크립트(`my_include.bash`)도 참조할 수 있습니다. 올바르게 실행되려면 스크립트와 참조된 파일을 $`{syncFile()}` 매개변수를 사용하여 에 동기화해야 MID 서버합니다. source ${syncFile(".my_profile")} cp ${syncFile("my_include.bash")} /usr/ssmith/my_include.bash bash ${syncFile("main_script.bash")} one two three four five six rm /usr/ssmith/my_include.bash 인라인 주석이 있는 Python 예제는 다음과 같을 수 있습니다. set $LIB_DIR=/usr/bin;. # Sync a file that is referenced inside myF5CreateLBPool.py cp ${syncFile("specialFunctions.py")} ~/specialFunctions.py # set up environment variables source ${syncFile(".python_profile")} # call script that sets up dependencies on the box from remote package repos python ${syncFile("setupPythonDependencies.py")} pycontrol # call a script that requires functions from the package as well as a function from myIncludedFile python ${syncFile("myF5CreateLBPool.py")} snow_pool myActualValue # user is responsible for their own cleanup rm ~/specialFunctions.py 사용 가능한 MID 서버 스크립트 목록을 보려면 다음으로 이동하십시오. MID 서버스크립트 파일.