APIを使用して、 Workload Security に新しい資産を保護するプロセスの一部としてコンピュータを追加できます。
APIを使用する前に、次の種類の予約タスクを使用してコンピュータを自動的に検出および追加することを検討してください。
- コンピュータの検出
- クラウドアカウントの同期
- ディレクトリの同期
- VMware vCenterの同期
詳細については、スケジュールされたタスクを使用して保護を維持するまたはWorkload Securityをスケジュールしてタスクを実行するを参照してください。
次の一般的な手順を使用してコンピュータを追加します。
Computer
オブジェクトを作成し、ホスト名を設定します。ホスト名は唯一の必須プロパティです。値はコンピュータに解決されるホスト名またはIPアドレスでなければなりません。computer = api.Computer() computer.host_name = hostname
- 必要に応じて他のプロパティを設定してください。利用可能なプロパティについては、APIレファレンスのCreate a Computer操作を参照してください。
ComputersApi
オブジェクトを作成し、それを使用してWorkload Securityにコンピュータを作成します。computers_api = api.ComputersApi(api.ApiClient(configuration)) new_computer = computers_api.create_computer(computer, api_version)
構成可能なプロパティを確認するには、APIレファレンスのCreate a Computer操作を参照してください。
Workload Securityコンソールを使用して、コンピュータが追加されたときに自動的に構成するタスクを作成することもできます。コンピュータが追加または変更されたときにタスクを自動的に実行するを参照してください。
従来のREST APIを使用すると、有効化されたエージェントを実行しているコンピュータでリレーを有効にできます。Deep Security Gitリポジトリには、次のタスクを実行するスクリプトが含まれています。
背景情報については、リレーを使用してセキュリティおよびソフトウェアの更新を配布するを参照してください。
# Create the computer object computer = api.Computer() computer.host_name = hostname # Add the computer to Workload Security computers_api = api.ComputersApi(api.ApiClient(configuration)) new_computer = computers_api.create_computer(computer, api_version) return new_computer.id