--- sourceDocument: Yokohama ビルドのワークフロー sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/build-workflows Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama ビルドのワークフロー ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # SSH ステップ # SSH ステップ {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年05月16日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分 SSH ステップでは、ServiceNow® MID サーバー を通じて SSH コマンドを外部 \*nix システムで実行します。また、このステップでは、\*nix システムのスクリプトとコマンドも保存されます。 注: * このステップには 統合ハブ のサブスクリプションが必要です。詳細については、「[Legal schedules - 統合ハブ overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf) * 統合ハブ は ServiceNow SSH のみをサポートしています。 {#ssh-step-action-designer__ul_idx_5dn_qhb} ## ロールと可用性 {#ssh-step-action-designer__section_anz_xst_khb} SSH ステップは ワークフロースタジオ のアクションステップとして利用可能です。action_designer ロールを持つユーザーは、1 つ以上のアクションステップを使用してカスタムアクションを作成できます。 ## 入力のサニタイズ {#ssh-step-action-designer__section_gqd_cy4_qhb} すべてのユーザー入力をエスケープして、悪意のあるユーザーがターゲットサーバー上で任意のコマンドを実行する可能性を排除します。コマンドフィールドでデータピルを使用する前に、[シェル引数のサニタイズ変換関数](https://servicenow-prod.fluidtopics.net/ufTVi25uvI9j8wPamClpkA "シェル引数のサニタイズ変換関数を使用して、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=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 | | 接続エイリアス | アクションステップを実行するために使用される接続および資格情報エイリアスレコード。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。また、接続情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「[資格情報、接続、およびエイリアス](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。このフィールドは、接続リストから \[接続エイリアスを使用\] が選択されている場合に利用可能です。 | | 認証情報エイリアス | アクションステップを実行するために使用される認証情報エイリアス。flow_designer または admin ロールを持つユーザーは、関連する接続レコードを作成または選択できます。エイリアスを使用することで、複数の環境でアクションを使用する場合に、複数の認証情報を構成する必要がなくなります。また、認証情報が変更された場合に、カスタムアクションを更新する必要がありません。接続と資格情報の詳細については、「[資格情報、接続、およびエイリアス](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 認証情報の値は、データパネルにパスワード (双方向暗号化) データピルとして表示されます。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 注: SSH ステップには、SSH プライベートキー認証情報または SSH 認証情報のいずれかをサポートする認証情報レコードが必要です。このステップは、\[MID サーバーのサービスアカウントを使用する\] オプションが選択されている Windows 資格情報をサポートしていません。 | | ホスト | ターゲットサーバーのホスト名または IP アドレス。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 | | ポート | サーバーと通信するポート番号。このフィールドは、接続リストから \[インラインで接続を定義\] が選択されている場合に利用可能です。 注: 1 から 65535 までの有効な値を指定してください。その他の値を指定すると、値はデフォルトで 22 に設定されます。 | | MID 選択 | 特定の MID サーバーまたは MID クラスターを選択するオプション。次のいずれかのオプションを選択します。 * MID サーバーの自動選択: ServiceNow インスタンスは手動入力なしで MID サーバー を選択します。 * 特定の MID サーバー: ServiceNow インスタンスは、指定した MID サーバー を使用します。 * 特定の MID クラスター: ServiceNow インスタンスは、指定した MID クラスターを使用します。 MID クラスターは、 ServiceNow インスタンスが複数の統合を処理できるようにする MID サーバーのグループであり、統合速度を向上させます。詳細については、「[Configure a MID Server cluster](https://www.servicenow.com/docs/access?context=t_ConfigureAMIDServerCluster&version=yokohama&pubname=yokohama-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/cljnRmZyWnTQt26jRe7~uw#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb)」を参照してください。 注: コマンドフィールドでデータピルを使用する前に、前処理[スクリプトステップ](https://servicenow-prod.fluidtopics.net/KBoZv0BOISJp0li1~KkKmA "再利用可能なアクションの中実行するカスタムの JavaScript を追加します。ほとんどのコア アクションおよびステップは一般的な使用例に適していますが、コア ステップでは満たされない動作を実行するスクリプト ステップを作成できます。")を使用して引数をサニタイズすることにより、データピルをエスケープして検証します。詳細については、「[エスケープクラスと関数を使用した引数のサニタイズ](https://servicenow-prod.fluidtopics.net/WBL9z~~uyA6Wo64j08VfCQ#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=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。 ## アクションエラー評価 {#ssh-step-action-designer__id_lg2_4s3_15b} このステップが失敗した場合 : データタイプ：Choice 次のステップの実行を続行するか、エラー評価に進むオプション。カスタムアクションのエラー条件のステップのステータスコードやメッセージを使用するには、「[アクションエラー評価](https://servicenow-prod.fluidtopics.net/I4OsrWdiNF4J~7LkWG~O7w "アクションを有効化してステップの失敗を検出し、実行を継続します。特定のエラー状態が発生するタイミングを特定して、独自のアクションステータスコード、ステータスメッセージ、エラー状態を返します。")」を参照してください。 ## SSH スクリプトの詳細オプション {#ssh-step-action-designer__adv-ssh-section_l1v_jqk_phb} ターゲットホストで MID サーバー スクリプトを実行するには、スクリプトのタイプを指定して、スクリプトの名前を `${syncFile()}` パラメーターに渡します。システムでは、このパラメーターを使用して、MID サーバー スクリプトファイル \[ecc_agent_script_file\] テーブル内の名前付きのスクリプトを見つけ、ターゲットホストで実行します。たとえば、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 サーバースクリプトファイル.