AWS Security Hubから特定の（Idでフィルタリングされた）セキュリティ検出結果を読み取り、デフォルトのコンテキストオプションを実行します:```bash
./metahub --sh-filters Id=arn:aws:securityhub:us-east-1:123456789012:security-control/CloudFront.1/finding/8bd4d049-dcbc-445b-a5d1-595d8274b4c1

AwsAccountIdとRecordStateでフィルタリングされた、タグ`Environment`が値`stg`であるリソースに対して、AWSアカウントに影響を与えるACTIVEなセキュリティ検出結果をすべて読み取り、コンテキストオプション`config`と`tags`を実行します：```bash
./metahub --sh-filters RecordState=ACTIVE AwsAccountId=123456789012 --mh-filters-tags Environment=stg --context config tags

Powerpipeからのセキュリティ検出結果を入力ファイルとして読み取り、デフォルトのコンテキストオプションを実行します:```bash
powerpipe benchmark run aws_compliance.benchmark.all_controls --export asff
./metahub --inputs file-asff --input-asff /path/to/powerpipe-findings.json.asff

# Context

**MetaHub**において、**コンテキスト**とは、影響を受けるリソースに関する情報（**設定**、**関連付け**、**ログ**、**タグ**、**アカウント**など）を指します。

MetaHubは影響を受けるリソースだけでなく、関連付けられたリソースやアタッチされたリソースも分析します。例えば、セキュリティグループにセキュリティ検出結果がある場合、**MetaHub**はそのセキュリティグループと、それを使用しているEC2インスタンスなど、関連するすべてのものを分析します。関連付けられたリソースごとに、**MetaHub**はそのコンテキストを取得します。セキュリティグループがEC2インスタンスにアタッチされている場合、**MetaHub**はインスタンスとそのすべての関連付け（IAMロールやポリシーなど）を分析します。単一のセキュリティグループのセキュリティ検出結果から、**MetaHub**はセキュリティグループ、EC2インスタンス、IAMロール、IAMポリシーのコンテキストを取得します。これは、セキュリティ検出結果の影響を理解するために重要です。

**コンテキスト**モジュールには5つの主要な部分があります：[**config**](#config)（[**associations**](#associations)を含む）、[**tags**](#tags)、[**cloudtrail**](#cloudtrail)、[**account**](#account)です。デフォルトでは**config**、**tags**、**account**のみが有効ですが、`--context`オプションを使用してこの動作を変更できます（例：すべてのコンテキストキーを有効にするには`--context config tags cloudtrail account`、configとassociationsキーのみを有効にするには`--context config`を使用）。

## Config

`config`キーの下には、影響を受けるリソースの重要な設定があります。例えば、影響を受けるリソースがS3バケットの場合、バケットポリシー、ACL、暗号化設定などに関する情報が含まれます。影響を受けるリソースがEC2インスタンスの場合、キー、パブリックおよびプライベートIP、メタデータなどに関する情報が含まれます。**MetaHub**が取得する設定情報はリソースタイプごとに定義されています。さらに設定情報を追加したい場合は、[contributing](#contributing)を参照してください。

`--mh-filters-config <key> {True/False}`オプションを使用して、config出力に基づいて検出結果をフィルタリングできます（[config filters](#config-filters)を参照）。

<details>
  <summary>S3バケットのconfigキーの例</summary>```json
"config": {
  "resource_policy": {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Sid": "Test",
        "Effect": "Allow",
        "Principal": {
          "Service": "config.amazonaws.com"
        },
        "Action": "s3:GetBucketAcl",
        "Resource": "arn:aws:s3:::metahub-bucket",
        "Condition": {
          "StringEquals": {
            "AWS:SourceAccount": "123456789012"
          }
        }
      },
    ]
  },
  "website_enabled": false,
  "bucket_acl": [
    {
      "Grantee": {
        "DisplayName": "gabriel.soltz",
        "ID": "1234564bd76c6c64080717b68eafaa588b41706daaf22d3d0705b398bd7cbd57",
        "Type": "CanonicalUser"
      },
      "Permission": "FULL_CONTROL"
    }
  ],
  "cannonical_user_id": "1234564bd76c6c64080717b68eafaa588b41706daaf22d3d0705b398bd7cbd57",
  "public_access_block_enabled": {
    "BlockPublicAcls": true,
    "IgnorePublicAcls": true,
    "BlockPublicPolicy": true,
    "RestrictPublicBuckets": true
  },
  "account_public_access_block_enabled": false,
  "public": false,
  "bucket_encryption": [
    {
      "ApplyServerSideEncryptionByDefault": {
        "SSEAlgorithm": "AES256"
      },
      "BucketKeyEnabled": false
    }
  ]
},

例えば、影響を受けるリソースに2つのファインディングがあり、1つは`HIGH`、もう1つは`LOW`の深刻度である場合、**Impact Findings Score**は次のようになります：```sh
SUM(HIGH (3) / CRITICAL (4) + LOW (0.5) / CRITICAL (4)) = 0.875

## AWS認証情報とDocker

すでにAWSホストマシンにログインしている場合、同じ認証情報をDockerコンテナ内でシームレスに使用できます。これは、必要な環境変数をコンテナに渡すか、認証情報ファイルをマウントすることで実現できます。

たとえば、次のコマンドを実行します。```sh
docker run -e AWS_DEFAULT_REGION -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN -ti public.ecr.aws/n2p8q5p4/metahub:latest ./metahub -h

# Lambdaでの実行

**MetaHub** は Lambda/Serverless 対応です！追加のインフラストラクチャなしで、MetaHub を AWS Lambda 関数上で直接実行できます。

Lambda 関数で MetaHub を実行すると、定義したトリガーに基づいて実行を自動化できます。例えば、以下が可能です：

- 新しいセキュリティ検出結果があるたびに MetaHub Lambda 関数をトリガーし、その検出結果を AWS Security Hub にリッチ化して反映させる。
- 新しいセキュリティ検出結果があるたびに MetaHub Lambda 関数をトリガーし、コンテキストに基づいて抑制する。
- MetaHub Lambda 関数をトリガーし、コンテキストに基づいてセキュリティ検出結果の影響を受ける所有者を特定し、社内システムを使用して割り当てる。
- MetaHub Lambda 関数をトリガーし、リッチ化されたコンテキストを含むチケットを作成する。

## Lambda のデプロイ

Lambda 関数をデプロイするための Terraform コードは `terraform/` フォルダに用意されています。

以下のコマンドを実行するだけです：```sh
cd terraform
terraform init
terraform apply

または、資格情報を環境変数にエクスポートすることもできます。```sh
export AWS_DEFAULT_REGION="us-east-1"
export AWS_ACCESS_KEY_ID= "ASXXXXXXX"
export AWS_SECRET_ACCESS_KEY= "XXXXXXXXX"
export AWS_SESSION_TOKEN= "XXXXXXXXX"

# コンテキストの設定

複数のAWSアカウント設定（AWS Security Hubが複数のAWSアカウントからの検出結果を集約している）でMetaHubを実行している場合、影響を受けるリソースがAWS Security Hubの検出結果と同じAWSアカウントに存在しないため、コンテキストクエリで引き受けるロールを指定する必要があります。`--mh-assume-role` は、影響を受けるアカウント内のリソースに直接接続するために使用されます。このロールには、リソースを記述できる十分なポリシーが必要です。

## コンテキスト用IAMポリシー

コンテキストに必要な最小ポリシーには、管理ポリシー `arn:aws:iam::aws:policy/SecurityAudit` と以下のアクションが含まれます:

- `tag:GetResources`
- `lambda:GetFunction`
- `lambda:GetFunctionUrlConfig`
- `cloudtrail:LookupEvents`
- `account:GetAlternateContact`
- `organizations:DescribeAccount`
- `iam:ListAccountAliases`

# 入力

MetaHubは、AWS Security HubのAPIを使用してセキュリティ検出結果を直接読み取ることができます。Security Hubを使用していない場合は、ASFF互換のスキャナーを使用できます。ほとんどのクラウドセキュリティスキャナーは、Prolwer、Steampipe、TrivyなどのASFF形式をサポートしています。

入力ASFFファイルから読み取る場合は、オプション（`--inputs file-asff`）を使用してファイルのパスを指定する必要があります。スペースで区切って複数のファイルを指定できます。:```sh
./metahub.py --inputs file-asff --input-asff path/to/the/file.json.asff path/to/the/file2.json.asff

ファイルを入力として使用する場合、検出結果をフィルタリングするためのオプション `--sh-filters` は使用できません。このオプションは AWS API に依存してフィルタリングを行うためです。また、`--update-findings` や `--enrich-findings` のオプションは使用できません。これらの検出結果は AWS Security Hub に存在しないためです。両方のソースから同時に読み取る場合、AWS Security Hub からの検出結果のみが更新されます。

MetaHub は、ASFF 形式が正しくフォーマットされていない場合のための **修正メカニズム** も実装しています。これは、ASFF を可能な限り有用にするためのベストエフォートアプローチですが、完璧ではなく、ソーススキャナーで修正される必要があります。

- キー `Region` が Resources および Root Level に存在しない場合、MetaHub は影響を受けるリソースの ARN に基づいてリージョンを計算します。
- ASFF ファイルが ASFF リソースタイプを正しく設定していない場合、MetaHub はライブラリ [aws-arn](https://github.com/gabrielsoltz/aws-arn) を使用して、影響を受けるリソースの ARN に基づいてリソースタイプを計算します。
- `SeverityLabel`、`Workflow`、`RecordState`、`Compliance`、`Id`、`ProductArn`、`StandardsControlArn` などの他のフィールドが欠落している場合、MetaHub はそれらを `Unknown` に設定します。

# 出力

**MetaHub** は、さまざまなプログラム的および視覚的出力を生成できます。デフォルトでは、すべての出力モードが有効です: `json-short`、`json-full`、`json-statistics`、`json-inventory`、`html`、`csv`、`xlsx`。特定の出力モードのみを生成したい場合は、オプション `--output-modes` を使用して目的の出力モードを指定できます。出力は、実行日時とともに `outputs/` フォルダに保存されます。

例えば、出力 `json-short` のみを生成したい場合は、次のようにします:```sh
./metahub.py --output-modes json-short

**MetaHub** は、同じリソースに影響するセキュリティ検出結果を `findings` キーの下にまとめて整理することで、シャドーイング（2つのチェックが同じ問題を参照しているが、一方が他方よりも汎用的な方法である場合）と重複（複数のスキャナーを使用し、複数のスキャナーから同じ問題が発生する場合）を避けようとしています。この動作は、出力 `json-short`、`json-full`、`html` で明確に確認できます。

- [JSON](#json)
- [HTML](#html)
- [CSV](#csv)
- [XLSX](#xlsx)
- [SQLite](#sqlite)

## JSON

> :info: JSON 出力を対話的に探索するには、ツール [fx](https://github.com/antonmedv/fx) を使用できます。

### JSON-Full

影響を受けるリソースを、その ARN をキーとして表示し、それに影響する検出結果を `findings` キーの下にリストとして表示します。検出結果に加えて、次のキーも取得できます: `ResourceType`、`Region`、`AwsAccountId`、`associations`、`config`、`tags`、`account`、`cloudtrail`、および `impact`。```json
"arn:aws:ec2:eu-west-1:1234567890:instance/i-0a40b2be25dbac0ac": {           --> The affected resource ARN
  "findings": [                                                              --> The findings affecting the resource
    {
      "EC2 instances should use Instance Metadata Service Version 2 (IMDSv2)": {   --> The finding title
        "SeverityLabel": "HIGH",                                                   --> The finding severity label
        "Workflow":{                                                               --> The finding workflow
          "Status": "NEW",
        },
        "RecordState": "ACTIVE",                                                   --> The finding record state
        "Compliance":{                                                             --> The finding compliance
          "Status": "FAILED",
        },
        "Id": "arn:aws:securityhub:eu-west-1:123456789012:security-control/EC2.8/finding/a1d4f19f-453e-4c3c-b486-8443c73e84f1",
        "ProductArn": "arn:aws:securityhub:eu-west-1::product/aws/securityhub",
      }
    },
    {"EC2 instances should be managed by AWS Systems Manager": {...}},        --> Another finding title
    {"EC2 instances should not have a public IPv4 address": {...}}          --> Another finding title
  ],
  "ResourceType": "AwsEc2Instance",                                         --> The affected resource type
  "Region": "eu-west-1",                                                    --> The affected resource region
  "AwsAccountId": "1234567890",                                             --> The affected resource account id
  "associations": {                                                         --> The associations of the affected resource
    "security_groups": {},                                                  --> The security groups associated with the affected resource
    "iam_roles": {},                                                        --> The IAM roles associated with the affected resource
    "volumes": {},                                                          --> The volumes associated with the affected resource
    "autoscaling_groups": {},                                               --> The autoscaling groups associated with the affected resource
    "vpcs": {},                                                             --> The VPCs associated with the affected resource
    "subnets": {},                                                          --> The subnets associated with the affected resource
  },
  "config": {                                                              --> The configuration of the affected resource (based on it's type)
    "public_ip": "200.200.200.200",                                       --> The public IP of the affected resource, if any
    "private_ip": "10.10.10.10",                                        --> The private IP of the affected resource, if any
    "key": "ssh-key",                                                  --> The key used for the affected resource, if any
    "metadata_options": {                                             --> The metadata options of the affected resource, if any
      "State": "applied",
      "HttpTokens": "required",
      "HttpPutResponseHopLimit": 1,
      "HttpEndpoint": "enabled",
      "HttpProtocolIpv6": "disabled",
      "InstanceMetadataTags": "disabled"
    },
  },
  "tags": {                                                            --> The tags of the affected resource
    "Name": "test",                                                  --> The tag key and value
    "Env": "prod",
    "awsApplication": "arn:aws:resource-groups:eu-west-1:1234567890:group/app1/0c8vpbjkzeeffsz2cqgxpae7b2"
  },
  "account": {                                                            --> The account of the affected resource
    "Alias": "prod",                                                --> The account alias
    "AlternateContact": {},                                        --> The alternate contact of the account, if any
    "Organizations": {                                            --> The organization of the account, if any
      "Id": "o-1234567890",
      "Arn": "arn:aws:organizations::1234567890:organization/o-1234567890/o-1234567890",
      "MasterAccountId": "1234567890",
      "MasterAccountArn": "arn:aws:organizations::1234567890:account/o-1234567890/1234567890",
      "MasterAccountEmail": "",
      "Details": {
        "ParentId": "p-k1234567890",
        "ParentType": "ROOT",
        "OU": "ROOT",
        "Policies": {                                           --> The policies of the account, if any
          "p-FullAWSAccess": {...}                              --> The policy name and policy
        }
      }
    },
  },
  "cloudtrail": {                                                     --> The CloudTrail events affecting the affected resource
    "RunInstances": {                                                --> The CloudTrail event name
      "Username": "test",                                            --> The username of the event, if any
      "EventTime": "2021-01-01T00:00:00Z",
      "EventId": "12345678-1234-1234-1234-123456789012",
    }
  },
  "impact": {                                                        --> The impact of the affected resource
    "exposure": {...},                                             --> The exposure impact
    "access": {...},                                              --> The access impact
    "encryption": {...},                                         --> The encryption impact
    "status": {...},                                            --> The status impact
    "environment": {...},                                      --> The environment impact
    "application": {...},                                     --> The application impact
    "owner": {...},                                          --> The owner impact
    "findings": {...},                                      --> The findings impact
    "score": {...}                                         --> The total impact score
  }
}

### JSON-Inventory

すべてのリソースとそのARNのリストを表示します。```json
[
  "arn:aws:sagemaker:us-east-1:ofuscated:notebook-instance/obfuscated",
  "arn:aws:sagemaker:eu-west-1:ofuscated:notebook-instance/obfuscated"
]

## HTML

リッチなHTMLレポートを作成し、あなたのコンテキストをその一部として追加することができます。

HTMLレポートは多くの方法でインタラクティブです：

- 列の追加/削除が可能です
- 任意の列でソートおよびフィルタリングが可能です
- 任意の列で自動フィルタリングが可能です
- 検出結果のグループ化/グループ解除が可能です
- そのデータをxlsx、CSV、HTML、およびJSONでダウンロードすることもできます

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6190/21d785d2413698ed7cb3e9dc7e9b51dc6550395a598d777abc9fc358f8a23573.png" alt="HTML表示例"/>
</p>

## CSV

CSVレポートを作成し、あなたのコンテキストをその一部として追加することができます。

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6190/66f15350123702e1cc317e47938401853bdcb1d86dad0ad4e48e73f15e00dd76.png" alt="CSV表示例"/>
</p>

## XLSX

CSVと似ていますが、より多くのフォーマットオプションがあります。

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6190/953a77917dc5b06e5185e6cb882ba7e711d785861e184599f10cd472efc42db9.png" alt="XLSX表示例"/>
</p>

## HTML、CSV、XLSX出力のカスタマイズ

`--output-tag-columns` および `--output-config-columns`（列のリストとして）オプションを使用して、HTML、CSV、XLSX出力でコンテキストキーを列として展開する方法をカスタマイズできます。指定したキーが対象リソースに存在しない場合、それらは空になります。デフォルトでは、設定ファイルでこれらの列を設定することもできます（[設定のカスタマイズ](#customizing-configuration)を参照）。

例えば、タグを含むHTML出力を生成し、レポートに「Owner」と「Environment」を列として追加するには、次のようにします：```sh
./metahub --output-modes html --output-tag-columns Owner Environment

### 独自のダッシュボードを構築する

Powerpipe を使ってダッシュボードを構築するのはとても簡単で強力です。詳細については、[Powerpipe ドキュメント](https://powerpipe.io/docs) を参照してください。

以下に、SQLite データベースで利用可能なテーブルを示します。

#### リソース

| カラム名                        | データ型 | 説明                                                                                     |
| ------------------------------- | -------- | ---------------------------------------------------------------------------------------- |
| resource_arn                    | VARCHAR  | リソースの Amazon リソース名 (ARN)。プライマリキーとして機能します。                    |
| resource_type                   | VARCHAR  | リソースのタイプ。                                                                      |
| resource_region                 | VARCHAR  | リソースが配置されているリージョン。                                                     |
| resource_account_id             | VARCHAR  | リソースに関連付けられたアカウント ID。accounts(account_id) を参照する外部キー。 |
| resource_account_alias          | VARCHAR  | リソースに関連付けられたアカウントのエイリアス。                                         |
| resource_tags                   | TEXT     | リソースに関連付けられたタグ。                                                             |
| resource_exposure               | VARCHAR  | リソースの露出レベル。                                                            |
| resource_access                 | VARCHAR  | リソースのアクセスレベル。                                                              |
| resource_encryption             | VARCHAR  | リソースの暗号化ステータス。                                                         |
| resource_status                 | VARCHAR  | リソースの現在のステータス。                                                            |
| resource_application            | VARCHAR  | リソースに関連付けられたアプリケーション。                                                  |
| resource_environment            | VARCHAR  | リソースが属する環境 (例: 本番、ステージング)。                                |
| resource_owner                  | VARCHAR  | リソースの所有者。                                                                     |
| resource_score                  | INTEGER  | リソースに関連付けられたスコア。                                                          |
| resource_findings_score         | INTEGER  | リソースに関連する検出結果に基づくスコア。                                        |
| resource_findings_critical      | INTEGER  | 重大な検出結果の数。                                                               |
| resource_findings_high          | INTEGER  | 高重大度の検出結果の数。                                                          |
| resource_findings_medium        | INTEGER  | 中重大度の検出結果の数。                                                        |
| resource_findings_low           | INTEGER  | 低重大度の検出結果の数。                                                           |
| resource_findings_informational | INTEGER  | 情報提供の検出結果の数。                                                          |

#### 検出結果

| カラム名                 | データ型 | 説明                                                              |
| ------------------------ | -------- | ----------------------------------------------------------------- |
| finding_id               | VARCHAR  | 検出結果の一意の識別子。プライマリキーとして機能します。 |
| finding_title            | VARCHAR  | 検出結果のタイトル。                                          |
| finding_severity         | VARCHAR  | 検出結果の重大度。                                       |
| finding_workflowstatus   | VARCHAR  | 検出結果のワークフローステータス。                                |
| finding_recordstate      | VARCHAR  | 検出結果のレコード状態。                                    |
| finding_compliancestatus | VARCHAR  | 検出結果のコンプライアンスステータス。                              |
| finding_productarn       | VARCHAR  | 検出結果を生成する製品の ARN。                     |
| finding_resource_arn     | VARCHAR  | 関連するリソースの ARN。                                |

#### アカウント

| カラム名                        | データ型 | 説明                                                                        |
| ------------------------------- | -------- | --------------------------------------------------------------------------- |
| account_id                      | INTEGER  | アカウントの一意の識別子。プライマリキーとして機能します。            |
| account_alias                   | VARCHAR  | アカウントのエイリアス。                                                     |
| account_organizations_id        | VARCHAR  | アカウントが属する組織の ID。                            |
| account_organizations_arn       | VARCHAR  | アカウントが属する組織の ARN。                           |
| account_master_account_id       | VARCHAR  | このアカウントが AWS Organizations の一部である場合のマスターアカウントの ID。 |
| account_master_account_email    | VARCHAR  | マスターアカウントに関連付けられたメールアドレス。                         |
| account_alternate_contact_type  | VARCHAR  | 代替連絡先のタイプ (例: 請求、セキュリティ)。                      |
| account_alternate_contact_name  | VARCHAR  | 代替連絡先の名前。                                            |
| account_alternate_contact_email | VARCHAR  | 代替連絡先のメールアドレス。                                   |
| account_alternate_contact_phone | VARCHAR  | 代替連絡先の電話番号。                                    |
| account_alternate_contact_title | VARCHAR  | 代替連絡先の役職。                                            |

# フィルター

ソースから取得するセキュリティ検出結果やリソースをさまざまな方法でフィルタリングし、それらをすべて組み合わせて目的のものを正確に取得できます。その後、それらのフィルターを再利用して、自動化、アラート、レポートなどを作成できます。

- [Security Hub フィルタリング](#security-hub-filtering)
- [YAML テンプレートを使用した Security Hub フィルタリング](#security-hub-filtering-using-yaml-templates)
- [Config フィルター](#config-filters)
- [タグフィルター](#tags-filters)
- [影響フィルター](#impact-filters)

## Security Hub フィルタリング

MetaHub は、オプション `--sh-filters` を使用して、AWS CLI でフィルタリングするのと同じ方法で AWS Security Hub の検出結果を `KEY=VALUE` 形式でフィルタリングすることをサポートしていますが、`EQUALS` 比較に限定されます。別の比較を行いたい場合は、オプション `--sh-template` [YAML テンプレートを使用した Security Hub フィルタリング](#security-hub-filtering-using-yaml-templates) を使用してください。

利用可能なフィルターは [AWS ドキュメント](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/securityhub.html#SecurityHub.Client.get_findings) で確認できます。```sh
./metahub --sh-filters <KEY=VALUE>

If a value contains spaces, you should specify it using double quotes: `"ProductName="Security Hub"`

You can add how many different filters you need to your query and also add the same filter key with different values:

Examples:

- Filter by Severity (CRITICAL):```sh
./metaHub --sh-filters RecordState=ACTIVE WorkflowStatus=NEW SeverityLabel=CRITICAL

- 重要度とAWSアカウントでフィルタリング:```sh
./metaHub --sh-filters RecordState=ACTIVE WorkflowStatus=NEW SeverityLabel=CRITICAL AwsAccountId=1234567890

- AWSリソースタイプでフィルタリング:```sh
./metahub --sh-filters RecordState=ACTIVE WorkflowStatus=NEW ResourceType=AwsEc2SecurityGroup

- Finding Idでフィルター:```sh
./metahub --sh-filters Id="arn:aws:security hub:eu-west-1:01234567890:subscription/aws-foundational-security-best-practices/v/1.0.0/EC2.19/finding/01234567890-1234-1234-1234-01234567890"

## YAMLテンプレートを使用したSecurity Hubフィルタリング

**MetaHub**を使うと、必要に応じて再利用可能なYAMLファイル（テンプレート）を使用して複雑なフィルターを作成できます。YAMLテンプレートでは、"EQUALS' | 'PREFIX' | 'NOT_EQUALS' | 'PREFIX_NOT_EQUALS"など、AWS Security Hubでサポートされている任意の比較演算子を使用してフィルターを記述できます。YAMLファイルを呼び出すには、`--sh-template <<FILE>>`オプションを使用します。

例は[templates](https://github.com/gabrielsoltz/metahub/blob/HEAD/templates)フォルダにあります。

- YAMLテンプレートdefault.ymlを使用したフィルター:```sh
./metaHub --sh-template templates/default.yml

- すべてのS3バケット（`ResourceType=AwsS3Bucket`）を、それらがパブリックである場合にのみ取得する（`public=True`）：```sh
./metahub --sh-filters ResourceType=AwsS3Bucket --mh-filters-config public=False

## インパクトフィルター

**MetaHub**は**インパクトフィルター**をサポートしており、MetaHubが計算した[インパクトキー](#impact)でフィルタリングできます。必要な数だけフィルターを使用でき、スペースで区切ります。複数のフィルターを指定すると、**すべて**のフィルターに一致するリソースのみが取得されます。

例：

- 露出が effectively-public と計算されたリソースに影響するすべてのセキュリティ検出結果をフィルタリング：```sh
./metahub --mh-filters-impact exposure=effectively-public

# Security Hub アクション

## ワークフローステータスの更新

**MetaHub** を使用して、AWS Security Hub の検出結果のワークフローステータス（`NOTIFIED`、`NEW`、`RESOLVED`、`SUPPRESSED`）を単一のコマンドで更新できます。MetaHub クエリのすべての検出結果を更新するには、`--update-findings` オプションを使用します。つまり、1 つ、10 個、または数千の検出結果を 1 つのコマンドだけで更新できるということです。AWS Security Hub API は更新ごとに 100 件の検出結果に制限されています。MetaHub は、この制限を回避するために結果を 100 件ずつのチャンクに分割し、検出結果をその数に関わらず更新します。

例えば、次のフィルターを使用した場合：`./metahub --sh-filters ResourceType=AwsSageMakerNotebookInstance RecordState=ACTIVE WorkflowStatus=NEW`、影響を受ける 2 つのリソースがあり、それぞれに 3 件の検出結果が存在し、合計で 6 件の Security Hub 検出結果が見つかりました。

次の更新コマンドを実行すると、それら 6 件の検出結果のワークフローステータスがノート付きで `NOTIFIED` に更新されます：```sh
./metahub --update-findings Workflow=NOTIFIED Note="Enter your ticket ID or reason here as a note that you will add to the finding as part of this update."

<p align="center">
  <img src="https://assets.kitploit.com/production/public/readmes/6190/93a45d119a712b11ae5f23ea68e3a1f7d71e0e9511df7d7dadd2b462fcde71a2.png" alt="update-findings" width="850"/>
</p>

`--enrich-findings` は、ファインディングを強化する前に確認を求めます。この確認をスキップするには、`--no-actions-confirmation` オプションを使用できます。

# コントリビューション

Context モジュールにコントリビュートしたい場合は、このガイドに従ってください。[ガイド](https://github.com/gabrielsoltz/metahub/blob/HEAD/docs/context.md)