---
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) 소요 시간: 7분

SSH 네트워크 프로토콜을 사용하는 대상 호스트에서 데이터를 추출하는 활동을 생성합니다.

## 시작하기 전에

필요한 역할: activity_creator 또는 workflow_admin

## 이 태스크 정보

활동 템플릿 프로세스 흐름 사용에 대한 지침은 [사용자 지정 활동 생성](https://servicenow-prod.fluidtopics.net/ii2G_13mQolEF~CcfYxxyg "사용자 지정 템플릿을 사용하여 워크플로우 편집기에서 다양한 유형의 사용자 지정 활동을 만들고 업데이트할 수 있습니다.")을 참조하십시오.

## 프로시저

1. [사용자 지정 활동을](https://servicenow-prod.fluidtopics.net/ii2G_13mQolEF~CcfYxxyg "사용자 지정 템플릿을 사용하여 워크플로우 편집기에서 다양한 유형의 사용자 지정 활동을 만들고 업데이트할 수 있습니다.") 생성합니다.  
   이 작업은 템플릿을 사용하여 사용자 지정 활동을 작성합니다.
2. [일반 속성을](https://servicenow-prod.fluidtopics.net/kCnLmf9qL8MFgpTPrKQDyQ "다음 일반 속성 필드는 모든 활동 디자이너 템플릿에 공통적으로 적용됩니다.") 설정하고 [입력 변수를 생성](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#CreateInputVariables "활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.")한 후 SSH 실행 명령을 구성합니다.

   | 옵션 | 설명 |
   | [입력 변수 매핑](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#t_MapAnInputVariable "입력 변수를 생성한 후 명령 실행 양식의 필드에 매핑합니다.") | 만든 변수를 사용하여 오케스트레이션에서 실행할 명령을 구성합니다. |
   | 대상 호스트 | 이 활동에 대한 대상 서버의 호스트 이름 또는 IP 주소입니다. |
   | 명령 | 대상 호스트에서 이 활동이 실행되는 명령입니다. SSH 명령줄이 지원하는 스크립트 유형을 사용하여 이 필드에서 MID 서버 스크립트를 호출할 수 있습니다. 자세한 내용은 표 아래의 고급 SSH 스크립트 옵션을 참조하세요. |
   | 디렉터리 | 명령이 실행되는 대상 호스트의 디렉터리입니다. |
   | 자격 증명 태그 | 명령을 실행할 때 사용할 오케스트레이션 자격 증명 태그입니다. |
   | 필요한 MID 서버 역량 | 호스트에 연결하기 위한 적절한 기능이 있는 MID 서버. 기본적으로 시스템은 SSH 기능이 있는 MID 서버를 선택합니다. |
   | 장기간 실행 | 이 옵션을 선택하면 실행하는 데 기본값인 60초 보다 더 오래 걸릴 수 있는 명령에 대해 SSH 연결 시간 제한을 사용하지 않도록 설정합니다. 오케스트레이션은 실행 중인 프로세스를 주기적으로 검사하여 완료될 때까지 상태를 확인합니다. |
   | Sudo 필요 | 이 옵션을 선택하면 [sudo](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 를 사용하여 명령을 실행할 수 있습니다. |
   |-|-|

   {#t_CreateAnSSHActivity__choicetable_j2l_k2s_d1b}  
   주:  
   테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 . [자동 매핑 출력 변수를](https://servicenow-prod.fluidtopics.net/1V~h9Lmkn7Uze8P1bbOKSw "테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 .") 참조하십시오.

## 고급 SSH 스크립트 옵션

대상 호스트에서 스크립트를 실행 MID 서버 하려면 스크립트 유형을 지정하고 `스크립트 이름을 ${syncFile()}` 매개변수에 전달합니다. 시스템은 이 매개변수를 사용하여 MID 서버 스크립트 파일\[ecc_agent_script_file\] 테이블에서 명명된 스크립트를 찾고 대상 호스트에서 실행합니다. 예를 들어 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 

## 다음에 수행할 작업

* [자동 매핑](https://servicenow-prod.fluidtopics.net/1V~h9Lmkn7Uze8P1bbOKSw "테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 .")을 사용하여 출력 및 구문 분석 규칙 작성
* 자동 매핑을 사용하지 않는 경우 [수동으로 출력 변수를 만들고](https://servicenow-prod.fluidtopics.net/_deqfM66q1JCmFBYL2dyDg#t_CreateAnOutputVariable "디자이너의 출력 양식에는 개체 및 배열의 데이터 구조를 만들기 위한 변수 작성기가 포함되어 있습니다.")[구문 분석 규칙을 만들 수 있습니다](https://servicenow-prod.fluidtopics.net/wpFk5f3z63DSYYFUiJ8p1g#t_CreateAParsingRule "사용자 지정 활동에 정의된 출력 변수를 외부 호스트 또는 엔드포인트의 입력 테스트에서 반환된 페이로드 데이터로 채웁니다.")
{#t_CreateAnSSHActivity__ul_u45_vbq_xz}

## SSH 템플릿 실행 매개변수 {#ariaid-title2}

실행 매개변수를 사용하여 활동 디자이너의 전처리 양식에서 입력 프로세스 스크립트를 생성합니다.
명령 필드에 대한 설명은 을 참조하십시오 [SSH 실행 명령 구성](https://servicenow-prod.fluidtopics.net/N6betteTEtSV3ybGAmOekw#t_MapSSHVariablesToExecutionCommand "사용자가 만든 입력 변수를 사용하여 오케스트레이션이 호스트 대상에서 실행할 명령을 구성합니다.").  
주:  
이 테이블의 모든 변수에 `executionParam.` 접두사를 사용해야 합니다.  
{#r_SSHTemplateExecutionParameters__table_wl1_yxc_dr__entry__4}

| 이름 | 변수 | 유형 | 사용법 |
|-|-|-|-|
| 소스 | 소스 | 문자열 | 의도한 대상 또는 호스트입니다. |
| 명령 | 명령 | 문자열 | 호스트에서 실행할 코멘트입니다. |
| 디렉터리 | 디렉터리 | 문자열 | 명령을 실행할 호스트의 디렉터리입니다. |
| 자격 증명 태그 | credential_tag | 문자열 | 명령을 실행할 때 사용할 오케스트레이션 자격 증명 태그입니다. |
| 미드역량 | midCapabilities | 문자열(쉼표로 구분) | 필요한 MID 서버 역량 목록입니다. |
| 값 역량 | valueCapabilities (영문) | 해시맵의 배열 | MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 [MID 서버 기능](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform&section=r_MIDServerCapabilities&ft:locale=en-US)을 참조하십시오. 값에 의해 할당된 추가 역량이 있는 경우 다음 예를 사용하여 MID 서버 선택을 사용자 지정합니다. var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); |
| 장기간 실행 | long_running | 부울 | 명령이 장기 실행 중인지 여부를 나타냅니다. true 값은 명령이 오래 실행 중임을 나타냅니다. |
| sudo 필요 | must_sudo | 부울 | 이 활동에서 루트 명령을 실행하기 위해 sudo를 사용해야 하는지 여부를 나타냅니다. true 값은 [sudo](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) [SSH 자격 증명을](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 사용해야 함을 나타냅니다. |
[표 1. SSH 실행 매개변수]

{#r_SSHTemplateExecutionParameters__table_wl1_yxc_dr}

## SSH 후처리 매개변수 및 페이로드 구문 분석 {#ariaid-title3}

이러한 매개변수를 사용하여 후처리 스크립트, 페이로드 구문 분석 및 태그 지정을 생성합니다.
{#SSH-payload-parsing-tags__table_nzv_q1d_dr__entry__4}

| 이름 | 변수 | 유형 | 사용법 |
|-|-|-|-|
| 출력 | 출력 | 문자열 | SSH 명령에서 반환된 출력을 포함합니다. |
| EccSysID | eccSysID | 문자열 | 활동에서 리턴한 ECC 큐 입력 메시지와 연관된 참조 ID를 포함합니다. |
| 오류 메시지 | errorMessages | 문자열 | SSH 명령에서 검색된 오류 메시지를 포함합니다. 오류 메시지가 없는 경우 이 값은 null 입니다. |
| 태그 | 태그 | SSH 명령에서 반환된 태그 값의 해시맵 | SSH 명령을 사용하여 출력을 추출하는 데 사용되는 태그를 포함합니다. 태그 출력은 `%%tagname%% ... %%`와 같이 이중 백분율 기호로 구분됩니다. 다음 형식을 사용하여 명령을 설정합니다. %%tagname1%% output1 line 1 output1 line 2 ... %% %%tagname2%% output2 line 1 output2 line 2 ... %% 반환되는 태그는 각 키에 태그 이름이 추가된 `태그` 가 접두사로 붙는 JavaScript 해시맵 객체입니다. {"__text__": "", "tagtagname1":"output1 line1\noutput1 line2\n", "tagtagname2":"output2 line1\noutput2 line2\n"} |
[표 2. SSH 후처리 매개변수]

{#SSH-payload-parsing-tags__table_nzv_q1d_dr}

## SSH 실행 명령 구성 {#ariaid-title4}

사용자가 만든 입력 변수를 사용하여 오케스트레이션이 호스트 대상에서 실행할 명령을 구성합니다.

### 시작하기 전에

명령 실행 단계로 진행하기 전에 입력 양식에서 필요한 입력 변수를 생성합니다.

필요한 역할: activity_creator, admin  
주:  
워크플로우 컨텍스트에서 활성화를 실행할 필요 없이 MID 서버와 대상 간의 SSH 연결을 테스트할 수 있습니다. 자세한 내용은 테스트 템플릿 출력을 참조하십시오.

### 프로시저

1. 입력 목록에서 변수를 끌어 명령 필드에 놓습니다.  
   시스템은 명령에 적합한 구문으로 변수 형식을 지정합니다.  
   그림 1. SSH 실행 명령
2. 테이블에 표시된 필드를 모두 채우십시오.  
   {#t_MapSSHVariablesToExecutionCommand__table_xf4_kvc_dr__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 입력 | 입력 변수 작성기입니다. [입력 변수 생성](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#CreateInputVariables "활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.") 을 클릭하여 사용 가능한 필드에 매핑합니다. |
   | 대상 호스트 | 이 활동에 대한 대상 서버의 호스트 이름 또는 IP 주소입니다. |
   | 명령 | 대상 호스트에서 이 활동이 실행되는 명령입니다. SSH 명령줄에서 지원하는 모든 스크립트 유형을 사용하여 이 필드에서 MID 서버 스크립트를 호출할 수 있습니다. 자세한 내용은 표 아래의 고급 SSH 스크립트 옵션을 참조하세요. |
   | 디렉터리 | 명령이 실행되는 대상 호스트의 디렉터리입니다. |
   | 자격 증명 태그 | 명령을 실행할 때 사용할 [오케스트레이션 활동의 자격 증명 별칭](https://www.servicenow.com/docs/access?context=c_AssignCredsOrchActivities&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 입니다. |
   | 역량별로 MID 서버 선택 | 호스트에 연결하기 위한 적절한 기능이 있는 MID 서버. 기본적으로 시스템은 SSH 기능이 있는 MID 서버를 선택합니다 |
   | 장기간 실행 | 실행하는 데 기본값인 60초 보다 더 오래 걸릴 수 있는 명령에 대해 SSH 연결 시간 제한을 사용하지 않도록 설정하려면 이 확인란을 선택합니다. 오케스트레이션은 실행 중인 프로세스를 주기적으로 검사하여 완료될 때까지 상태를 확인합니다. |
   | Sudo 필요 | [SSH 자격 증명을](https://www.servicenow.com/docs/access?context=r_SSHCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 사용하여 명령을 실행할 수 있도록 허용하는 확인란입니다. |
   [표 3. SSH 활동 입력]

   {#t_MapSSHVariablesToExecutionCommand__table_xf4_kvc_dr}
3. 저장을 클릭합니다.
4. Continue(계속)를 클릭하여 Outputs(출력) 단계로 이동합니다.
{#t_MapSSHVariablesToExecutionCommand__steps_pr1_jlm_s5}