DebianでPHPエージェントをインストール

https://pkg.contrastsecurity.comからエージェントパッケージを取得します。以下のコマンドで、Contrastのパッケージリポジトリをシステムに登録します。

curl \
  https://pkg.contrastsecurity.com/api/gpg/key/public | sudo apt-key add -

echo "deb https://pkg.contrastsecurity.com/debian-public/ $(sed -rne 's/^VERSION_CODENAME=(.*)$/\1/p' /etc/*ease) contrast" \
  | sudo tee /etc/apt/sources.list.d/contrast.list

echo "deb https://pkg.contrastsecurity.com/debian-public/ all contrast" \
  | sudo tee -a /etc/apt/sources.list.d/contrast.list

完了したら、以下のコマンドを実行してエージェントをインストールします。

sudo apt-get update && sudo apt-get install contrast-php-agent

PHPの設定ファイルであるphp.iniを探します。ほとんどの場合、/usr/local/etc/php/内にあります。

contrast-php-util コマンドを使用します。このコマンドはPHPエージェントと一緒にインストールされ、コマンドラインから使用することで、お使いの環境でエージェントを有効にすることができます。

contrast-php-util enable-agent

これにより、PHPが拡張モジュールを管理するために使用するスキャンディレクトリにiniファイルが作成されます。

または

PHPの設定ファイルである、php.iniを編集します。ほとんどの場合、/usr/local/etc/php/にあります。

php-configコマンドが使える場合は、php-config --ini-pathを使用して設定ファイルのパスを見つけることができます。このパスに設定ファイルがまだ存在しない場合は、作成する必要があります。

echo "extension=/usr/local/lib/contrast/php/contrast.so" >> php-config --ini-path/php.ini

php-configコマンドが使えないシステムでは、 PHPを利用してiniファイルの場所を確認できます。

php -i | grep php.ini

実行結果の「Configuration File (php.ini) Path」行にアクティブなiniファイルが表示されます。そして、そのファイルを編集して、ファイルの末尾に以下を追加してください。

 extension=/usr/local/lib/contrast/php/contrast.so

環境によっては、PHPのコマンドラインインスタンスで使用されるiniファイルが、サーバ環境でロードされるファイルと異なる場合があることに注意してください。FPMは、多くの場合、/etc/php/<php version>/fpm/ディレクトリにあるiniファイルを使用します。適切なPHPインスタンスを動かしていることを確認してください。

セットアップの完了に進みます。

必要な拡張モジュールが有効になっていることを確認します。

PHPエージェントには、mbstring、json、curlのPHP拡張モジュールがインストールされ、有効になっている必要があります。これらの拡張モジュールが有効でない場合は、php.ini設定ファイルを編集して以下の行を追加してください。

extension=curl
extension=mbstring
extension=json

PHPエージェントのYAMLテンプレートか環境変数を使用して、PHPエージェントを設定します(まだ設定をしていない場合)。

通常の方法でアプリケーションを開始します。

アプリケーションの疎通やテストを行います。

PHPエージェントが実行されているかを確認するには、Contrast Webインターフェイスを確認するか、(設定によっては)PHPエージェントのログ出力を確認するなどしてください。