ウィザードによるフレックスエージェントのインストールと設定

以下のワークフローにより、フレックスエージェントのインストールおよび設定に必要な全ての手順を確認できます。

フレックスエージェントを使用すると、特定の言語を指定しなくても、1つのパッケージから複数のエージェントをインストールして設定できます。新いエージェントを導入するには、「新規登録」の多言語インストールのウィザードを使用するのが最も簡単です。

フレックスエージェントを使用して、導入済みのエージェントをアップグレードすることもできます。

開始する前に

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

エージェントが、Contrastインスタンスにアクセスできる必要があります。ローカル/オンプレミスのインスタンスでも、SaaS版のインスタンスでも良いです。ネットワークアクセスが制限されている環境では、プロキシを設定することができます。
設定した値が有効になる優先順位を理解していること。
対応言語: .NET, Java, Node.js, Python, PHP
対応OS：Linux
また、コマンドラインインターフェイス(エージェントをダウンロードするために選択したディレクトリを含む)と、ご利用になる組織のContrastサーバへのアクセスも必要です。

フレックスエージェントのウィザードを起動

エージェントウィザードを開きます。
- Northstar左側のナビゲーションから、管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。
- Contrast: 次のいずれかのオプションを使用します。
  - ヘッダーから新規追加を選択し、次にアプリケーションカードを選択します。
  - 管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。

Select installation method

Under Select installation method, select On a server or VM or On Kubernetes.
Under Select method to configure agent operator, select Helm charts (recommended) or Manifest.
For Helm charts:
1. Under Download and set up the values file, copy the displayed commands to create a values file. Skip this step if the operator is already installed.
  注記
  If you need a Helm chart with all possible Helm settings, you can generate a comprehensive YAML file in NorthstarNorthstar.
  If you have multiple agent keys, select the one you want to use. The full YAML file will not come with your agent key (tokenValue) inserted. If you decide to work with the full YAML file, ensure you copy your tokenValue and the values in the Download YAML code block displayed the wizard.
2. Under Install and deploy Helm chart, copy the displayed commands to complete the configuration. Skip this step if the operator is already installed.
3. Label namespaces to add AgentInjectors
```
kubectl label namespace/<YourNamespaceName> agents.contrastsecurity.com/agent-injectors=true
```
4. Under Label deployments, use the displayed commands to label your deployments.
For Manifest:
1. Under Install operator, copy the displayed commands to install the Contrast agent operator.
2. Under Configure operator, copy the displayed commands to configure the Contrast agent operator.
  If you have multiple agent keys, select the one you want to use.
  注記
  If you need a Kubernetes secret containing the necessary connection keys to authenticate to Contrast, you can download the YAML file in NorthstarNorthstar.
  The Secret must be deployed into the same namespace as the ClusterAgentConnection entity.
  Run the command displayed in the wizard to apply the secrets.yaml file.
3. Create or download the clusterAgentConnection.yaml file. Run the command displayed in the wizard to apply the configuration file.
4. Under Configure injector, copy or download the clusterAgentInjector.yaml.
5. Label your namespaces to add AgentInjectors
```
kubectl label namespace/<YourNamespaceName> agents.contrastsecurity.com/agent-injectors=true
```
6. Under Label the deployments, use the displayed commands to label your deployments.
7. Optionally, under Configure agent (optional), copy the displayed commands to configure these entities.

エージェントのデプロイを確認

フレックスエージェントをインストールしたら、アプリケーションを再起動します。
通常どおりにアプリケーションを使用して下さい。例えば、アプリケーションのWebインターフェイスを操作したり、API コマンドを送信してみて下さい。
Select View agent activity.
一覧にアプリケーション名が表示されていることを確認します。
Contrast Webインターフェイスのナビゲーションバーで、「サーバ」を選択します。
一覧にサーバ名が表示されていることを確認します。

フレックスエージェントのログを設定

トラブルシューティングの目的で、インジェクタのログレベルを詳細に設定することができます。設定するには、アプリケーションの起動コマンドに環境変数CONTRAST_FLEX_INJECTOR_LOG_LEVEL=TRACEを追加します。この環境変数をグローバルに設定すると、ログが非常に詳細になります。