Skip to main content

優先順位

設定値が有効になる順序は、以下の優先順位を使用します:

order_of_precedence.png
  1. ライセンスの有効期限が切れていたり、ライセンス数を超えていたりすると、設定に関係なく全てのエージェントの動作が無効になります。

  2. コマンドラインまたはシステムのプロパティ値(使用している言語に合わせて適切なプロパティが指定されている場合)

    例:-Dcontrast.enable

  3. 環境変数

    例:CONTRAST__ENABLE

  4. アプリケーション固有の設定ファイル(.NET Frameworkのみ)

    例:web.config

  5. YAMLファイルの設定値。 設定値は、全てのファイルから取得され、最も優先順位が高いファイルから値が使用されます。

    例えば、現在の作業ディレクトリにあるcontrast_security.yaml でapplication.tagsにアプリケーション固有の値があり、/etc/contrast/contrast_security.yamlに組織レベルの接続情報がある場合、エージェントは両方にアクセスすることになります。/etc/contrast/contrast_security.yamlにもapplication.tagsのデフォルト値がある場合、現在の作業ディレクトリの設定にある値のみが、優先順位が高いものとして、読み込まれます。application.tagsの2つの値は結合されません。

    1. ユーザが指定したYAMLファイル

      例:

    2. 現在の作業ディレクトリにあるcontrast_security.yamlファイル(Javaを除く全てのエージェント)

      例:./contrast_security.yaml

    3. アプリケーションの構成ディレクトリにあるcontrast_security.yamlファイル(RubyおよびPythonのみ)

      例:

      • Ruby on Rails:./config/contrast_security.yaml

      • Django:./settings/contrast_security.yaml

    4. エージェント固有の設定ディレクトリにあるcontrast_security.yamlファイル。エージェントがサービスを使用しており、エージェントとサービスに個別のYAMLファイルを使用する必要がある場合に、このディレクトリを使用します。

      例:

      • /etc/contrast/agentname/contrast_security.yaml (agentnameは次のいずれか:dotnetgojavanodepythonruby、 webserver)

      • %ProgramData%\contrast\agentname\contrast_security.yaml(agentnameは次のいずれか:dotnetdotnet-corejavanodepythonruby、 webserver)

    5. サーバの/etc/contrastディレクトリ内にあるcontrast_security.yamlファイル(.NET Frameworkと.NET Core以外の全てのエージェント)。エージェントがサービスを使用しており、エージェントとサービス間で共有するYAMLファイルを使用する必要がある場合に、このディレクトリを使用します。

      例:

      • /etc/contrast/contrast_security.yaml

      • %ProgramData%\contrast\contrast_security.yaml

  6. Contrast Webインターフェイスで設定されている値

    例:Contrast WebインターフェイスでのAssessやProtectモードのトグルボタンでの切り替えは、assess.enableprotect.enableに対応付けられます。

  7. Contrast Securityが設定したデフォルト値

関連項目

その他の設定