PHP Security¶
Beacon PHP 1.3.0 には、通常のエージェント ランタイムに実験的な Security が含まれています。デフォルトではオフになっており、ネイティブ拡張機能とインストール ライフサイクルを PHP ゼロコード接続 と共有します。
まず、Security 受信側の設定 に従って DataKit ログ パイプラインを準備します。受信側の検証は、実際に受信した記録に基づいて行う必要があります。
セキュリティをオンにする¶
1.3.0 インストーラーをダウンロードした後、インストールまたは冪等再インストール中に Security を有効にします。
インストール設定を変更した後、PHP-FPM または Apache を再起動します。 BEACON_SECURITY_ENABLED=true はアプリケーション環境でも設定できます。 FPM プールは環境オーバーライド変数をワーカーに渡す必要があります。
Security は OTLP ログを使用し、受信側はログ パイプラインを開く必要があります。 CLI アプリケーションの例:
サービス名と報告されるアドレスは、インストールされているデフォルト構成に従います。ランタイム SBOM は、Security ライフサイクル中にデフォルトでオンになり、ローカル診断出力はオフのままになります。
構成と適用範囲¶
| 環境変数 | 既定値 | 用途 |
|---|---|---|
BEACON_SECURITY_ENABLED |
false |
セキュリティをオンにします。 |
BEACON_SECURITY_SBOM_ENABLED |
true |
セキュリティがオンになっているときに、ランタイム SBOM の一部を収集します。 |
BEACON_SECURITY_LOCAL_OUTPUT_ENABLED |
false |
ローカル診断スナップショットを有効にします。 |
BEACON_SECURITY_OUTPUT |
システム一時ディレクトリ + /beacon-security |
診断の親ディレクトリを選択します。 |
選択された PDO、ファイル、コマンド、および cURL シンクは、現在のクエリ パラメーター、フォーム、および Cookie 入力に対する制限された値の依存関係を監視します。この検出は、脆弱性を確認せず、ブロックも実行しない保守的な候補観察です。変換された入力値とフレーム リクエスト ボディは、このモデルではカバーされません。
通常の CLI および PHP リクエストのライフサイクルをカバーします。永続的なマルチリクエスト ワーカーには、リクエスト リセットの統合がまだありません。ランタイム SBOM は、ロードされた拡張機能と、インクルードされたファイルを通じて観察される Composer パッケージを含む明示的に部分的なマニフェストです。
インストーラーの --disable-security でインストール時の有効化設定を解除し、アプリケーションの BEACON_SECURITY_ENABLED による上書きも削除または無効にします。対象範囲、診断出力、制限事項は該当バージョンの Security リファレンスを参照してください。受信した Logs レコードを実際に確認する必要があります。起動成功や doctor の合格だけでは、受信側への配信を確認できません。