--- sourceDocument: Xanadu 애플리케이션과의 통합 생성 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications Release : - xanadu ft:locale : - ko-KR ft:publication_title : - Xanadu 애플리케이션과의 통합 생성 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # SSH 단계 # SSH 단계 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 SSH 단계는 ServiceNow® MID 서버를 통해 외부 \*nix 시스템에서 SSH 명령을 실행합니다. 이 단계에서는 \*nix 시스템에 대한 스크립트와 명령도 저장합니다. 주: * 이 단계를 수행하려면 Integration Hub 구독이 필요합니다. 자세한 내용은 [법무 일정 - 통합 허브 개요를](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf) 참조하십시오. * Integration Hub 는 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://www.servicenow.com/docs/access?context=sanitize-shell-arguments-transform-functions&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US)를 사용하여 인수를 삭제함으로써 명령 필드에서 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 유효성을 검사합니다. 이 변환 함수 범주는 데이터 알약을 명령 입력에 놓으면 자동으로 표시됩니다. ## 필드 {#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=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 참조하세요. | | 연결 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 [자격 증명, 연결 및 별칭을](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 참조하세요. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다. 이 필드는 연결 목록에서 연결 별칭 사용을 선택한 경우에 사용할 수 있습니다. | | 자격 증명 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 자격 증명 별칭입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명을 구성하지 않아도 됩니다. 마찬가지로 자격 증명 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 [자격 증명, 연결 및 별칭을](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 참조하세요. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 알약으로 표시됩니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. 주: SSH 단계에는 SSH 개인 키 자격 증명 또는 SSH 자격 증명을 지원하는 자격 증명 기록이 필요합니다. 이 단계에서는 MID 서버 서비스 계정 사용 옵션이 선택된 Windows 자격 증명을 지원하지 않습니다. | | 호스트 | 대상 서버의 호스트 이름 또는 IP 주소입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. | | 포트 | 서버와 통신하기 위한 포트 번호입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. | | MID 선택 | 특정 MID 서버 또는 MID 클러스터를 선택하는 옵션입니다. * MID 서버 자동 선택: MID 서버를 자동으로 선택합니다. * 특정 MID 서버: 선택한 MID 서버를 사용합니다. * 특정 MID 클러스터: 선택한 MID 클러스터를 사용합니다. {#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/~bH3Mbf_Wl~v~LCZ4maeJA#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb) 참조하십시오. 주: 전처리 [스크립트 단계를](https://www.servicenow.com/docs/access?context=javascript-step-action-designer&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US) 사용하여 인수를 정리하여 명령 필드에서 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 유효성을 검사합니다. 자세한 내용은 [이스케이프 클래스 및 함수를 사용하여 인수 정리를](https://servicenow-prod.fluidtopics.net/EjJiQXh_mSeRbs6uw2~5KA#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=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 참조하세요. ## 작업 오류 평가 {#ssh-step-action-designer__id_lg2_4s3_15b} 이 단계가 실패할 경우 : 데이터 유형: Choice 다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 대한 단계 상태 코드 또는 메시지를 사용하려면 을 참조하십시오 [Action error evaluation](https://www.servicenow.com/docs/access?context=action-error-evaluation&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US). ## 고급 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_include.bash`)와 대상 호스트에 있는 별도의 파일(`.my_profile`)을 참조할 수 있습니다. 제대로 실행하려면 `${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 서버스크립트 파일.