SSH 단계
SSH 단계는 ServiceNow® MID 서버를 통해 외부 *nix 시스템에서 SSH 명령을 실행합니다. 이 단계에서는 *nix 시스템에 대한 스크립트와 명령도 저장합니다.
주:
- 이 단계를 수행하려면 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - IntegrationHub 개요를 참조하십시오.
- Integration Hub 은 SSH만 지원합니다 ServiceNow .
역할 및 가용성
SSH 단계는 작업 단계로 사용할 수 작업 디자이너 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.
입력 정리
악의적인 사용자가 대상 서버에서 임의의 명령을 실행할 가능성을 제거하기 위해 모든 사용자 입력을 이스케이프합니다. 셸 인수 변환 함수를 사용하여 인수를 삭제하여 명령 필드가 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 유효성을 검사합니다. 이 변환 기능 범주는 데이터 알약을 명령 입력에 놓을 때 자동으로 나타납니다.
필드
| 필드 | 설명 |
|---|---|
| 연결 상세 정보 | |
| 연결 | 사용할 연결의 유형입니다.
연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭 소개를 참조하세요. |
| 연결 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 연결 및 자격 증명 별칭 기록입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명과 연결 정보 프로필을 구성하지 않아도 됩니다. 마찬가지로 연결 정보가 변경되면 사용자 지정 동작을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하십시오. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 정제로 표시됩니다. 이 필드는 연결 목록에서 연결 별칭 사용을 선택한 경우에 사용할 수 있습니다. |
| 자격 증명 별칭 | 시스템에서 작업 단계를 실행하는 데 사용하는 자격 증명 별칭입니다. flow_designer 또는 관리자 역할을 가진 사용자는 연결된 연결 기록을 만들거나 선택할 수 있습니다. 별칭을 사용하면 여러 환경에서 작업을 사용할 때 여러 자격 증명을 구성하지 않아도 됩니다. 마찬가지로 자격 증명 정보가 변경되면 사용자 지정 작업을 업데이트할 필요가 없습니다. 연결 및 자격 증명에 대한 자세한 내용은 자격 증명, 연결 및 별칭을 참조하십시오. 자격 증명 값은 데이터 패널에 암호(2단계 암호화) 데이터 정제로 표시됩니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. 주: SSH 단계에는 SSH 개인 키 자격 증명 또는 SSH 자격 증명을 지원하는 자격 증명 기록이 필요합니다. 이 단계에서는 MID Server 서비스 계정 사용 옵션이 선택된 Windows 자격 증명을 지원하지 않습니다. |
| 호스트 | 대상 서버의 호스트 이름 또는 IP 주소입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. |
| 포트 | 서버와 통신하기 위한 포트 번호입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택한 경우에 사용할 수 있습니다. |
| MID 선택 |
특정 MID Server 또는 MID 클러스터를 선택하는 옵션입니다.
|
| MID 애플리케이션 | 를 MID 서버 사용하여 SSH 단계를 실행하는 옵션입니다. 이 필드는 연결 목록에서연결 인라인 정의를 선택하고 MID 선택 목록에서 MID Server 자동 선택을 선택한 경우에 사용할 수 있습니다. |
| 역량 | 의 기능입니다 MID 서버. SSH를 선택합니다. 이 필드는 연결 목록에서연결 인라인 정의를 선택하고 MID 선택 목록에서 MID Server 자동 선택을 선택한 경우에 사용할 수 있습니다. |
| MID Server | 필요한 MID 서버데이터 알약입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택하고 MID 선택 목록에서 특정 MID Server 를 선택한 경우에 사용할 수 있습니다. |
| MID 클러스터 | 사용하려는 MID 클러스터에 대한 데이터 정제입니다. 이 필드는 연결 목록에서 연결 인라인 정의를 선택하고 MID 선택 목록에서 특정 MID 클러스터 를 선택한 경우에 사용할 수 있습니다. |
| SSH 구성 | |
| 작업 디렉터리 | 명령이 실행되는 대상 호스트의 선택적 대상 디렉터리입니다. |
| 명령 | 대상 디렉터리에서 실행되는 명령입니다. 이 명령에는 스크립트도 포함될 MID 서버 수 있습니다. 자세한 내용은 고급 SSH 스크립트 옵션을 참조하십시오. 주: 전처리 스크립트 단계를 사용하여 인수를 삭제하여 명령 필드가 데이터 알약을 사용하기 전에 데이터 알약을 이스케이프하고 유효성을 검사합니다. 자세한 내용은 이스케이프 클래스 및 함수를 사용하여 인수 삭제를 참조하세요. |
| 장기간 실행 | 실행하는 데 기본 시간인 120초보다 오래 걸릴 수 있는 명령에 대해 SSH 연결 시간 제한을 비활성화하는 옵션입니다. 이 옵션을 선택하면 완료될 때까지 엔진이 실행 스레드에서 분리됩니다. |
| Sudo 모드 | 스크립트를 실행할 수 있는 권한을 상승시키는 옵션입니다. |
작업 오류 평가 필드
| 필드 | 설명 |
|---|---|
| 이 단계가 실패할 경우 | 다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 대한 단계 상태 코드 또는 메시지를 사용하려면 을 참조하십시오 작업 오류 평가. |
고급 SSH 스크립트 옵션
대상 호스트에서 스크립트를 실행 MID 서버 하려면 스크립트 유형을 지정하고 스크립트의 이름을
${syncFile()}매개변수에 전달합니다. 시스템은 이 매개변수를 사용하여 스크립트 파일 [ecc_agent_script_file] 테이블에서 MID 서버 명명된 스크립트를 찾고 대상 호스트에서 실행합니다. 예를 들어 bash 스크립트는 다음과 같이 표현할 수 있습니다. bash ${syncFile("<MID script name>")} 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 서버 스크립트 목록을 보려면 다음으로 이동합니다. .