APIを使用して File Storage Security にスタックを追加する

推奨事項

APIを使用する前に、 File Storage Security およびGCPのWebインタフェースを使用してスタックのデプロイを実行することをお勧めします。Webインタフェースを使用すると、配信パラメータ、概念、およびプロセスをわかりやすく紹介できます。

Webインターフェイスを介してデプロイする手順については、開始するを参照してください

前提条件

手順

スタックを作成。
APIキーを作成。
リクエストを実行するたびに、ヘッダ内の認証とAPIバージョンが必要になります。
- Authorization Header
  - Trend Micro Cloud One APIキーの場合：
    - キー: Authorization
    - 値: ApiKey <your api key value>
  - 従来のAPIキー（非推奨）：
    - キー: api-secret-key
    - 値: <your api key value>
- APIバージョンヘッダ：
  - キー: api-version
  - 値: v1

次に進む前に

Trend Micro Cloud One APIキーの例：

GET /api/external-id HTTP/1.1
Authorization: ApiKey YOUR-API-KEY
Api-Version: v1

従来のAPIキーの例：

GET /api/filestorage/external-id HTTP/1.1
api-secret-key: YOUR-API-KEY
Api-Version: v1

YOUR-API-KEY 上記のは、以前に生成したAPIキーに置き換えられます。

APIキーが有効な場合、APIコールは許可されます。そうでない場合は、403コードが返されます。

APIを使用してAll-in-one Stackを配信する

手順

JSON要素outputs.all_in_one_outputs.valueにアクセスして、terraform.tfstateからTerraformデプロイメントの出力を取得します。all_in_one_outputsの配列内の各オブジェクトは、各Scanner Stackに関連付けられたStorage Stackを表します。

all_in_one_outputs 例:

     [
         {
             "projectID":"your-gcp-project-id",
             "deploymentName":"your-aio-scanner",
             "storageStacks":[
                 {
                     "deploymentName":"your-aio-storage",
                     "projectID":"your-gcp-project-id"
                 }
             ]
         }
     ]

Scanner およびStorage StackをFile Storage Securityに追加します。
1. Scanner Stackを追加します。
  - 配列の各オブジェクトの projectID と deploymentName をメモします。
  - Create Stack を呼び出し、リクエスト本文に projectID と deploymentName の値を含めます。ここで、 projectID はスタック用にデプロイしたGCPプロジェクトのID、 deploymentName は Scanner Stackのデプロイ名です。
```
     curl --location --request POST 'https://filestorage.{region}.cloudone.trendmicro.com/api/stacks' \
             --header 'Api-Version: v1' \
             --header 'Authorization: ApiKey YOUR-API-KEY' \
             --header 'Content-Type: application/json' \
             --data-raw '{
                 "type": "scanner",
                 "provider": "gcp",
                 "details": {
                     "deploymentName": "your-aio-scanner",
                     "projectID": "your-gcp-project"
                 }
             }'
 
```
  - APIレスポンスの stackID 値に注意してください。これは、 Scanner StackのIDです。
  - 前の手順でメモした Scanner Stackの stackID を使用して Describe Stack を呼び出し、レスポンス本文のステータスが ok になるまで呼び出しを続けます。これで、 Scanner Stackが追加されました。
2. Storage Stackを追加します。
  - storageStacksの各オブジェクトのprojectIDとdeploymentNameをメモします。
  - Create Stackを呼び出し、前述の Scanner スタック stackID、 projectID 、および deploymentName をリクエスト本文に含めます projectID はスタックをデプロイしたGCPプロジェクトのIDです。 deploymentName は、 Storage Stackのデプロイメント名です。 Storage Stackの作成が開始されます。
```
         curl --location --request POST 'https://filestorage.{region}.cloudone.trendmicro.com/api/stacks' \
                 --header 'Api-Version: v1' \
                 --header 'Authorization: ApiKey YOUR-API-KEY' \
                 --header 'Content-Type: application/json' \
                 --data-raw '{
                     "type": "storage",
                     "provider": "gcp",
                     "scannerStack": "your-scanner-stackID",
                     "details": {
                         "deploymentName": "your-aio-storage",
                         "projectID": "your-gcp-project-id"
                     }
                 }'
 
```
  - APIレスポンスの stackID 値を確認します。これは、 Storage StackのIDです。
  - 前の手順でメモしたStorage StackのstackIDを使用してDescribe Stackを呼び出し、レスポンス本文のstatusがokになるまで呼び出しを続けます。

次に進む前に

注意

スタックは個別に追加する必要があり、前述のようにStorage Stackの前にScanner Stackを追加する必要があります。

APIを使用してScanner Stackを配信する

手順

outputs.scanner_stacks_outputs.valueにアクセスして、terraform.tfstateからTerraformデプロイメントの出力を取得します。scannerStacksの配列内の各オブジェクトは、Scanner Stackを表します。

scanner_stacks_outputs 例:

     [
         {
             "deploymentName":"your-fss-scanner",
             "projectID":"your-gcp-project-id",
             "scannerServiceAccountID":"your-fss-scanner-service-account-id",
             "scannerTopic":"your-fss-scanner-topic"
         }
     ]

Scanner Stack を File Storage Securityに追加します。
- scannerStacksの各オブジェクトのprojectIDとdeploymentNameをメモします。
- Create Stack を呼び出し、リクエスト本文に projectID と deploymentName の値を含めます。ここで、 projectID はスタックをデプロイしたGCPプロジェクトのID、 deploymentName は Scanner Stackのデプロイ名です。
```
      curl --location --request POST 'https://filestorage.{region}.cloudone.trendmicro.com/api/stacks' \
              --header 'Api-Version: v1' \
              --header 'Authorization: ApiKey YOUR-API-KEY' \
              --header 'Content-Type: application/json' \
              --data-raw '{
                  "type": "scanner",
                  "provider": "gcp",
                  "details": {
                      "deploymentName": "your-fss-scanner",
                      "projectID": "your-gcp-project"
                  }
              }'
  
```
- APIレスポンスの stackID 値を確認します。Scanner StackのIDです。
- 前の手順でメモした Scanner Stackの stackID を使用して Describe Stack を呼び出し、レスポンス本文のステータスが ok になるまで呼び出しを続けます。
これで、 Scanner Stackが追加されました。

APIを使用してStorage Stackを配信する

手順

outputs.storage_stacks_outputs.valueのJSON要素にアクセスして、terraform.tfstateからTerraformデプロイメントの出力を取得します。storage_stacks_outputsの配列内の各オブジェクトは、Storage Stackを表します。
storage_stacks_outputs 例:
```
     {
         "storageStacks":[
             {
                 "deploymentName":"your-fss-storage",
                 "projectID":"your-gcp-project-id"
             }
         ]
     }
 
```
Storage Stack を File Storage Securityに追加します。
- List Stacks を呼び出すと、検索エンジンのスタックの stackIDを取得できます。
  - storageStacksの各オブジェクトのprojectIDとdeploymentNameをメモします。
  - Create Stackを呼び出し、前述の Scanner スタック stackID、 projectID 、および deploymentName をリクエスト本文に含めます projectID はスタックをデプロイしたGCPプロジェクトのID、 deploymentName は、Storage Stackのデプロイメント名です。
```
      curl --location --request POST 'https://filestorage.{region}.cloudone.trendmicro.com/api/stacks' \
              --header 'Api-Version: v1' \
              --header 'Authorization: ApiKey YOUR-API-KEY' \
              --header 'Content-Type: application/json' \
              --data-raw '{
                  "type": "storage",
                  "provider": "gcp",
                  "scannerStack": "your-scanner-stackID",
                  "details": {
                      "deploymentName": "your-fss-storage",
                      "projectID": "your-gcp-project-id"
                  }
              }'
  
```
- APIレスポンスの stackID 値を確認します。これは、 Storage StackのIDです。
- 前の手順で書き留めた Storage Stackの stackID を使用して Describe Stack を呼び出し、レスポンス本文の status が ok になるまで呼び出しを続けます。
これで、 Storage Stackが追加されました。