puppet falconダウンロード - puppet falconソースコードのダウンロード

puppet falcon

その他のソースコード

Unknown

ダウンロード

ハヤブサ

説明

falconモジュールは、複数のオペレーティングシステムおよびディストリビューションにわたってfalconサービスをインストール、構成、管理します。

注: puppet-falconはオープンソースプロジェクトであり、CrowdStrike 製品ではありません。したがって、明示的または暗黙的を問わず、正式なサポートはありません。

使用法

falcon モジュールのすべてのパラメーターは、メインのfalconクラス内に含まれています。モジュールの動作を変更するオプションが多数あります。詳細については、REFERENCE.mdを参照してください。

以下に一般的な使用例をいくつか示します。

注: falconパッケージは公開されていないため、このモジュールには falcon センサーをインストールするための 2 つのオプションがあります。 install_methodパラメータを使用すると、 apiまたはlocal選択できます。 apiデフォルトです。詳細については、「API とローカルのインストール方法」で説明されています。

サービスの基本的なインストール、構成、管理

# `api` メソッドを使用するclass {'falcon': client_id => Sensitive('12346'), client_secret => Sensitive('12345'), cid => 'AJKQUI123JFKSDFJK`}

 # `local` メソッドを使用します$package_options = { 'ensure' => 'present', 'source' => '/tmp/sensor.rpm' # パッケージリソースに対して有効なその他の属性}class {'falcon' : install_method => 'local'、package_options => $package_options、cid => 'AJKQUI123JFKSDFJK`}

`api`インストール方法を使用する

apiインストールメソッドは、API を使用してセンサーパッケージをダウンロードします。ダウンロードされるパッケージのバージョンは、モジュールに渡されるパラメータによって決まります。

apiインストールメソッドの動作を変更するパラメーターが 3 つあります。これらのパラメーターは一度に 1 つだけ使用でき、以下にリストされている順序で評価されます。

version - 指定したバージョンに一致するセンサーパッケージをダウンロードします。
update_policy - 更新ポリシーで指定されたバージョンをダウンロードします。
version_decrement - 現在のバージョンよりも前のn番目のバージョンをダウンロードします。

apiインストール方法を使用する場合の欠点については、「API とローカルインストール方法」で概説します。

それぞれの例を以下に示します。 versionパラメータの使用

これは、 update_policyおよびversion_decrementよりも優先されます。

クラス { 'falcon': client_id => Sensitive('12346')、client_secret => Sensitive('12345')、バージョン => '1.0.0'、cid => 'AJKQUI123JFKSDFJK`}

update_policyパラメータの使用

これは、 version_decrementパラメーターよりも優先されます。

 class { 'falcon': client_id => Sensitive('12346')、client_secret => Sensitive('12345')、update_policy => 'platform_default'、cid => 'AJKQUI123JFKSDFJK`}

version_decrementパラメータの使用

version_decrementを使用してnxバージョンをダウンロードします。

値0は最新バージョンをダウンロードし、値2はn-2バージョン (最新バージョンから2リリース遅れ) をダウンロードします。

 class { 'falcon': client_id => Sensitive('12346')、client_secret => Sensitive('12345')、version_decrement => 2、cid => 'AJKQUI123JFKSDFJK`}

`local`インストール方法を使用する

localインストール方法では、センサーのインストール方法を完全に制御できます。

この方法を使用する理由は次のとおりです。

ローカルファイルからセンサーをインストールしたい
独自のパッケージ管理システムがある

localインストール方法の詳細については、「API とローカルインストール方法」を参照してください。

localインストール方法を使用する場合は、 package_optionsが必要です。 package_optionsのパラメータはpackageリソースに渡されます。 nameパラメータを除く、 packageリソースの必須パラメータを指定する必要があります。モジュールはオペレーティングシステムに基づいて適切な名前を選択します。 package_optionsハッシュでnameプロパティを指定することで、名前をオーバーライドすることもできます。

 # ローカル ファイルを使用するfile {'/tmp/sensor.rpm': ensure => 'present', source => 'https://company-filer-server.com/sensor.rpm'}class {'falcon': install_method => 'local', package_options => { 'ensure' => 'present', 'source' => '/tmp/sensor.rpm'
  }, require => ファイル['/tmp/sensor.rpm']
}

 # http ソースクラスを使用する {'falcon': install_method => 'local', package_options => { 'ensure' => 'present', 'source' => 'http://example.com/sensor.rpm'
  }
}

 # 名前のオーバーライドparameterclass {'falcon': install_method => 'local', package_options => { 'ensure' => 'present', 'source' => '/tmp/sensor.rpm', 'name' => 'ハヤブサセンサー」
  }
}

インストーラーファイルの削除

install_methodがapiの場合、 cleanup_installerパラメーターを使用して、インストール後にインストーラーファイルを削除できます。

 class { 'falcon': client_id => Sensitive('12346'), client_secret => Sensitive('12345'), cleanup_installer => true, cid => 'AJKQUI123JFKSDFJK`}

デフォルトのパッケージパラメータをオーバーライドする

package_optionsパラメーターを使用して、 packageリソースに渡されるパラメーターをオーバーライドできます。有効なパッケージパラメータ

これは、 apiとlocalインストール方法の両方で同じように機能します。

 $package_options = { 'provider' => 'rpm', 'install_options' => '--force',
}クラス { 'ファルコン': package_options => $package_options}

パッケージをインストールするモジュールをオプトアウトする

class {'falcon': package_manage => false # ... その他の必須パラメータ}

エージェントを構成するモジュールからオプトアウトする - Linux のみ

注Windows エージェントはインストール時にのみ構成できます。 Linux エージェントには、インストール後に puppet がエージェントを構成できるようにするfalconctlが付属しています。たとえば、リソースのcidプロパティを更新すると、次回の実行時に Linux エージェントのcid更新されますが、Windows では更新されません。

 class {'falcon': config_manage => false # ... その他の必須パラメータ}

サービスを制御するモジュールからオプトアウトする

class {'falcon':service_manage => false # ... その他の必須パラメータ}

`cid`の登録

class {'falcon': cid => 'AJKQUI123JFKSDFJK` # ... その他の必須パラメータ}

プロビジョニングトークンを使用した`cid`の登録

会社がエージェントを登録するためにプロビジョニングトークンを必要とする場合は、 provisioning_tokenパラメーターを使用できます。

 class {'falcon': cid => 'AJKQUI123JFKSDFJK`, Provisioning_token => '1234567890' # ... その他の必須パラメータ}

プロキシ設定を行う

proxy_host 、 proxy_port 、およびproxy_enabledパラメータを使用して、エージェントのプロキシ設定を構成できます。

注Mac のインストールには、エージェント固有のプロキシ設定はありません。代わりに、OS のプロキシ設定が使用されます。これらのパラメータに値を渡しても、Mac のプロキシ設定は構成されません。

class {'falcon': cid => 'AJKQUI123JFKSDFJK`、provisioning_token => '1234567890,' proxy_host => 'neptune.example.com'、proxy_port => '8080'、proxy_enabled => true

...その他の必須パラメータ

}

エージェントのバージョンを固定する

apiインストール方法を使用してエージェントのバージョンを特定のバージョンに固定する場合は、 version_manage true に設定します。

以下の例ではversion_decrementを使用していますが、すべて同じように機能します。 Puppet は API を参照して、 version_decrement => 2がどのバージョンに解決されるかを判断します。次に、そのバージョンをダウンロードし、インストールされていることを確認します。

後続の実行ごとに API をチェックして、返されたバージョンがインストールされているものであるかどうかを確認します。たとえば、新しいバージョンがリリースされると、チェックから返されたバージョンが変更され、エージェントが新しいn-2バージョンにアップグレードされます。

warning : これにより、モジュールは実行のたびに API を参照して、API が返すバージョンがインストールされているバージョンであることを確認します。これにより、大規模な展開ではレート制限の問題が発生する可能性があります。自動アップグレード/ダウングレードを希望し、 apiインストール方法を使用する場合は、通常、 version_manage falseに設定し、Puppet の代わりに CrowdStrike 更新ポリシーがアップグレード/ダウングレードを実行できるようにすることをお勧めします。

 class {'falcon': version_manage => true client_id => Sensitive('12346'), client_secret => Sensitive('12345'), update_policy => 'platform_default' cid => 'AJKQUI123JFKSDFJK` # ... その他の必須パラメータ}

localのinstall_methodを使用する

class {'falcon': install_method => 'local', package_options => { 'ensure' => '32.4.3', 'source' => '/tmp/sensor-32.4.3.rpm'
  }
}

`api`と`local`インストール方法

一般に、 version_manageがfalseに設定されている場合、 apiメソッドはほとんどのユースケースで問題ありません。 version_manageがtrueに設定されている場合、API レート制限に遭遇する可能性があります。

フルコントロールが必要で API を利用したくない場合は、 localインストール方法を使用できます。

インストール方法が 2 つあるのはなぜですか?

通常、パッケージを管理する Puppet モジュールは、インストールから削除までそのパッケージのライフサイクル全体を制御します。 CrowdStrike エージェントパッケージが公開されていないという事実が、これを困難にしています。

私たちは、手動でパッケージをすばやくインストールできる方法を提供したいと考えていたため、 apiインストールメソッドを作成しました。この方法では、API 認証情報を提供する必要があります。その後、CrowdStrike API から正しいパッケージバージョンをダウンロードします。 update_policy設定など、動作を制御できるパラメーターがあります。これにより、モジュールは更新ポリシーの提案に基づいて正しいバージョンをダウンロードします。それぞれの例はこちら。

ただし、この方法はすべての人に適しているわけではないため、センサーのインストール方法を完全に制御できるlocalインストール方法が作成されました。

`api`インストール方法の仕組み

API インストール方法では、falcon API を使用して正しいパッケージバージョンをダウンロードします。正しいパッケージのバージョンは、指定したパラメータによって異なります。それぞれの例をここで見ることができます。

最初の実行では、Puppet が適切な CrowdStrike API を呼び出して、センサーパッケージのダウンロードに必要な情報を取得します。次に、センサーパッケージをダウンロードします。その後は、通常のパペットリソースが引き継ぎます。

version_manage trueに設定すると、実行のたびにモジュールが CrowdStrike API を参照して、適切なパッケージバージョンを取得します。次に、インストールされているバージョンが返されたバージョンと同じかどうかが判断されます。それらが同じでない場合は、正しいパッケージバージョンがダウンロードされ、適切なインストール/更新/ダウングレードアクションが実行されます。

version_manageをfalseに設定すると、CrowdStrike センサーがインストールされていない場合にのみ API 呼び出しが発生します。

API レート制限

apiインストール方法の主な制限は、API レート制限です。私たち自身はこの制限に達していませんが、 version_manage trueに設定してapiインストールメソッドを使用すると、大規模なインストールでレート制限に達する可能性があります。

Puppet はノードのカタログをコンパイルするたびに、API を使用して、どのバージョンのエージェントをインストールする必要があるかを決定します。エージェントがすでに正しいバージョンを使用している場合、それ以上の API 呼び出しは行われません。

version_manage falseに設定すると、エージェントがインストールされていない限り、API 呼び出しが禁止されます。

API呼び出しの削減

API 呼び出しを減らす最善の方法は、 version_manage falseに設定することです。これにより、API が呼び出されるのは、エージェントがインストールされていないときだけになります。これにより、API レート制限の問題が回避されます。

MacOS へのインストール

Apple プラットフォームでは、ユーザーのプロンプトを表示せずにカーネル拡張機能をインストールするには、モバイルデバイス管理 (MDM) プロファイルが必要です。この制限により、このモジュールは Falcon Sensor のみをダウンロードしてインストールします。 CrowdStrike ドキュメントの Mac 導入ガイドでは、 CIDへのレポートを開始するように Mac センサーを構成するために必要な手順の概要が説明されています。