Skip to main content

コンテナでのNode.jsエージェントのインストールと設定

以下のワークフローにより、Node.jsエージェントの「新規登録」ウィザードで、コンテナにNode.jsエージェントをインストールして設定する手順を確認できます。新規にエージェントをデプロイする場合は、ウィザードを使用するのが最も簡単な方法です。

開始する前に

開始する前に、必要なものが揃っているか事前に確認してください。

  • エージェントが、Contrastインスタンスにアクセスできる必要があります。ローカル/オンプレミスのインスタンスでも、SaaS版のインスタンスでも良いです。ネットワークアクセスが制限されている環境では、プロキシを設定することができます。

  • Contrastのサポート対象テクノロジを使用しシステム要件を満たしていること。

  • 設定した値が有効になる優先順位を理解していること。

  • また、コマンドラインインターフェイス(エージェントをダウンロードするために選択したディレクトリを含む)と、ご利用になる組織のContrastサーバへのアクセスも必要です。

Node.jsエージェントのウィザードを開始

  1. エージェントウィザードを開きます。

    • Northstar左側のナビゲーションから、管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。

    • Contrast: 次のいずれかのオプションを使用します。

      • ヘッダーから新規追加を選択し、次にアプリケーションカードを選択します。

      • 管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。

  2. Under Select a language, select Node.

  3. Select the operating system you are using.

  4. Under Select application deployment method, select Install with a container.

  5. Under Select method to deploy with containers, select Dockerfile or Kubernetes (Linux only) or follow agent installation instructions (for Windows).

LinuxまたはOS Xでのインストール

Dockerfile：エージェントを使用してイメージをビルド

  1. 「エージェントを含めてビルド」で、表示されたコマンドをコピーして Dockerfileに追加します。

  2. 表示されたコマンドをコピーして、イメージをビルドします。

Dockerfile：エージェントを設定

「エージェントを設定」で、エージェントがContrastと通信するために必要な設定情報を取得するための最適なオプションを選択します。

  2. 必要に応じて、 アプリケーションを登録を選択して下さい。

    アプリケーションを登録すると、アクセス制御のためにアプリケーションをグループに割り当てることができます。また、アプリケーションにタグやメタデータを付与することができます。

  3. エージェントのバージョンが5.15.0以降の場合は、接続トークンを使用を選択します。

    この設定方法では、1つの変数を使用して認証情報の値を指定できます。

    表示されたコードをコピーし、エージェントがアクセスできる場所に接続トークンの環境変数を設定します。

  4. 続けて、エージェントのデプロイを確認します。

Kubernetes：エージェントオペレータの設定方法を選択

  1. 「エージェントオペレータの設定方法を選択」で、 Helm(推奨)または マニフェストを選択します。

  2. Helmの場合：

    1. 「valuesファイルをダウンロードして設定」で、表示されたコマンドをコピーしてvaluesファイルを作成します。

    2. Under the Install and deploy Helm chart, copy the displayed commands to complete the configuration. Skip this step if the operator is already installed.

    3. Label your namespaces to add AgentInjectors.

      kubectl label namespace/<YourNamespaceName> agents.contrastsecurity.com/agent-injectors=true

    4. 「デプロイメントにラベルを追加」 で、表示されたコマンドを使用してデプロイメントにラベルを付けます。

  3. マニフェストの場合：

    1. 「オペレータをインストール」で、表示されたコマンドをコピーしてContrastエージェントオペレータをインストールします。

    2. 「オペレータを設定」で、表示されたコマンドをコピーしてContrastエージェントオペレータを設定します。

    3. 「ワークロードに組み込み」で、表示されたコマンドをコピーして AgentInjector設定エンティティを構成します。

    4. Label your namespaces to add AgentInjectors

      kubectl label namespace/<YourNamespaceName> agents.contrastsecurity.com/agent-injectors=true

    5. 必要に応じて、「クラスタエージェントおよびエージェントを設定」で、表示されたコマンドをコピーしてこれらのエンティティを設定して下さい。

    6. Optionally, under Configure agent (optional), copy the displayed commands to configure these entities.

  4. 続けて、エージェントのデプロイを確認します。

Windowsでのインストール

エージェントを使用してイメージをビルド

  1. 「エージェントを含めてビルド」で、表示されたコマンドをコピーして Dockerfileに追加します。

  2. エージェントを含めるよう、表示されたコマンドを使用してアプリケーションのコマンドを変更します。

  3. 表示されたコマンドをコピーして、イメージをビルドします。

エージェントを設定

「エージェントを設定」で、エージェントがContrastと通信するために必要な設定情報を取得するための最適なオプションを選択します。

  1. 必要に応じて、 アプリケーションを登録を選択して下さい。

    アプリケーションを登録すると、アクセス制御のためにアプリケーションをグループに割り当てることができます。また、アプリケーションにタグやメタデータを付与することができます。

  2. エージェントのバージョンが5.15.0以降の場合は、接続トークンを使用を選択します。

    この設定方法では、1つの変数を使用して認証情報の値を指定できます。

    表示されたコードをコピーし、エージェントがアクセスできる場所に接続トークンの環境変数を設定します。

  3. YAMLファイルを使用してエージェントを設定する場合は、設定をダウンロードを選択します。

    表示されたコードをコピーして実行すると、認証情報の設定を含むYAMLファイルが作成されます。

  4. 続けて、エージェントのデプロイを確認します。

Verify the agent deployment

  1. Interact with your application as you normally would. For example, interact with your application's web interface or send API commands.

  2. Select Administration, then Agent management to verify that your agent appears in the list.

  3. Verify that you see the name of your application in the list.

  4. Select Servers in the header.

  5. Verify that you see the name of your local server in the list.

このセクションの内容: