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

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

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

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

開始する前に

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

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

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

エージェントウィザードを開きます。
- Northstar左側のナビゲーションから、管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。
- Contrast: 次のいずれかのオプションを使用します。
  - ヘッダーから新規追加を選択し、次にアプリケーションカードを選択します。
  - 管理 > エージェント管理を選択します。次に、表示画面の上部にあるエージェントの追加を選択します。
「言語を選択」で、多言語インストールを選択します。
Under Select Operating System, select Linux.

Select deployment method

Under Select deployment method, select Install manually or Install with a container.
Under Select method to deploy with containers, select Kubernetes.
Under Select method to configure agent operator, select Helm (recommended) or Manifest.
For Helm:
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.
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.
3. Under Configure injector, copy or download the clusterAgentInjector.yaml.
4. Label your namespaces to add AgentInjectors
```
kubectl label namespace/<YourNamespaceName> agents.contrastsecurity.com/agent-injectors=true
```
5. Under Label the deployments, use the displayed commands to label your deployments.
6. Optionally, under Configure agent (optional), copy the displayed commands to configure these entities.

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

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

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

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