.NET Frameworkエージェント(レガシー)のインストール

重要

[en] If your applications are running on modern technology you should use the .NET Framework agent instead of the legacy agent.

[en] The legacy .NET Framework agent offers the full capabilities of Contrast Assess, Protect, and OSS as of April 2020 but is no longer receiving new features or lower severity bug fixes. Contrast will continue to fix critical bugs in the legacy agent until January 10th, 2023.

エージェントをインストールするには、Editorロール権限が必要です。

Contrast .NET Frameworkエージェント(レガシー)では、以下のレガシーテクノロジを基盤として実行されるASP.NET Webアプリケーションを分析できます。

  • Windows Server 2008

  • .NET Framework version 4.7.1以降にアップグレードできないWindowsマシン

  • CLR2ランタイムに対応しており、CLR4対応にアップグレードできないアプリケーション

詳細については、レガシー.NET Frameworkエージェントのサポート対象テクノロジに関するページと、システム要件に関するページを参照してください。

レガシー.NET Frameworkエージェントをインストールするには:

  1. こちらから、レガシー.NET Frameworkエージェントをダウンロードします(ContrastSetup_20.3.1.zipなど)。

  2. Contrast Webアプリケーションで、右上のエージェントを追加を選択します。.NETエージェントを選択し、ダウンロードを選択します。これにより、エージェントで使用されるcontrast_security.yamlファイルがダウンロードされます。

    api: 
      url: <YourContrastURL>
      api_key: <YourAPIkey>
      service_key: <YourServiceKey>
      user_name: <YourUserName>
    agent:
      dotnet:
        enable_chaining: <True/False>
    
  3. contrast_security.yaml設定ファイルとエージェントのZIPファイルをWebサーバにコピーします。

  4. ダウンロードしたZIPアーカイブ(ContrastSetup_20.3.1.zipなど)をWebサーバに展開します。

  5. contrast_security.yamlファイルを、ContrastSetup.exeと同じディレクトリに移動します。

  6. ContrastSetup.exeを実行します。これで、.NETエージェントがインストールされます。

    .NETエージェントをインストールすると、IISにデプロイされたASP.NETアプリケーションが自動的に計測されます。エージェントによる分析は、ユーザーによって(または自動化されたスクリプトやテストによって)アプリケーションが操作されるときに実行されます。