| 場所 | トップナビゲーションバー > Template Scanner |
Template Scannerを使用すると、TrendAI Vision One™™ – Cloud Risk Management ルールをTerraform、AWS Cloud Development Kit (CDK)、Serverless Framework、およびAWS CloudFormationテンプレートで実行し、AWS、Azure、GCPアカウントのリスクを検出できます。サービスやリソースを起動する前に問題を特定し、修正するために、ワークフローに予防的なセキュリティとガバナンスのコントロールを追加できます。
Template Scannerとは何ですか?
Template Scannerは、Azure、AWS、GCPのクラウドインフラストラクチャが展開される前に、Infrastructure as Code (IaC)
のリスクを検出することで、コンプライアンスを維持するための予防策を提供します。
このサービスを使用して、CloudFormationテンプレートとTerraform構成ファイルを検索できます。
サポートされているクラウドプロバイダー
Template Scannerは現在、以下のクラウドプロバイダをサポートしています。各クラウドプロバイダの特定のカバレッジサポートの詳細については、TrendAI Vision One™ - Template Scannerのカバレッジをご覧ください
- AWS
- Azure
- GCP
サポートされている機能
IaCファイルを検索するには、以下のいずれかまたは組み合わせを使用できます。
- アプリケーションUIを使用してテンプレートをアップロードする
- テンプレートを使用してリクエストを投稿するためのAPIの使用
|
機能
|
Template Scanner UI/API
|
|
ファイルを読み込むためのグラフィカルインターフェース
|
✅
|
|
パブリックAPI
|
✅
|
|
アカウントおよびプロフィールルール設定
|
✅
|
|
GitHub統合
|
❌
|
|
AWS CloudFormation
|
✅
|
|
AWS Cloud Development Kit (CDK)
|
✅
|
|
サーバーレスフレームワーク (AWS)
|
✅
|
|
Terraform (AWS、Azure、GCP)
|
✅
Terraform Planファイル (
.json) およびHCLテンプレート (.tf) を通じてサポートされています |
UIで検索
- 検索するルール設定の種類を選択します。
- デフォルトルール設定: 組織のルール設定を使用してアップロードおよび検索します。
- プロファイルルール設定: 選択したプロファイルのルール設定を使用してアップロードおよび検索します。
- アカウントルール設定: 選択したアカウントのルール設定を使用してアップロードおよび検索します。
CloudFormationテンプレートをスキャン
- CloudFormationテンプレートはJSON形式またはYAML形式でアップロードできます。
- YAMLテンプレートで! Conditionを使用することもできます。
AWS Cloud Development Kit (CDK) をスキャンしています
Template scannerは、CDKコードからCloudFormationテンプレートを合成することにより、CDKファイルの評価をサポートします。
- AWS CDK CLIをインストールする
- CDKコードがあるディレクトリで
cdk synthを実行します。これにより、YAML形式のCloudFormationファイルが出力されます (必要に応じて--jsonを使用することもできます)。 - Template Scanner UIまたはAPIエンドポイントを使用して、
cdk synthによって生成されたCloudFormationファイルを検索します。
サーバーレスフレームワークをスキャン中
Template Scannerは、サーバーレスコードからCloudFormationテンプレートを合成することにより、Serverless Frameworkアプリケーションの評価をサポートします。
serverlessファイルがあるディレクトリで、serverless packageを実行して、.serverless/cloudformation-template-update-stack.jsonにJSONファイルを生成します。- Template Scanner UIまたはAPIエンドポイントを使用して、
serverless packageによって生成されたCloudFormationファイルを検索します。
Terraformプランのスキャン
-
Terraformテンプレートは、以下の手順に従ってCommand LineツールからJSON形式のTerraformプランに変換する必要があります。
- .tfテンプレートと同じディレクトリで、プロバイダの[アクセスキー]、[secret key,]、[export region]をエクスポートします (例: `export AWS_REGION=us-east-1`)
- コマンド
terraform initを実行してください - コマンド
terraform plan -out=your_fileを実行してください - コマンド
terraform show -json your_file > your_file.jsonを実行します。Terraform JSONプランは、.tfファイルと同じフォルダからTemplate Scannerにアップロードする準備が整いました。
-
[アップロードしてスキャン]をクリックして、選択したルール設定の検索結果を表示します。
-
テンプレートをスキャン中にパラメーターが不足しているというメッセージが表示されます。スキャンプロセスを[続行]するか[キャンセル]するかを決定してください。
注意
パラメーターが欠落しているリソースは検索されず、その結果、部分的な検索結果となります。 -
注意
失敗したチェックに対して提供される解決手順はCLIまたはコンソール経由のワークフロー用です。CloudFormation内での解決のガイドとしてこれらの手順を使用することもできます。
Terraform HCLテンプレートをスキャンしています
- あなたの.tfファイルを含むZIPファイルを作成してください
- Template Scannerメニューをクリックしてください
- Terraformタブをクリックしてください
- ZIPファイルを参照
- アップロードして検索
APIによる検索
APIレファレンスを参照して、Template Scanner APIを自動化やビルドパイプラインで使用する方法をご確認ください。
以下に追加の例があります。
サポートされているルール
次のAPIエンドポイントを使用して、Template Scannerがサポートするルールのリストを取得できます。
サポートされているリソースの概要については、このページを参照してください。
なぜ検索結果が表示されないのですか?
次の理由のいずれかにより、空の対応またはエラーを受け取ることがあります。
- サポートされていないリソースタイプまたはルール - Template Scannerは、リソースレベルのルールのみをサポートしています。サポートされているルールとリソースタイプのリストについては、APIを参照してください。今後、より多くのソースタイプのサポートを追加する予定です。優先的に必要な特定のリソースタイプがある場合は、アカウントマネージャにお問い合わせください。
- デフォルト値のないパラメータ - デフォルト値のないパラメータを持つCloudFormationテンプレートは処理に失敗する可能性があります。
- サポートされていないAWS CloudFormationの組み込み関数 - サポートされていない組み込み関数を含むCloudFormationテンプレートは、処理されないか、完全な結果を生成しない可能性があります。以下はCloudFormationテンプレートにおける[supported]の組み込み関数です。
- Fn::Base64
- Fn::And
- Fn::Equals
- Fn::If
- Fn::Not
- Fn::Or
- Fn::FindInMap
- Fn::GetAtt
- Fn::GetAZs
- Fn::Join
- Fn::Select
- Fn::Split
- Fn::Sub
- Ref
テンプレートが正しくスキャンされるように、これらの関数を一時的に静的な値に置き換えることをお勧めします。