を使用して例をシールドする AWS CLI - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用して例をシールドする AWS CLI

次のコード例は、Shield AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次のコード例は、associate-drt-log-bucket を使用する方法を示しています。

AWS CLI

Amazon S3 バケットへのアクセスを DRT に許可するには Amazon S3

次のassociate-drt-log-bucket例では、DRT と指定された S3 バケットの間に関連付けを作成します。これにより、DRT はアカウントに代わってバケットにアクセスできます。

aws shield associate-drt-log-bucket \
    --log-bucket flow-logs-for-website-lb

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドのDDoS Response Team の承認」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスの AssociateDrtLogBucket を参照してください。

次のコード例は、associate-drt-role を使用する方法を示しています。

AWS CLI

お客様に代わって潜在的な攻撃を軽減することを DRT に許可するには

次のassociate-drt-role例では、DRT と指定されたロールの間に関連付けを作成します。DRT は、 ロールを使用してアカウントにアクセスして管理できます。

aws shield associate-drt-role \
    --role-arn arn:aws:iam::123456789012:role/service-role/DrtRole

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドのDDoS Response Team の承認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のAssociateDrtRole」を参照してください。

次のコード例は、create-protection を使用する方法を示しています。

AWS CLI

1 つの AWS リソースに対して AWS Shield Advanced 保護を有効にするには

次のcreate-protection例では、指定された AWS CloudFront ディストリビューションの Shield Advanced 保護を有効にします。

aws shield create-protection \
    --name "Protection for CloudFront distribution" \
    --resource-arn arn:aws:cloudfront::123456789012:distribution/E198WC25FXOWY8

出力:

{
    "ProtectionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

詳細については、AWS Shield Advanced デベロッパーガイドの「保護するリソースを指定する」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateProtection」を参照してください。

次の例は、create-subscription を使用する方法を説明しています。

AWS CLI

アカウントの Shield Advanced AWS 保護を有効にするには

次のcreate-subscription例では、 アカウントの Shield Advanced 保護を有効にします。

aws shield create-subscription

このコマンドでは何も出力されません。

詳細については、Shield Advanced デベロッパーガイド AWS の「Shield Advanced の使用開始」を参照してください。 AWS

  • API の詳細については、 AWS CLI コマンドリファレンスの CreateSubscription を参照してください。

次の例は、delete-protection を使用する方法を説明しています。

AWS CLI

AWS リソースから Shield Advanced AWS 保護を削除するには

次のdelete-protection例では、指定された Shield Advanced AWS 保護を削除します。

aws shield delete-protection \
    --protection-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドの AWS 「リソースから Shield Advanced を削除する」を参照してください。 AWS

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteProtection」を参照してください。

次の例は、describe-attack を使用する方法を説明しています。

AWS CLI

攻撃の詳細な説明を取得するには

次のdescribe-attack例では、指定された攻撃 ID を持つ DDoS 攻撃の詳細を表示します。list-attacks コマンドを実行すると、アタックIDsを取得できます。

aws shield describe-attack --attack-id a1b2c3d4-5678-90ab-cdef-EXAMPLE22222

出力:

{
    "Attack": {
        "AttackId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "ResourceArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/testElb",
        "SubResources": [
            {
                "Type": "IP",
                "Id": "192.0.2.2",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 11786208.0,
                                "N": 12,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            },
            {
                "Type": "IP",
                "Id": "192.0.2.3",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 9821840.0,
                                "N": 10,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            },
            {
                "Type": "IP",
                "Id": "192.0.2.4",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 7857472.0,
                                "N": 8,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            },
            {
                "Type": "IP",
                "Id": "192.0.2.5",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 1964368.0,
                                "N": 2,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            },
            {
                "Type": "IP",
                "Id": "2001:DB8::bcde:4321:8765:0:0",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 1964368.0,
                                "N": 2,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            },
            {
                "Type": "IP",
                "Id": "192.0.2.6",
                "AttackVectors": [
                    {
                        "VectorType": "SYN_FLOOD",
                        "VectorCounters": [
                            {
                                "Name": "SYN_FLOOD_BPS",
                                "Max": 982184.0,
                                "Average": 982184.0,
                                "Sum": 1964368.0,
                                "N": 2,
                                "Unit": "BPS"
                            }
                        ]
                    }
                ],
                "Counters": []
            }
        ],
        "StartTime": 1576024927.457,
        "EndTime": 1576025647.457,
        "AttackCounters": [],
        "AttackProperties": [
            {
                "AttackLayer": "NETWORK",
                "AttackPropertyIdentifier": "SOURCE_IP_ADDRESS",
                "TopContributors": [
                    {
                        "Name": "198.51.100.5",
                        "Value": 2024475682
                    },
                    {
                        "Name": "198.51.100.8",
                        "Value": 1311380863
                    },
                    {
                        "Name": "203.0.113.4",
                        "Value": 900599855
                    },
                    {
                        "Name": "198.51.100.4",
                        "Value": 769417366
                    },
                    {
                        "Name": "203.1.113.13",
                        "Value": 757992847
                    }
                ],
                "Unit": "BYTES",
                "Total": 92773354841
            },
            {
                "AttackLayer": "NETWORK",
                "AttackPropertyIdentifier": "SOURCE_COUNTRY",
                "TopContributors": [
                    {
                        "Name": "United States",
                        "Value": 80938161764
                    },
                    {
                        "Name": "Brazil",
                        "Value": 9929864330
                    },
                    {
                        "Name": "Netherlands",
                        "Value": 1635009446
                    },
                    {
                        "Name": "Mexico",
                        "Value": 144832971
                    },
                    {
                        "Name": "Japan",
                        "Value": 45369000
                    }
                ],
                "Unit": "BYTES",
                "Total": 92773354841
            },
            {
                "AttackLayer": "NETWORK",
                "AttackPropertyIdentifier": "SOURCE_ASN",
                "TopContributors": [
                    {
                        "Name": "12345",
                        "Value": 74953625841
                    },
                    {
                        "Name": "12346",
                        "Value": 4440087595
                    },
                    {
                        "Name": "12347",
                        "Value": 1635009446
                    },
                    {
                        "Name": "12348",
                        "Value": 1221230000
                    },
                    {
                        "Name": "12349",
                        "Value": 1199425294
                    }
                ],
                "Unit": "BYTES",
                "Total": 92755479921
            }
        ],
        "Mitigations": []
    }
}

詳細については、AWS Shield Advanced デベロッパーガイドのDDoSインシデントの確認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeAttack」を参照してください。

次の例は、describe-drt-access を使用する方法を説明しています。

AWS CLI

DRT がユーザーに代わって攻撃を軽減するために必要とする認可の説明を取得するには

次のdescribe-drt-access例では、DRT が持つロールと S3 バケット認可を取得し、ユーザーに代わって潜在的な攻撃に応答できるようにします。

aws shield describe-drt-access

出力:

{
    "RoleArn": "arn:aws:iam::123456789012:role/service-role/DrtRole",
    "LogBucketList": [
        "flow-logs-for-website-lb"
    ]
}

詳細については、AWS Shield Advanced デベロッパーガイドのDDoS Response Team の承認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeDrtAccess」を参照してください。

次のコード例は、describe-emergency-contact-settings を使用する方法を示しています。

AWS CLI

DRT でファイルに保存されている緊急 E メールアドレスを取得するには

次のdescribe-emergency-contact-settings例では、アカウントの DRT に登録されている E メールアドレスを取得します。これらは、疑わしい攻撃に応答しているときに DRT が問い合わせるアドレスです。

aws shield describe-emergency-contact-settings

出力:

{
    "EmergencyContactList": [
        {
            "EmailAddress": "ops@example.com"
        },
        {
            "EmailAddress": "ddos-notifications@example.com"
       }
    ]
}

詳細については、 AWS Shield AWS Advanced デベロッパーガイドの「Shield の仕組み＜latest/developerguide/ddoshttps://docs.aws.amazon.com/waf/-overview.html>」を参照してください。

次のコード例は、describe-protection を使用する方法を示しています。

AWS CLI

Shield Advanced AWS 保護の詳細を取得するには

次のdescribe-protection例では、指定された ID を持つ Shield Advanced 保護の詳細を表示します。list-protections コマンドを実行すると、保護 IDs を取得できます。

aws shield describe-protection \
    --protection-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

出力:

{
    "Protection": {
        "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "Name": "1.2.3.4",
        "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:eip-allocation/eipalloc-0ac1537af40742a6d"
    }
}

詳細については、AWS Shield Advanced デベロッパーガイドの「保護するリソースを指定する」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeProtection」を参照してください。

次の例は、describe-subscription を使用する方法を説明しています。

AWS CLI

アカウントの Shield Advanced AWS 保護の詳細を取得するには

次のdescribe-subscription例は、 アカウントに提供される Shield Advanced 保護の詳細を示しています。

aws shield describe-subscription

出力:

{
    "Subscription": {
        "StartTime": 1534368978.0,
        "EndTime": 1597613778.0,
        "TimeCommitmentInSeconds": 63244800,
        "AutoRenew": "ENABLED",
        "Limits": [
            {
                "Type": "GLOBAL_ACCELERATOR",
                "Max": 1000
            },
            {
                "Type": "ROUTE53_HOSTED_ZONE",
                "Max": 1000
            },
            {
                "Type": "CF_DISTRIBUTION",
                "Max": 1000
            },
            {
                "Type": "ELB_LOAD_BALANCER",
                "Max": 1000
            },
            {
                "Type": "EC2_ELASTIC_IP_ALLOCATION",
                "Max": 1000
            }
        ]
    }
}

詳細については、AWS Shield Advanced デベロッパーガイドの「Shield の仕組み」を参照してください。 AWS

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeSubscription」を参照してください。

次のコード例は、disassociate-drt-log-bucket を使用する方法を示しています。

AWS CLI

DRT がユーザーに代わって Amazon S3 バケットにアクセスする許可を削除するには

次のdisassociate-drt-log-bucket例では、DRT と指定された S3 バケットの間の関連付けを削除します。このコマンドが完了すると、DRT はアカウントに代わってバケットにアクセスできなくなります。

aws shield disassociate-drt-log-bucket \
    --log-bucket flow-logs-for-website-lb

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドのDDoS Response Team の承認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDisassociateDrtLogBucket」を参照してください。

次のコード例は、disassociate-drt-role を使用する方法を示しています。

AWS CLI

ユーザーに代わって潜在的な攻撃を軽減するための DRT の認可を削除するには

次のdisassociate-drt-role例では、DRT とアカウント間の関連付けを削除します。この呼び出しの後、DRT はアカウントにアクセスまたは管理できなくなります。

aws shield disassociate-drt-role

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドのDDoS Response Team の承認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDisassociateDrtRole」を参照してください。

次の例は、get-subscription-state を使用する方法を説明しています。

AWS CLI

アカウントの Shield Advanced AWS サブスクリプションの現在の状態を取得するには

次のget-subscription-state例では、アカウントの Shield Advanced 保護の状態を取得します。

aws shield get-subscription-state

出力:

{
    "SubscriptionState": "ACTIVE"
}

詳細については、AWS Shield Advanced デベロッパーガイドの「Shield の仕組み」を参照してください。 AWS

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のGetSubscriptionState」を参照してください。

次の例は、list-attacks を使用する方法を説明しています。

AWS CLI

Shield Advanced AWS から攻撃の概要を取得するには

次のlist-attacks例では、指定された期間中の指定された AWS CloudFront ディストリビューションの攻撃の概要を取得します。レスポンスには、攻撃に関する詳細情報のために describe-attack コマンドに提供できる攻撃IDsが含まれます。

aws shield list-attacks \
    --resource-arns arn:aws:cloudfront::12345678910:distribution/E1PXMP22ZVFAOR \
    --start-time FromInclusive=1529280000,ToExclusive=1529300000

出力:

{
    "AttackSummaries": [
        {
            "AttackId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "ResourceArn": "arn:aws:cloudfront::123456789012:distribution/E1PXMP22ZVFAOR",
            "StartTime": 1529280000.0,
            "EndTime": 1529449200.0,
            "AttackVectors": [
                {
                    "VectorType": "SYN_FLOOD"
                }
            ]
        }
    ]
}

詳細については、AWS Shield Advanced デベロッパーガイドのDDoSインシデントの確認」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListAttacks」を参照してください。

次のコード例は、list-protections を使用する方法を示しています。

AWS CLI

Shield Advanced AWS から保護の概要を取得するには

次のlist-protections例では、 アカウントで有効になっている保護の概要を取得します。

aws shield list-protections

出力:

{
    "Protections": [
        {
            "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "Name": "Protection for CloudFront distribution",
            "ResourceArn": "arn:aws:cloudfront::123456789012:distribution/E198WC25FXOWY8"
        }
    ]
}

詳細については、AWS Shield Advanced デベロッパーガイドの「保護するリソースを指定する」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListProtections」を参照してください。

次のコード例は、update-emergency-contact-settings を使用する方法を示しています。

AWS CLI

DRT でファイルされている緊急 E メールアドレスを定義するには

次のupdate-emergency-contact-settings例では、疑わしい攻撃に応答しているときに DRT が問い合わせるべき 2 つの E メールアドレスを定義します。

aws shield update-emergency-contact-settings \
        --emergency-contact-list EmailAddress=ops@example.com EmailAddress=ddos-notifications@example.com

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドの「Shield の仕組み」を参照してください。 AWS

次の例は、update-subscription を使用する方法を説明しています。

AWS CLI

アカウントの Shield Advanced AWS サブスクリプションを変更するには

次のupdate-subscription例では、アカウントの AWS Shield Advanced サブスクリプションの自動更新を有効にします。

aws shield update-subscription \
    --auto-renew ENABLED

このコマンドでは何も出力されません。

詳細については、AWS Shield Advanced デベロッパーガイドの「Shield の仕組み」を参照してください。 AWS

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateSubscription」を参照してください。