aws-sdk-securityhub 1.96.0 → 1.98.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-securityhub/client.rb +1209 -28
- data/lib/aws-sdk-securityhub/client_api.rb +410 -0
- data/lib/aws-sdk-securityhub/endpoints.rb +140 -0
- data/lib/aws-sdk-securityhub/plugins/endpoints.rb +23 -2
- data/lib/aws-sdk-securityhub/types.rb +1090 -32
- data/lib/aws-sdk-securityhub.rb +1 -1
- metadata +2 -2
@@ -930,6 +930,15 @@ module Aws::SecurityHub
|
|
930
930
|
# resp.rules[0].criteria.user_defined_fields[0].key #=> String
|
931
931
|
# resp.rules[0].criteria.user_defined_fields[0].value #=> String
|
932
932
|
# resp.rules[0].criteria.user_defined_fields[0].comparison #=> String, one of "EQUALS", "NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
933
|
+
# resp.rules[0].criteria.resource_application_arn #=> Array
|
934
|
+
# resp.rules[0].criteria.resource_application_arn[0].value #=> String
|
935
|
+
# resp.rules[0].criteria.resource_application_arn[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
936
|
+
# resp.rules[0].criteria.resource_application_name #=> Array
|
937
|
+
# resp.rules[0].criteria.resource_application_name[0].value #=> String
|
938
|
+
# resp.rules[0].criteria.resource_application_name[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
939
|
+
# resp.rules[0].criteria.aws_account_name #=> Array
|
940
|
+
# resp.rules[0].criteria.aws_account_name[0].value #=> String
|
941
|
+
# resp.rules[0].criteria.aws_account_name[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
933
942
|
# resp.rules[0].actions #=> Array
|
934
943
|
# resp.rules[0].actions[0].type #=> String, one of "FINDING_FIELDS_UPDATE"
|
935
944
|
# resp.rules[0].actions[0].finding_fields_update.note.text #=> String
|
@@ -965,6 +974,108 @@ module Aws::SecurityHub
|
|
965
974
|
req.send_request(options)
|
966
975
|
end
|
967
976
|
|
977
|
+
# Returns associations between an Security Hub configuration and a batch
|
978
|
+
# of target accounts, organizational units, or the root. Only the
|
979
|
+
# Security Hub delegated administrator can invoke this operation from
|
980
|
+
# the home Region. A configuration can refer to a configuration policy
|
981
|
+
# or to a self-managed configuration.
|
982
|
+
#
|
983
|
+
# @option params [required, Array<Types::ConfigurationPolicyAssociation>] :configuration_policy_association_identifiers
|
984
|
+
# Specifies one or more target account IDs, organizational unit (OU)
|
985
|
+
# IDs, or the root ID to retrieve associations for.
|
986
|
+
#
|
987
|
+
# @return [Types::BatchGetConfigurationPolicyAssociationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
988
|
+
#
|
989
|
+
# * {Types::BatchGetConfigurationPolicyAssociationsResponse#configuration_policy_associations #configuration_policy_associations} => Array<Types::ConfigurationPolicyAssociationSummary>
|
990
|
+
# * {Types::BatchGetConfigurationPolicyAssociationsResponse#unprocessed_configuration_policy_associations #unprocessed_configuration_policy_associations} => Array<Types::UnprocessedConfigurationPolicyAssociation>
|
991
|
+
#
|
992
|
+
#
|
993
|
+
# @example Example: To get configuration associations for a batch of targets
|
994
|
+
#
|
995
|
+
# # This operation provides details about configuration associations for a batch of target accounts, organizational units,
|
996
|
+
# # or the root.
|
997
|
+
#
|
998
|
+
# resp = client.batch_get_configuration_policy_associations({
|
999
|
+
# configuration_policy_association_identifiers: [
|
1000
|
+
# {
|
1001
|
+
# target: {
|
1002
|
+
# account_id: "111122223333",
|
1003
|
+
# },
|
1004
|
+
# },
|
1005
|
+
# {
|
1006
|
+
# target: {
|
1007
|
+
# root_id: "r-f6g7h8i9j0example",
|
1008
|
+
# },
|
1009
|
+
# },
|
1010
|
+
# ],
|
1011
|
+
# })
|
1012
|
+
#
|
1013
|
+
# resp.to_h outputs the following:
|
1014
|
+
# {
|
1015
|
+
# configuration_policy_associations: [
|
1016
|
+
# {
|
1017
|
+
# association_status: "SUCCESS",
|
1018
|
+
# association_status_message: "This field is only populated for a failed association",
|
1019
|
+
# association_type: "INHERITED",
|
1020
|
+
# configuration_policy_id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
1021
|
+
# target_id: "111122223333",
|
1022
|
+
# target_type: "ACCOUNT",
|
1023
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
1024
|
+
# },
|
1025
|
+
# ],
|
1026
|
+
# unprocessed_configuration_policy_associations: [
|
1027
|
+
# {
|
1028
|
+
# configuration_policy_association_identifiers: {
|
1029
|
+
# target: {
|
1030
|
+
# root_id: "r-f6g7h8i9j0example",
|
1031
|
+
# },
|
1032
|
+
# },
|
1033
|
+
# error_code: "400",
|
1034
|
+
# error_reason: "You do not have sufficient access to perform this action.",
|
1035
|
+
# },
|
1036
|
+
# ],
|
1037
|
+
# }
|
1038
|
+
#
|
1039
|
+
# @example Request syntax with placeholder values
|
1040
|
+
#
|
1041
|
+
# resp = client.batch_get_configuration_policy_associations({
|
1042
|
+
# configuration_policy_association_identifiers: [ # required
|
1043
|
+
# {
|
1044
|
+
# target: {
|
1045
|
+
# account_id: "NonEmptyString",
|
1046
|
+
# organizational_unit_id: "NonEmptyString",
|
1047
|
+
# root_id: "NonEmptyString",
|
1048
|
+
# },
|
1049
|
+
# },
|
1050
|
+
# ],
|
1051
|
+
# })
|
1052
|
+
#
|
1053
|
+
# @example Response structure
|
1054
|
+
#
|
1055
|
+
# resp.configuration_policy_associations #=> Array
|
1056
|
+
# resp.configuration_policy_associations[0].configuration_policy_id #=> String
|
1057
|
+
# resp.configuration_policy_associations[0].target_id #=> String
|
1058
|
+
# resp.configuration_policy_associations[0].target_type #=> String, one of "ACCOUNT", "ORGANIZATIONAL_UNIT"
|
1059
|
+
# resp.configuration_policy_associations[0].association_type #=> String, one of "INHERITED", "APPLIED"
|
1060
|
+
# resp.configuration_policy_associations[0].updated_at #=> Time
|
1061
|
+
# resp.configuration_policy_associations[0].association_status #=> String, one of "PENDING", "SUCCESS", "FAILED"
|
1062
|
+
# resp.configuration_policy_associations[0].association_status_message #=> String
|
1063
|
+
# resp.unprocessed_configuration_policy_associations #=> Array
|
1064
|
+
# resp.unprocessed_configuration_policy_associations[0].configuration_policy_association_identifiers.target.account_id #=> String
|
1065
|
+
# resp.unprocessed_configuration_policy_associations[0].configuration_policy_association_identifiers.target.organizational_unit_id #=> String
|
1066
|
+
# resp.unprocessed_configuration_policy_associations[0].configuration_policy_association_identifiers.target.root_id #=> String
|
1067
|
+
# resp.unprocessed_configuration_policy_associations[0].error_code #=> String
|
1068
|
+
# resp.unprocessed_configuration_policy_associations[0].error_reason #=> String
|
1069
|
+
#
|
1070
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/BatchGetConfigurationPolicyAssociations AWS API Documentation
|
1071
|
+
#
|
1072
|
+
# @overload batch_get_configuration_policy_associations(params = {})
|
1073
|
+
# @param [Hash] params ({})
|
1074
|
+
def batch_get_configuration_policy_associations(params = {}, options = {})
|
1075
|
+
req = build_request(:batch_get_configuration_policy_associations, params)
|
1076
|
+
req.send_request(options)
|
1077
|
+
end
|
1078
|
+
|
968
1079
|
# Provides details about a batch of security controls for the current
|
969
1080
|
# Amazon Web Services account and Amazon Web Services Region.
|
970
1081
|
#
|
@@ -1606,6 +1717,24 @@ module Aws::SecurityHub
|
|
1606
1717
|
# comparison: "EQUALS", # accepts EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
1607
1718
|
# },
|
1608
1719
|
# ],
|
1720
|
+
# resource_application_arn: [
|
1721
|
+
# {
|
1722
|
+
# value: "NonEmptyString",
|
1723
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
1724
|
+
# },
|
1725
|
+
# ],
|
1726
|
+
# resource_application_name: [
|
1727
|
+
# {
|
1728
|
+
# value: "NonEmptyString",
|
1729
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
1730
|
+
# },
|
1731
|
+
# ],
|
1732
|
+
# aws_account_name: [
|
1733
|
+
# {
|
1734
|
+
# value: "NonEmptyString",
|
1735
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
1736
|
+
# },
|
1737
|
+
# ],
|
1609
1738
|
# },
|
1610
1739
|
# actions: [
|
1611
1740
|
# {
|
@@ -2035,7 +2164,7 @@ module Aws::SecurityHub
|
|
2035
2164
|
# Creates an automation rule based on input parameters.
|
2036
2165
|
#
|
2037
2166
|
# @option params [Hash<String,String>] :tags
|
2038
|
-
# User-defined tags
|
2167
|
+
# User-defined tags associated with an automation rule.
|
2039
2168
|
#
|
2040
2169
|
# @option params [String] :rule_status
|
2041
2170
|
# Whether the rule is active after it is created. If this parameter is
|
@@ -2399,6 +2528,24 @@ module Aws::SecurityHub
|
|
2399
2528
|
# comparison: "EQUALS", # accepts EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
2400
2529
|
# },
|
2401
2530
|
# ],
|
2531
|
+
# resource_application_arn: [
|
2532
|
+
# {
|
2533
|
+
# value: "NonEmptyString",
|
2534
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
2535
|
+
# },
|
2536
|
+
# ],
|
2537
|
+
# resource_application_name: [
|
2538
|
+
# {
|
2539
|
+
# value: "NonEmptyString",
|
2540
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
2541
|
+
# },
|
2542
|
+
# ],
|
2543
|
+
# aws_account_name: [
|
2544
|
+
# {
|
2545
|
+
# value: "NonEmptyString",
|
2546
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
2547
|
+
# },
|
2548
|
+
# ],
|
2402
2549
|
# },
|
2403
2550
|
# actions: [ # required
|
2404
2551
|
# {
|
@@ -2447,6 +2594,200 @@ module Aws::SecurityHub
|
|
2447
2594
|
req.send_request(options)
|
2448
2595
|
end
|
2449
2596
|
|
2597
|
+
# Creates a configuration policy with the defined configuration. Only
|
2598
|
+
# the Security Hub delegated administrator can invoke this operation
|
2599
|
+
# from the home Region.
|
2600
|
+
#
|
2601
|
+
# @option params [required, String] :name
|
2602
|
+
# The name of the configuration policy.
|
2603
|
+
#
|
2604
|
+
# @option params [String] :description
|
2605
|
+
# The description of the configuration policy.
|
2606
|
+
#
|
2607
|
+
# @option params [required, Types::Policy] :configuration_policy
|
2608
|
+
# An object that defines how Security Hub is configured. It includes
|
2609
|
+
# whether Security Hub is enabled or disabled, a list of enabled
|
2610
|
+
# security standards, a list of enabled or disabled security controls,
|
2611
|
+
# and a list of custom parameter values for specified controls. If you
|
2612
|
+
# provide a list of security controls that are enabled in the
|
2613
|
+
# configuration policy, Security Hub disables all other controls
|
2614
|
+
# (including newly released controls). If you provide a list of security
|
2615
|
+
# controls that are disabled in the configuration policy, Security Hub
|
2616
|
+
# enables all other controls (including newly released controls).
|
2617
|
+
#
|
2618
|
+
# @option params [Hash<String,String>] :tags
|
2619
|
+
# User-defined tags associated with a configuration policy. For more
|
2620
|
+
# information, see [Tagging Security Hub resources][1] in the *Security
|
2621
|
+
# Hub user guide*.
|
2622
|
+
#
|
2623
|
+
#
|
2624
|
+
#
|
2625
|
+
# [1]: https://docs.aws.amazon.com/securityhub/latest/userguide/tagging-resources.html
|
2626
|
+
#
|
2627
|
+
# @return [Types::CreateConfigurationPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2628
|
+
#
|
2629
|
+
# * {Types::CreateConfigurationPolicyResponse#arn #arn} => String
|
2630
|
+
# * {Types::CreateConfigurationPolicyResponse#id #id} => String
|
2631
|
+
# * {Types::CreateConfigurationPolicyResponse#name #name} => String
|
2632
|
+
# * {Types::CreateConfigurationPolicyResponse#description #description} => String
|
2633
|
+
# * {Types::CreateConfigurationPolicyResponse#updated_at #updated_at} => Time
|
2634
|
+
# * {Types::CreateConfigurationPolicyResponse#created_at #created_at} => Time
|
2635
|
+
# * {Types::CreateConfigurationPolicyResponse#configuration_policy #configuration_policy} => Types::Policy
|
2636
|
+
#
|
2637
|
+
#
|
2638
|
+
# @example Example: To create a configuration policy
|
2639
|
+
#
|
2640
|
+
# # This operation creates a configuration policy in Security Hub.
|
2641
|
+
#
|
2642
|
+
# resp = client.create_configuration_policy({
|
2643
|
+
# configuration_policy: {
|
2644
|
+
# security_hub: {
|
2645
|
+
# enabled_standard_identifiers: [
|
2646
|
+
# "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
|
2647
|
+
# "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
|
2648
|
+
# ],
|
2649
|
+
# security_controls_configuration: {
|
2650
|
+
# disabled_security_control_identifiers: [
|
2651
|
+
# "CloudWatch.1",
|
2652
|
+
# ],
|
2653
|
+
# security_control_custom_parameters: [
|
2654
|
+
# {
|
2655
|
+
# parameters: {
|
2656
|
+
# "daysToExpiration" => {
|
2657
|
+
# value: {
|
2658
|
+
# integer: 14,
|
2659
|
+
# },
|
2660
|
+
# value_type: "CUSTOM",
|
2661
|
+
# },
|
2662
|
+
# },
|
2663
|
+
# security_control_id: "ACM.1",
|
2664
|
+
# },
|
2665
|
+
# ],
|
2666
|
+
# },
|
2667
|
+
# service_enabled: true,
|
2668
|
+
# },
|
2669
|
+
# },
|
2670
|
+
# description: "Configuration policy for testing FSBP and CIS",
|
2671
|
+
# name: "TestConfigurationPolicy",
|
2672
|
+
# })
|
2673
|
+
#
|
2674
|
+
# resp.to_h outputs the following:
|
2675
|
+
# {
|
2676
|
+
# arn: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
2677
|
+
# configuration_policy: {
|
2678
|
+
# security_hub: {
|
2679
|
+
# enabled_standard_identifiers: [
|
2680
|
+
# "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
|
2681
|
+
# "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
|
2682
|
+
# ],
|
2683
|
+
# security_controls_configuration: {
|
2684
|
+
# disabled_security_control_identifiers: [
|
2685
|
+
# "CloudWatch.1",
|
2686
|
+
# ],
|
2687
|
+
# security_control_custom_parameters: [
|
2688
|
+
# {
|
2689
|
+
# parameters: {
|
2690
|
+
# "daysToExpiration" => {
|
2691
|
+
# value: {
|
2692
|
+
# integer: 14,
|
2693
|
+
# },
|
2694
|
+
# value_type: "CUSTOM",
|
2695
|
+
# },
|
2696
|
+
# },
|
2697
|
+
# security_control_id: "ACM.1",
|
2698
|
+
# },
|
2699
|
+
# ],
|
2700
|
+
# },
|
2701
|
+
# service_enabled: true,
|
2702
|
+
# },
|
2703
|
+
# },
|
2704
|
+
# created_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
2705
|
+
# description: "Configuration policy for testing FSBP and CIS",
|
2706
|
+
# id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
2707
|
+
# name: "TestConfigurationPolicy",
|
2708
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
2709
|
+
# }
|
2710
|
+
#
|
2711
|
+
# @example Request syntax with placeholder values
|
2712
|
+
#
|
2713
|
+
# resp = client.create_configuration_policy({
|
2714
|
+
# name: "NonEmptyString", # required
|
2715
|
+
# description: "NonEmptyString",
|
2716
|
+
# configuration_policy: { # required
|
2717
|
+
# security_hub: {
|
2718
|
+
# service_enabled: false,
|
2719
|
+
# enabled_standard_identifiers: ["NonEmptyString"],
|
2720
|
+
# security_controls_configuration: {
|
2721
|
+
# enabled_security_control_identifiers: ["NonEmptyString"],
|
2722
|
+
# disabled_security_control_identifiers: ["NonEmptyString"],
|
2723
|
+
# security_control_custom_parameters: [
|
2724
|
+
# {
|
2725
|
+
# security_control_id: "NonEmptyString",
|
2726
|
+
# parameters: {
|
2727
|
+
# "NonEmptyString" => {
|
2728
|
+
# value_type: "DEFAULT", # required, accepts DEFAULT, CUSTOM
|
2729
|
+
# value: {
|
2730
|
+
# integer: 1,
|
2731
|
+
# integer_list: [1],
|
2732
|
+
# double: 1.0,
|
2733
|
+
# string: "NonEmptyString",
|
2734
|
+
# string_list: ["NonEmptyString"],
|
2735
|
+
# boolean: false,
|
2736
|
+
# enum: "NonEmptyString",
|
2737
|
+
# enum_list: ["NonEmptyString"],
|
2738
|
+
# },
|
2739
|
+
# },
|
2740
|
+
# },
|
2741
|
+
# },
|
2742
|
+
# ],
|
2743
|
+
# },
|
2744
|
+
# },
|
2745
|
+
# },
|
2746
|
+
# tags: {
|
2747
|
+
# "TagKey" => "TagValue",
|
2748
|
+
# },
|
2749
|
+
# })
|
2750
|
+
#
|
2751
|
+
# @example Response structure
|
2752
|
+
#
|
2753
|
+
# resp.arn #=> String
|
2754
|
+
# resp.id #=> String
|
2755
|
+
# resp.name #=> String
|
2756
|
+
# resp.description #=> String
|
2757
|
+
# resp.updated_at #=> Time
|
2758
|
+
# resp.created_at #=> Time
|
2759
|
+
# resp.configuration_policy.security_hub.service_enabled #=> Boolean
|
2760
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers #=> Array
|
2761
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers[0] #=> String
|
2762
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers #=> Array
|
2763
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers[0] #=> String
|
2764
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers #=> Array
|
2765
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers[0] #=> String
|
2766
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters #=> Array
|
2767
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].security_control_id #=> String
|
2768
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters #=> Hash
|
2769
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value_type #=> String, one of "DEFAULT", "CUSTOM"
|
2770
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer #=> Integer
|
2771
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list #=> Array
|
2772
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list[0] #=> Integer
|
2773
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.double #=> Float
|
2774
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string #=> String
|
2775
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list #=> Array
|
2776
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list[0] #=> String
|
2777
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.boolean #=> Boolean
|
2778
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum #=> String
|
2779
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list #=> Array
|
2780
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list[0] #=> String
|
2781
|
+
#
|
2782
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/CreateConfigurationPolicy AWS API Documentation
|
2783
|
+
#
|
2784
|
+
# @overload create_configuration_policy(params = {})
|
2785
|
+
# @param [Hash] params ({})
|
2786
|
+
def create_configuration_policy(params = {}, options = {})
|
2787
|
+
req = build_request(:create_configuration_policy, params)
|
2788
|
+
req.send_request(options)
|
2789
|
+
end
|
2790
|
+
|
2450
2791
|
# Used to enable finding aggregation. Must be called from the
|
2451
2792
|
# aggregation Region.
|
2452
2793
|
#
|
@@ -3283,6 +3624,24 @@ module Aws::SecurityHub
|
|
3283
3624
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
3284
3625
|
# },
|
3285
3626
|
# ],
|
3627
|
+
# aws_account_name: [
|
3628
|
+
# {
|
3629
|
+
# value: "NonEmptyString",
|
3630
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
3631
|
+
# },
|
3632
|
+
# ],
|
3633
|
+
# resource_application_name: [
|
3634
|
+
# {
|
3635
|
+
# value: "NonEmptyString",
|
3636
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
3637
|
+
# },
|
3638
|
+
# ],
|
3639
|
+
# resource_application_arn: [
|
3640
|
+
# {
|
3641
|
+
# value: "NonEmptyString",
|
3642
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
3643
|
+
# },
|
3644
|
+
# ],
|
3286
3645
|
# },
|
3287
3646
|
# group_by_attribute: "NonEmptyString", # required
|
3288
3647
|
# })
|
@@ -3511,6 +3870,42 @@ module Aws::SecurityHub
|
|
3511
3870
|
req.send_request(options)
|
3512
3871
|
end
|
3513
3872
|
|
3873
|
+
# Deletes a configuration policy. Only the Security Hub delegated
|
3874
|
+
# administrator can invoke this operation from the home Region. For the
|
3875
|
+
# deletion to succeed, you must first disassociate a configuration
|
3876
|
+
# policy from target accounts, organizational units, or the root by
|
3877
|
+
# invoking the `StartConfigurationPolicyDisassociation` operation.
|
3878
|
+
#
|
3879
|
+
# @option params [required, String] :identifier
|
3880
|
+
# The Amazon Resource Name (ARN) or universally unique identifier (UUID)
|
3881
|
+
# of the configuration policy.
|
3882
|
+
#
|
3883
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
3884
|
+
#
|
3885
|
+
#
|
3886
|
+
# @example Example: To delete a configuration policy
|
3887
|
+
#
|
3888
|
+
# # This operation deletes the specified configuration policy.
|
3889
|
+
#
|
3890
|
+
# resp = client.delete_configuration_policy({
|
3891
|
+
# identifier: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
3892
|
+
# })
|
3893
|
+
#
|
3894
|
+
# @example Request syntax with placeholder values
|
3895
|
+
#
|
3896
|
+
# resp = client.delete_configuration_policy({
|
3897
|
+
# identifier: "NonEmptyString", # required
|
3898
|
+
# })
|
3899
|
+
#
|
3900
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DeleteConfigurationPolicy AWS API Documentation
|
3901
|
+
#
|
3902
|
+
# @overload delete_configuration_policy(params = {})
|
3903
|
+
# @param [Hash] params ({})
|
3904
|
+
def delete_configuration_policy(params = {}, options = {})
|
3905
|
+
req = build_request(:delete_configuration_policy, params)
|
3906
|
+
req.send_request(options)
|
3907
|
+
end
|
3908
|
+
|
3514
3909
|
# Deletes a finding aggregator. When you delete the finding aggregator,
|
3515
3910
|
# you stop finding aggregation.
|
3516
3911
|
#
|
@@ -3830,29 +4225,35 @@ module Aws::SecurityHub
|
|
3830
4225
|
req.send_request(options)
|
3831
4226
|
end
|
3832
4227
|
|
3833
|
-
# Returns information about the
|
3834
|
-
# Hub.
|
4228
|
+
# Returns information about the way your organization is configured in
|
4229
|
+
# Security Hub. Only the Security Hub administrator account can invoke
|
4230
|
+
# this operation.
|
3835
4231
|
#
|
3836
4232
|
# @return [Types::DescribeOrganizationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
3837
4233
|
#
|
3838
4234
|
# * {Types::DescribeOrganizationConfigurationResponse#auto_enable #auto_enable} => Boolean
|
3839
4235
|
# * {Types::DescribeOrganizationConfigurationResponse#member_account_limit_reached #member_account_limit_reached} => Boolean
|
3840
4236
|
# * {Types::DescribeOrganizationConfigurationResponse#auto_enable_standards #auto_enable_standards} => String
|
4237
|
+
# * {Types::DescribeOrganizationConfigurationResponse#organization_configuration #organization_configuration} => Types::OrganizationConfiguration
|
3841
4238
|
#
|
3842
4239
|
#
|
3843
|
-
# @example Example: To get information about
|
4240
|
+
# @example Example: To get information about organization configuration
|
3844
4241
|
#
|
3845
|
-
# #
|
3846
|
-
# #
|
4242
|
+
# # This operation provides information about the way your organization is configured in Security Hub. Only a Security Hub
|
4243
|
+
# # administrator account can invoke this operation.
|
3847
4244
|
#
|
3848
4245
|
# resp = client.describe_organization_configuration({
|
3849
4246
|
# })
|
3850
4247
|
#
|
3851
4248
|
# resp.to_h outputs the following:
|
3852
4249
|
# {
|
3853
|
-
# auto_enable:
|
3854
|
-
# auto_enable_standards: "
|
3855
|
-
# member_account_limit_reached:
|
4250
|
+
# auto_enable: false,
|
4251
|
+
# auto_enable_standards: "NONE",
|
4252
|
+
# member_account_limit_reached: false,
|
4253
|
+
# organization_configuration: {
|
4254
|
+
# configuration_type: "CENTRAL",
|
4255
|
+
# status: "ENABLED",
|
4256
|
+
# },
|
3856
4257
|
# }
|
3857
4258
|
#
|
3858
4259
|
# @example Response structure
|
@@ -3860,6 +4261,9 @@ module Aws::SecurityHub
|
|
3860
4261
|
# resp.auto_enable #=> Boolean
|
3861
4262
|
# resp.member_account_limit_reached #=> Boolean
|
3862
4263
|
# resp.auto_enable_standards #=> String, one of "NONE", "DEFAULT"
|
4264
|
+
# resp.organization_configuration.configuration_type #=> String, one of "CENTRAL", "LOCAL"
|
4265
|
+
# resp.organization_configuration.status #=> String, one of "PENDING", "ENABLED", "FAILED"
|
4266
|
+
# resp.organization_configuration.status_message #=> String
|
3863
4267
|
#
|
3864
4268
|
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/DescribeOrganizationConfiguration AWS API Documentation
|
3865
4269
|
#
|
@@ -4583,6 +4987,188 @@ module Aws::SecurityHub
|
|
4583
4987
|
req.send_request(options)
|
4584
4988
|
end
|
4585
4989
|
|
4990
|
+
# Provides information about a configuration policy. Only the Security
|
4991
|
+
# Hub delegated administrator can invoke this operation from the home
|
4992
|
+
# Region.
|
4993
|
+
#
|
4994
|
+
# @option params [required, String] :identifier
|
4995
|
+
# The Amazon Resource Name (ARN) or universally unique identifier (UUID)
|
4996
|
+
# of the configuration policy.
|
4997
|
+
#
|
4998
|
+
# @return [Types::GetConfigurationPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4999
|
+
#
|
5000
|
+
# * {Types::GetConfigurationPolicyResponse#arn #arn} => String
|
5001
|
+
# * {Types::GetConfigurationPolicyResponse#id #id} => String
|
5002
|
+
# * {Types::GetConfigurationPolicyResponse#name #name} => String
|
5003
|
+
# * {Types::GetConfigurationPolicyResponse#description #description} => String
|
5004
|
+
# * {Types::GetConfigurationPolicyResponse#updated_at #updated_at} => Time
|
5005
|
+
# * {Types::GetConfigurationPolicyResponse#created_at #created_at} => Time
|
5006
|
+
# * {Types::GetConfigurationPolicyResponse#configuration_policy #configuration_policy} => Types::Policy
|
5007
|
+
#
|
5008
|
+
#
|
5009
|
+
# @example Example: To get details about a configuration policy
|
5010
|
+
#
|
5011
|
+
# # This operation provides details about the specified configuration policy.
|
5012
|
+
#
|
5013
|
+
# resp = client.get_configuration_policy({
|
5014
|
+
# identifier: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
5015
|
+
# })
|
5016
|
+
#
|
5017
|
+
# resp.to_h outputs the following:
|
5018
|
+
# {
|
5019
|
+
# arn: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
5020
|
+
# configuration_policy: {
|
5021
|
+
# security_hub: {
|
5022
|
+
# enabled_standard_identifiers: [
|
5023
|
+
# "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
|
5024
|
+
# "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
|
5025
|
+
# ],
|
5026
|
+
# security_controls_configuration: {
|
5027
|
+
# disabled_security_control_identifiers: [
|
5028
|
+
# "CloudWatch.1",
|
5029
|
+
# ],
|
5030
|
+
# security_control_custom_parameters: [
|
5031
|
+
# {
|
5032
|
+
# parameters: {
|
5033
|
+
# "daysToExpiration" => {
|
5034
|
+
# value: {
|
5035
|
+
# integer: 14,
|
5036
|
+
# },
|
5037
|
+
# value_type: "CUSTOM",
|
5038
|
+
# },
|
5039
|
+
# },
|
5040
|
+
# security_control_id: "ACM.1",
|
5041
|
+
# },
|
5042
|
+
# ],
|
5043
|
+
# },
|
5044
|
+
# service_enabled: true,
|
5045
|
+
# },
|
5046
|
+
# },
|
5047
|
+
# created_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
5048
|
+
# description: "Configuration policy for testing FSBP and CIS",
|
5049
|
+
# id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
5050
|
+
# name: "TestConfigurationPolicy",
|
5051
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
5052
|
+
# }
|
5053
|
+
#
|
5054
|
+
# @example Request syntax with placeholder values
|
5055
|
+
#
|
5056
|
+
# resp = client.get_configuration_policy({
|
5057
|
+
# identifier: "NonEmptyString", # required
|
5058
|
+
# })
|
5059
|
+
#
|
5060
|
+
# @example Response structure
|
5061
|
+
#
|
5062
|
+
# resp.arn #=> String
|
5063
|
+
# resp.id #=> String
|
5064
|
+
# resp.name #=> String
|
5065
|
+
# resp.description #=> String
|
5066
|
+
# resp.updated_at #=> Time
|
5067
|
+
# resp.created_at #=> Time
|
5068
|
+
# resp.configuration_policy.security_hub.service_enabled #=> Boolean
|
5069
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers #=> Array
|
5070
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers[0] #=> String
|
5071
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers #=> Array
|
5072
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers[0] #=> String
|
5073
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers #=> Array
|
5074
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers[0] #=> String
|
5075
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters #=> Array
|
5076
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].security_control_id #=> String
|
5077
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters #=> Hash
|
5078
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value_type #=> String, one of "DEFAULT", "CUSTOM"
|
5079
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer #=> Integer
|
5080
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list #=> Array
|
5081
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list[0] #=> Integer
|
5082
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.double #=> Float
|
5083
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string #=> String
|
5084
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list #=> Array
|
5085
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list[0] #=> String
|
5086
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.boolean #=> Boolean
|
5087
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum #=> String
|
5088
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list #=> Array
|
5089
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list[0] #=> String
|
5090
|
+
#
|
5091
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetConfigurationPolicy AWS API Documentation
|
5092
|
+
#
|
5093
|
+
# @overload get_configuration_policy(params = {})
|
5094
|
+
# @param [Hash] params ({})
|
5095
|
+
def get_configuration_policy(params = {}, options = {})
|
5096
|
+
req = build_request(:get_configuration_policy, params)
|
5097
|
+
req.send_request(options)
|
5098
|
+
end
|
5099
|
+
|
5100
|
+
# Returns the association between a configuration and a target account,
|
5101
|
+
# organizational unit, or the root. The configuration can be a
|
5102
|
+
# configuration policy or self-managed behavior. Only the Security Hub
|
5103
|
+
# delegated administrator can invoke this operation from the home
|
5104
|
+
# Region.
|
5105
|
+
#
|
5106
|
+
# @option params [required, Types::Target] :target
|
5107
|
+
# The target account ID, organizational unit ID, or the root ID to
|
5108
|
+
# retrieve the association for.
|
5109
|
+
#
|
5110
|
+
# @return [Types::GetConfigurationPolicyAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5111
|
+
#
|
5112
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#configuration_policy_id #configuration_policy_id} => String
|
5113
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#target_id #target_id} => String
|
5114
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#target_type #target_type} => String
|
5115
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#association_type #association_type} => String
|
5116
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#updated_at #updated_at} => Time
|
5117
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#association_status #association_status} => String
|
5118
|
+
# * {Types::GetConfigurationPolicyAssociationResponse#association_status_message #association_status_message} => String
|
5119
|
+
#
|
5120
|
+
#
|
5121
|
+
# @example Example: To get details about a configuration association
|
5122
|
+
#
|
5123
|
+
# # This operation provides details about configuration associations for a specific target account, organizational unit, or
|
5124
|
+
# # the root.
|
5125
|
+
#
|
5126
|
+
# resp = client.get_configuration_policy_association({
|
5127
|
+
# target: {
|
5128
|
+
# account_id: "111122223333",
|
5129
|
+
# },
|
5130
|
+
# })
|
5131
|
+
#
|
5132
|
+
# resp.to_h outputs the following:
|
5133
|
+
# {
|
5134
|
+
# association_status: "FAILED",
|
5135
|
+
# association_status_message: "Configuration Policy a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 couldn\u2019t be applied to account 111122223333 in us-east-1 Region. Retry your request.",
|
5136
|
+
# association_type: "INHERITED",
|
5137
|
+
# configuration_policy_id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
5138
|
+
# target_id: "111122223333",
|
5139
|
+
# target_type: "ACCOUNT",
|
5140
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
5141
|
+
# }
|
5142
|
+
#
|
5143
|
+
# @example Request syntax with placeholder values
|
5144
|
+
#
|
5145
|
+
# resp = client.get_configuration_policy_association({
|
5146
|
+
# target: { # required
|
5147
|
+
# account_id: "NonEmptyString",
|
5148
|
+
# organizational_unit_id: "NonEmptyString",
|
5149
|
+
# root_id: "NonEmptyString",
|
5150
|
+
# },
|
5151
|
+
# })
|
5152
|
+
#
|
5153
|
+
# @example Response structure
|
5154
|
+
#
|
5155
|
+
# resp.configuration_policy_id #=> String
|
5156
|
+
# resp.target_id #=> String
|
5157
|
+
# resp.target_type #=> String, one of "ACCOUNT", "ORGANIZATIONAL_UNIT"
|
5158
|
+
# resp.association_type #=> String, one of "INHERITED", "APPLIED"
|
5159
|
+
# resp.updated_at #=> Time
|
5160
|
+
# resp.association_status #=> String, one of "PENDING", "SUCCESS", "FAILED"
|
5161
|
+
# resp.association_status_message #=> String
|
5162
|
+
#
|
5163
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetConfigurationPolicyAssociation AWS API Documentation
|
5164
|
+
#
|
5165
|
+
# @overload get_configuration_policy_association(params = {})
|
5166
|
+
# @param [Hash] params ({})
|
5167
|
+
def get_configuration_policy_association(params = {}, options = {})
|
5168
|
+
req = build_request(:get_configuration_policy_association, params)
|
5169
|
+
req.send_request(options)
|
5170
|
+
end
|
5171
|
+
|
4586
5172
|
# Returns a list of the standards that are currently enabled.
|
4587
5173
|
#
|
4588
5174
|
# @option params [Array<String>] :standards_subscription_arns
|
@@ -5695,6 +6281,24 @@ module Aws::SecurityHub
|
|
5695
6281
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
5696
6282
|
# },
|
5697
6283
|
# ],
|
6284
|
+
# aws_account_name: [
|
6285
|
+
# {
|
6286
|
+
# value: "NonEmptyString",
|
6287
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
6288
|
+
# },
|
6289
|
+
# ],
|
6290
|
+
# resource_application_name: [
|
6291
|
+
# {
|
6292
|
+
# value: "NonEmptyString",
|
6293
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
6294
|
+
# },
|
6295
|
+
# ],
|
6296
|
+
# resource_application_arn: [
|
6297
|
+
# {
|
6298
|
+
# value: "NonEmptyString",
|
6299
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
6300
|
+
# },
|
6301
|
+
# ],
|
5698
6302
|
# },
|
5699
6303
|
# sort_criteria: [
|
5700
6304
|
# {
|
@@ -6200,6 +6804,15 @@ module Aws::SecurityHub
|
|
6200
6804
|
# resp.insights[0].filters.compliance_security_control_parameters_value #=> Array
|
6201
6805
|
# resp.insights[0].filters.compliance_security_control_parameters_value[0].value #=> String
|
6202
6806
|
# resp.insights[0].filters.compliance_security_control_parameters_value[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
6807
|
+
# resp.insights[0].filters.aws_account_name #=> Array
|
6808
|
+
# resp.insights[0].filters.aws_account_name[0].value #=> String
|
6809
|
+
# resp.insights[0].filters.aws_account_name[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
6810
|
+
# resp.insights[0].filters.resource_application_name #=> Array
|
6811
|
+
# resp.insights[0].filters.resource_application_name[0].value #=> String
|
6812
|
+
# resp.insights[0].filters.resource_application_name[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
6813
|
+
# resp.insights[0].filters.resource_application_arn #=> Array
|
6814
|
+
# resp.insights[0].filters.resource_application_arn[0].value #=> String
|
6815
|
+
# resp.insights[0].filters.resource_application_arn[0].comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
6203
6816
|
# resp.insights[0].group_by_attribute #=> String
|
6204
6817
|
# resp.next_token #=> String
|
6205
6818
|
#
|
@@ -6617,6 +7230,185 @@ module Aws::SecurityHub
|
|
6617
7230
|
req.send_request(options)
|
6618
7231
|
end
|
6619
7232
|
|
7233
|
+
# Lists the configuration policies that the Security Hub delegated
|
7234
|
+
# administrator has created for your organization. Only the delegated
|
7235
|
+
# administrator can invoke this operation from the home Region.
|
7236
|
+
#
|
7237
|
+
# @option params [String] :next_token
|
7238
|
+
# The NextToken value that's returned from a previous paginated
|
7239
|
+
# `ListConfigurationPolicies` request where `MaxResults` was used but
|
7240
|
+
# the results exceeded the value of that parameter. Pagination continues
|
7241
|
+
# from the `MaxResults` was used but the results exceeded the value of
|
7242
|
+
# that parameter. Pagination continues from the end of the previous
|
7243
|
+
# response that returned the `NextToken` value. This value is `null`
|
7244
|
+
# when there are no more results to return.
|
7245
|
+
#
|
7246
|
+
# @option params [Integer] :max_results
|
7247
|
+
# The maximum number of results that's returned by
|
7248
|
+
# `ListConfigurationPolicies` in each page of the response. When this
|
7249
|
+
# parameter is used, `ListConfigurationPolicies` returns the specified
|
7250
|
+
# number of results in a single page and a `NextToken` response element.
|
7251
|
+
# You can see the remaining results of the initial request by sending
|
7252
|
+
# another `ListConfigurationPolicies` request with the returned
|
7253
|
+
# `NextToken` value. A valid range for `MaxResults` is between 1 and
|
7254
|
+
# 100.
|
7255
|
+
#
|
7256
|
+
# @return [Types::ListConfigurationPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
7257
|
+
#
|
7258
|
+
# * {Types::ListConfigurationPoliciesResponse#configuration_policy_summaries #configuration_policy_summaries} => Array<Types::ConfigurationPolicySummary>
|
7259
|
+
# * {Types::ListConfigurationPoliciesResponse#next_token #next_token} => String
|
7260
|
+
#
|
7261
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7262
|
+
#
|
7263
|
+
#
|
7264
|
+
# @example Example: To view a list of configuration policies
|
7265
|
+
#
|
7266
|
+
# # This operation provides a list of your configuration policies, including metadata for each policy.
|
7267
|
+
#
|
7268
|
+
# resp = client.list_configuration_policies({
|
7269
|
+
# max_results: 1,
|
7270
|
+
# next_token: "U1FsdGVkX19nBV2zoh+Gou9NgnulLJHWpn9xnG4hqSOhvw3o2JqjI86QDxdf",
|
7271
|
+
# })
|
7272
|
+
#
|
7273
|
+
# resp.to_h outputs the following:
|
7274
|
+
# {
|
7275
|
+
# configuration_policy_summaries: [
|
7276
|
+
# {
|
7277
|
+
# arn: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
7278
|
+
# description: "Configuration policy for testing FSBP and CIS",
|
7279
|
+
# id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
7280
|
+
# name: "TestConfigurationPolicy",
|
7281
|
+
# service_enabled: true,
|
7282
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
7283
|
+
# },
|
7284
|
+
# ],
|
7285
|
+
# next_token: "U1FsdGVkX19nBV2zoh+Gou9NgnulLJHWpn9xnG4hqSOfvw3o2JqjI86QDxef",
|
7286
|
+
# }
|
7287
|
+
#
|
7288
|
+
# @example Request syntax with placeholder values
|
7289
|
+
#
|
7290
|
+
# resp = client.list_configuration_policies({
|
7291
|
+
# next_token: "NextToken",
|
7292
|
+
# max_results: 1,
|
7293
|
+
# })
|
7294
|
+
#
|
7295
|
+
# @example Response structure
|
7296
|
+
#
|
7297
|
+
# resp.configuration_policy_summaries #=> Array
|
7298
|
+
# resp.configuration_policy_summaries[0].arn #=> String
|
7299
|
+
# resp.configuration_policy_summaries[0].id #=> String
|
7300
|
+
# resp.configuration_policy_summaries[0].name #=> String
|
7301
|
+
# resp.configuration_policy_summaries[0].description #=> String
|
7302
|
+
# resp.configuration_policy_summaries[0].updated_at #=> Time
|
7303
|
+
# resp.configuration_policy_summaries[0].service_enabled #=> Boolean
|
7304
|
+
# resp.next_token #=> String
|
7305
|
+
#
|
7306
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListConfigurationPolicies AWS API Documentation
|
7307
|
+
#
|
7308
|
+
# @overload list_configuration_policies(params = {})
|
7309
|
+
# @param [Hash] params ({})
|
7310
|
+
def list_configuration_policies(params = {}, options = {})
|
7311
|
+
req = build_request(:list_configuration_policies, params)
|
7312
|
+
req.send_request(options)
|
7313
|
+
end
|
7314
|
+
|
7315
|
+
# Provides information about the associations for your configuration
|
7316
|
+
# policies and self-managed behavior. Only the Security Hub delegated
|
7317
|
+
# administrator can invoke this operation from the home Region.
|
7318
|
+
#
|
7319
|
+
# @option params [String] :next_token
|
7320
|
+
# The `NextToken` value that's returned from a previous paginated
|
7321
|
+
# `ListConfigurationPolicyAssociations` request where `MaxResults` was
|
7322
|
+
# used but the results exceeded the value of that parameter. Pagination
|
7323
|
+
# continues from the end of the previous response that returned the
|
7324
|
+
# `NextToken` value. This value is `null` when there are no more results
|
7325
|
+
# to return.
|
7326
|
+
#
|
7327
|
+
# @option params [Integer] :max_results
|
7328
|
+
# The maximum number of results that's returned by
|
7329
|
+
# `ListConfigurationPolicies` in each page of the response. When this
|
7330
|
+
# parameter is used, `ListConfigurationPolicyAssociations` returns the
|
7331
|
+
# specified number of results in a single page and a `NextToken`
|
7332
|
+
# response element. You can see the remaining results of the initial
|
7333
|
+
# request by sending another `ListConfigurationPolicyAssociations`
|
7334
|
+
# request with the returned `NextToken` value. A valid range for
|
7335
|
+
# `MaxResults` is between 1 and 100.
|
7336
|
+
#
|
7337
|
+
# @option params [Types::AssociationFilters] :filters
|
7338
|
+
# Options for filtering the `ListConfigurationPolicyAssociations`
|
7339
|
+
# response. You can filter by the Amazon Resource Name (ARN) or
|
7340
|
+
# universally unique identifier (UUID) of a configuration,
|
7341
|
+
# `AssociationType`, or `AssociationStatus`.
|
7342
|
+
#
|
7343
|
+
# @return [Types::ListConfigurationPolicyAssociationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
7344
|
+
#
|
7345
|
+
# * {Types::ListConfigurationPolicyAssociationsResponse#configuration_policy_association_summaries #configuration_policy_association_summaries} => Array<Types::ConfigurationPolicyAssociationSummary>
|
7346
|
+
# * {Types::ListConfigurationPolicyAssociationsResponse#next_token #next_token} => String
|
7347
|
+
#
|
7348
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7349
|
+
#
|
7350
|
+
#
|
7351
|
+
# @example Example: To list configuration associations
|
7352
|
+
#
|
7353
|
+
# # This operation lists all of the associations between targets and configuration policies or self-managed behavior.
|
7354
|
+
# # Targets can include accounts, organizational units, or the root.
|
7355
|
+
#
|
7356
|
+
# resp = client.list_configuration_policy_associations({
|
7357
|
+
# filters: {
|
7358
|
+
# association_type: "APPLIED",
|
7359
|
+
# },
|
7360
|
+
# max_results: 1,
|
7361
|
+
# next_token: "U1FsdGVkX19nBV2zoh+Gou9NgnulLJHWpn9xnG4hqSOhvw3o2JqjI86QDxdf",
|
7362
|
+
# })
|
7363
|
+
#
|
7364
|
+
# resp.to_h outputs the following:
|
7365
|
+
# {
|
7366
|
+
# configuration_policy_association_summaries: [
|
7367
|
+
# {
|
7368
|
+
# association_status: "PENDING",
|
7369
|
+
# association_type: "APPLIED",
|
7370
|
+
# configuration_policy_id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
7371
|
+
# target_id: "123456789012",
|
7372
|
+
# target_type: "ACCOUNT",
|
7373
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
7374
|
+
# },
|
7375
|
+
# ],
|
7376
|
+
# next_token: "U1FsdGVkX19nBV2zoh+Gou9NgnulLJHWpn9xnG4hqSOfvw3o2JqjI86QDxef",
|
7377
|
+
# }
|
7378
|
+
#
|
7379
|
+
# @example Request syntax with placeholder values
|
7380
|
+
#
|
7381
|
+
# resp = client.list_configuration_policy_associations({
|
7382
|
+
# next_token: "NextToken",
|
7383
|
+
# max_results: 1,
|
7384
|
+
# filters: {
|
7385
|
+
# configuration_policy_id: "NonEmptyString",
|
7386
|
+
# association_type: "INHERITED", # accepts INHERITED, APPLIED
|
7387
|
+
# association_status: "PENDING", # accepts PENDING, SUCCESS, FAILED
|
7388
|
+
# },
|
7389
|
+
# })
|
7390
|
+
#
|
7391
|
+
# @example Response structure
|
7392
|
+
#
|
7393
|
+
# resp.configuration_policy_association_summaries #=> Array
|
7394
|
+
# resp.configuration_policy_association_summaries[0].configuration_policy_id #=> String
|
7395
|
+
# resp.configuration_policy_association_summaries[0].target_id #=> String
|
7396
|
+
# resp.configuration_policy_association_summaries[0].target_type #=> String, one of "ACCOUNT", "ORGANIZATIONAL_UNIT"
|
7397
|
+
# resp.configuration_policy_association_summaries[0].association_type #=> String, one of "INHERITED", "APPLIED"
|
7398
|
+
# resp.configuration_policy_association_summaries[0].updated_at #=> Time
|
7399
|
+
# resp.configuration_policy_association_summaries[0].association_status #=> String, one of "PENDING", "SUCCESS", "FAILED"
|
7400
|
+
# resp.configuration_policy_association_summaries[0].association_status_message #=> String
|
7401
|
+
# resp.next_token #=> String
|
7402
|
+
#
|
7403
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/ListConfigurationPolicyAssociations AWS API Documentation
|
7404
|
+
#
|
7405
|
+
# @overload list_configuration_policy_associations(params = {})
|
7406
|
+
# @param [Hash] params ({})
|
7407
|
+
def list_configuration_policy_associations(params = {}, options = {})
|
7408
|
+
req = build_request(:list_configuration_policy_associations, params)
|
7409
|
+
req.send_request(options)
|
7410
|
+
end
|
7411
|
+
|
6620
7412
|
# Lists all findings-generating solutions (products) that you are
|
6621
7413
|
# subscribed to receive findings from in Security Hub.
|
6622
7414
|
#
|
@@ -7251,6 +8043,136 @@ module Aws::SecurityHub
|
|
7251
8043
|
req.send_request(options)
|
7252
8044
|
end
|
7253
8045
|
|
8046
|
+
# Associates a target account, organizational unit, or the root with a
|
8047
|
+
# specified configuration. The target can be associated with a
|
8048
|
+
# configuration policy or self-managed behavior. Only the Security Hub
|
8049
|
+
# delegated administrator can invoke this operation from the home
|
8050
|
+
# Region.
|
8051
|
+
#
|
8052
|
+
# @option params [required, String] :configuration_policy_identifier
|
8053
|
+
# The Amazon Resource Name (ARN) or universally unique identifier (UUID)
|
8054
|
+
# of the configuration policy.
|
8055
|
+
#
|
8056
|
+
# @option params [required, Types::Target] :target
|
8057
|
+
# The identifier of the target account, organizational unit, or the root
|
8058
|
+
# to associate with the specified configuration.
|
8059
|
+
#
|
8060
|
+
# @return [Types::StartConfigurationPolicyAssociationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8061
|
+
#
|
8062
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#configuration_policy_id #configuration_policy_id} => String
|
8063
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#target_id #target_id} => String
|
8064
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#target_type #target_type} => String
|
8065
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#association_type #association_type} => String
|
8066
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#updated_at #updated_at} => Time
|
8067
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#association_status #association_status} => String
|
8068
|
+
# * {Types::StartConfigurationPolicyAssociationResponse#association_status_message #association_status_message} => String
|
8069
|
+
#
|
8070
|
+
#
|
8071
|
+
# @example Example: To associate a configuration with a target
|
8072
|
+
#
|
8073
|
+
# # This operation associates a configuration policy or self-managed behavior with the target account, organizational unit,
|
8074
|
+
# # or the root.
|
8075
|
+
#
|
8076
|
+
# resp = client.start_configuration_policy_association({
|
8077
|
+
# configuration_policy_identifier: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
8078
|
+
# target: {
|
8079
|
+
# account_id: "111122223333",
|
8080
|
+
# },
|
8081
|
+
# })
|
8082
|
+
#
|
8083
|
+
# resp.to_h outputs the following:
|
8084
|
+
# {
|
8085
|
+
# association_status: "SUCCESS",
|
8086
|
+
# association_status_message: "This field is populated only if the association fails",
|
8087
|
+
# association_type: "APPLIED",
|
8088
|
+
# configuration_policy_id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
8089
|
+
# target_id: "111122223333",
|
8090
|
+
# target_type: "ACCOUNT",
|
8091
|
+
# updated_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
8092
|
+
# }
|
8093
|
+
#
|
8094
|
+
# @example Request syntax with placeholder values
|
8095
|
+
#
|
8096
|
+
# resp = client.start_configuration_policy_association({
|
8097
|
+
# configuration_policy_identifier: "NonEmptyString", # required
|
8098
|
+
# target: { # required
|
8099
|
+
# account_id: "NonEmptyString",
|
8100
|
+
# organizational_unit_id: "NonEmptyString",
|
8101
|
+
# root_id: "NonEmptyString",
|
8102
|
+
# },
|
8103
|
+
# })
|
8104
|
+
#
|
8105
|
+
# @example Response structure
|
8106
|
+
#
|
8107
|
+
# resp.configuration_policy_id #=> String
|
8108
|
+
# resp.target_id #=> String
|
8109
|
+
# resp.target_type #=> String, one of "ACCOUNT", "ORGANIZATIONAL_UNIT"
|
8110
|
+
# resp.association_type #=> String, one of "INHERITED", "APPLIED"
|
8111
|
+
# resp.updated_at #=> Time
|
8112
|
+
# resp.association_status #=> String, one of "PENDING", "SUCCESS", "FAILED"
|
8113
|
+
# resp.association_status_message #=> String
|
8114
|
+
#
|
8115
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/StartConfigurationPolicyAssociation AWS API Documentation
|
8116
|
+
#
|
8117
|
+
# @overload start_configuration_policy_association(params = {})
|
8118
|
+
# @param [Hash] params ({})
|
8119
|
+
def start_configuration_policy_association(params = {}, options = {})
|
8120
|
+
req = build_request(:start_configuration_policy_association, params)
|
8121
|
+
req.send_request(options)
|
8122
|
+
end
|
8123
|
+
|
8124
|
+
# Disassociates a target account, organizational unit, or the root from
|
8125
|
+
# a specified configuration. When you disassociate a configuration from
|
8126
|
+
# its target, the target inherits the configuration of the closest
|
8127
|
+
# parent. If there’s no configuration to inherit, the target retains its
|
8128
|
+
# settings but becomes a self-managed account. A target can be
|
8129
|
+
# disassociated from a configuration policy or self-managed behavior.
|
8130
|
+
# Only the Security Hub delegated administrator can invoke this
|
8131
|
+
# operation from the home Region.
|
8132
|
+
#
|
8133
|
+
# @option params [Types::Target] :target
|
8134
|
+
# The identifier of the target account, organizational unit, or the root
|
8135
|
+
# to disassociate from the specified configuration.
|
8136
|
+
#
|
8137
|
+
# @option params [required, String] :configuration_policy_identifier
|
8138
|
+
# The Amazon Resource Name (ARN) or universally unique identifier (UUID)
|
8139
|
+
# of the configuration policy.
|
8140
|
+
#
|
8141
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
8142
|
+
#
|
8143
|
+
#
|
8144
|
+
# @example Example: To disassociate a configuration from a target
|
8145
|
+
#
|
8146
|
+
# # This operation disassociates a configuration policy or self-managed behavior from the target account, organizational
|
8147
|
+
# # unit, or the root.
|
8148
|
+
#
|
8149
|
+
# resp = client.start_configuration_policy_disassociation({
|
8150
|
+
# configuration_policy_identifier: "SELF_MANAGED_SECURITY_HUB",
|
8151
|
+
# target: {
|
8152
|
+
# root_id: "r-f6g7h8i9j0example",
|
8153
|
+
# },
|
8154
|
+
# })
|
8155
|
+
#
|
8156
|
+
# @example Request syntax with placeholder values
|
8157
|
+
#
|
8158
|
+
# resp = client.start_configuration_policy_disassociation({
|
8159
|
+
# target: {
|
8160
|
+
# account_id: "NonEmptyString",
|
8161
|
+
# organizational_unit_id: "NonEmptyString",
|
8162
|
+
# root_id: "NonEmptyString",
|
8163
|
+
# },
|
8164
|
+
# configuration_policy_identifier: "NonEmptyString", # required
|
8165
|
+
# })
|
8166
|
+
#
|
8167
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/StartConfigurationPolicyDisassociation AWS API Documentation
|
8168
|
+
#
|
8169
|
+
# @overload start_configuration_policy_disassociation(params = {})
|
8170
|
+
# @param [Hash] params ({})
|
8171
|
+
def start_configuration_policy_disassociation(params = {}, options = {})
|
8172
|
+
req = build_request(:start_configuration_policy_disassociation, params)
|
8173
|
+
req.send_request(options)
|
8174
|
+
end
|
8175
|
+
|
7254
8176
|
# Adds one or more tags to a resource.
|
7255
8177
|
#
|
7256
8178
|
# @option params [required, String] :resource_arn
|
@@ -7376,6 +8298,205 @@ module Aws::SecurityHub
|
|
7376
8298
|
req.send_request(options)
|
7377
8299
|
end
|
7378
8300
|
|
8301
|
+
# Updates a configuration policy. Only the Security Hub delegated
|
8302
|
+
# administrator can invoke this operation from the home Region.
|
8303
|
+
#
|
8304
|
+
# @option params [required, String] :identifier
|
8305
|
+
# The Amazon Resource Name (ARN) or universally unique identifier (UUID)
|
8306
|
+
# of the configuration policy.
|
8307
|
+
#
|
8308
|
+
# @option params [String] :name
|
8309
|
+
# The name of the configuration policy.
|
8310
|
+
#
|
8311
|
+
# @option params [String] :description
|
8312
|
+
# The description of the configuration policy.
|
8313
|
+
#
|
8314
|
+
# @option params [String] :updated_reason
|
8315
|
+
# The reason for updating the configuration policy.
|
8316
|
+
#
|
8317
|
+
# @option params [Types::Policy] :configuration_policy
|
8318
|
+
# An object that defines how Security Hub is configured. It includes
|
8319
|
+
# whether Security Hub is enabled or disabled, a list of enabled
|
8320
|
+
# security standards, a list of enabled or disabled security controls,
|
8321
|
+
# and a list of custom parameter values for specified controls. If you
|
8322
|
+
# provide a list of security controls that are enabled in the
|
8323
|
+
# configuration policy, Security Hub disables all other controls
|
8324
|
+
# (including newly released controls). If you provide a list of security
|
8325
|
+
# controls that are disabled in the configuration policy, Security Hub
|
8326
|
+
# enables all other controls (including newly released controls).
|
8327
|
+
#
|
8328
|
+
# When updating a configuration policy, provide a complete list of
|
8329
|
+
# standards that you want to enable and a complete list of controls that
|
8330
|
+
# you want to enable or disable. The updated configuration replaces the
|
8331
|
+
# current configuration.
|
8332
|
+
#
|
8333
|
+
# @return [Types::UpdateConfigurationPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8334
|
+
#
|
8335
|
+
# * {Types::UpdateConfigurationPolicyResponse#arn #arn} => String
|
8336
|
+
# * {Types::UpdateConfigurationPolicyResponse#id #id} => String
|
8337
|
+
# * {Types::UpdateConfigurationPolicyResponse#name #name} => String
|
8338
|
+
# * {Types::UpdateConfigurationPolicyResponse#description #description} => String
|
8339
|
+
# * {Types::UpdateConfigurationPolicyResponse#updated_at #updated_at} => Time
|
8340
|
+
# * {Types::UpdateConfigurationPolicyResponse#created_at #created_at} => Time
|
8341
|
+
# * {Types::UpdateConfigurationPolicyResponse#configuration_policy #configuration_policy} => Types::Policy
|
8342
|
+
#
|
8343
|
+
#
|
8344
|
+
# @example Example: To update a configuration policy
|
8345
|
+
#
|
8346
|
+
# # This operation updates the specified configuration policy.
|
8347
|
+
#
|
8348
|
+
# resp = client.update_configuration_policy({
|
8349
|
+
# configuration_policy: {
|
8350
|
+
# security_hub: {
|
8351
|
+
# enabled_standard_identifiers: [
|
8352
|
+
# "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
|
8353
|
+
# "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
|
8354
|
+
# ],
|
8355
|
+
# security_controls_configuration: {
|
8356
|
+
# disabled_security_control_identifiers: [
|
8357
|
+
# "CloudWatch.1",
|
8358
|
+
# "CloudWatch.2",
|
8359
|
+
# ],
|
8360
|
+
# security_control_custom_parameters: [
|
8361
|
+
# {
|
8362
|
+
# parameters: {
|
8363
|
+
# "daysToExpiration" => {
|
8364
|
+
# value: {
|
8365
|
+
# integer: 21,
|
8366
|
+
# },
|
8367
|
+
# value_type: "CUSTOM",
|
8368
|
+
# },
|
8369
|
+
# },
|
8370
|
+
# security_control_id: "ACM.1",
|
8371
|
+
# },
|
8372
|
+
# ],
|
8373
|
+
# },
|
8374
|
+
# service_enabled: true,
|
8375
|
+
# },
|
8376
|
+
# },
|
8377
|
+
# description: "Updated configuration policy for testing FSBP and CIS",
|
8378
|
+
# identifier: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
8379
|
+
# name: "TestConfigurationPolicy",
|
8380
|
+
# updated_reason: "Enabling ACM.2",
|
8381
|
+
# })
|
8382
|
+
#
|
8383
|
+
# resp.to_h outputs the following:
|
8384
|
+
# {
|
8385
|
+
# arn: "arn:aws:securityhub:us-east-1:123456789012:configuration-policy/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
8386
|
+
# configuration_policy: {
|
8387
|
+
# security_hub: {
|
8388
|
+
# enabled_standard_identifiers: [
|
8389
|
+
# "arn:aws:securityhub:us-east-1::standards/aws-foundational-security-best-practices/v/1.0.0",
|
8390
|
+
# "arn:aws:securityhub:::ruleset/cis-aws-foundations-benchmark/v/1.2.0",
|
8391
|
+
# ],
|
8392
|
+
# security_controls_configuration: {
|
8393
|
+
# disabled_security_control_identifiers: [
|
8394
|
+
# "CloudWatch.1",
|
8395
|
+
# "CloudWatch.2",
|
8396
|
+
# ],
|
8397
|
+
# security_control_custom_parameters: [
|
8398
|
+
# {
|
8399
|
+
# parameters: {
|
8400
|
+
# "daysToExpiration" => {
|
8401
|
+
# value: {
|
8402
|
+
# integer: 21,
|
8403
|
+
# },
|
8404
|
+
# value_type: "CUSTOM",
|
8405
|
+
# },
|
8406
|
+
# },
|
8407
|
+
# security_control_id: "ACM.1",
|
8408
|
+
# },
|
8409
|
+
# ],
|
8410
|
+
# },
|
8411
|
+
# service_enabled: true,
|
8412
|
+
# },
|
8413
|
+
# },
|
8414
|
+
# created_at: Time.parse("2023-01-11T06:17:17.154Z"),
|
8415
|
+
# description: "Updated configuration policy for testing FSBP and CIS",
|
8416
|
+
# id: "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
|
8417
|
+
# name: "TestConfigurationPolicy",
|
8418
|
+
# updated_at: Time.parse("2023-01-12T06:17:17.154Z"),
|
8419
|
+
# }
|
8420
|
+
#
|
8421
|
+
# @example Request syntax with placeholder values
|
8422
|
+
#
|
8423
|
+
# resp = client.update_configuration_policy({
|
8424
|
+
# identifier: "NonEmptyString", # required
|
8425
|
+
# name: "NonEmptyString",
|
8426
|
+
# description: "NonEmptyString",
|
8427
|
+
# updated_reason: "NonEmptyString",
|
8428
|
+
# configuration_policy: {
|
8429
|
+
# security_hub: {
|
8430
|
+
# service_enabled: false,
|
8431
|
+
# enabled_standard_identifiers: ["NonEmptyString"],
|
8432
|
+
# security_controls_configuration: {
|
8433
|
+
# enabled_security_control_identifiers: ["NonEmptyString"],
|
8434
|
+
# disabled_security_control_identifiers: ["NonEmptyString"],
|
8435
|
+
# security_control_custom_parameters: [
|
8436
|
+
# {
|
8437
|
+
# security_control_id: "NonEmptyString",
|
8438
|
+
# parameters: {
|
8439
|
+
# "NonEmptyString" => {
|
8440
|
+
# value_type: "DEFAULT", # required, accepts DEFAULT, CUSTOM
|
8441
|
+
# value: {
|
8442
|
+
# integer: 1,
|
8443
|
+
# integer_list: [1],
|
8444
|
+
# double: 1.0,
|
8445
|
+
# string: "NonEmptyString",
|
8446
|
+
# string_list: ["NonEmptyString"],
|
8447
|
+
# boolean: false,
|
8448
|
+
# enum: "NonEmptyString",
|
8449
|
+
# enum_list: ["NonEmptyString"],
|
8450
|
+
# },
|
8451
|
+
# },
|
8452
|
+
# },
|
8453
|
+
# },
|
8454
|
+
# ],
|
8455
|
+
# },
|
8456
|
+
# },
|
8457
|
+
# },
|
8458
|
+
# })
|
8459
|
+
#
|
8460
|
+
# @example Response structure
|
8461
|
+
#
|
8462
|
+
# resp.arn #=> String
|
8463
|
+
# resp.id #=> String
|
8464
|
+
# resp.name #=> String
|
8465
|
+
# resp.description #=> String
|
8466
|
+
# resp.updated_at #=> Time
|
8467
|
+
# resp.created_at #=> Time
|
8468
|
+
# resp.configuration_policy.security_hub.service_enabled #=> Boolean
|
8469
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers #=> Array
|
8470
|
+
# resp.configuration_policy.security_hub.enabled_standard_identifiers[0] #=> String
|
8471
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers #=> Array
|
8472
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.enabled_security_control_identifiers[0] #=> String
|
8473
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers #=> Array
|
8474
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.disabled_security_control_identifiers[0] #=> String
|
8475
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters #=> Array
|
8476
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].security_control_id #=> String
|
8477
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters #=> Hash
|
8478
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value_type #=> String, one of "DEFAULT", "CUSTOM"
|
8479
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer #=> Integer
|
8480
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list #=> Array
|
8481
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.integer_list[0] #=> Integer
|
8482
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.double #=> Float
|
8483
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string #=> String
|
8484
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list #=> Array
|
8485
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.string_list[0] #=> String
|
8486
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.boolean #=> Boolean
|
8487
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum #=> String
|
8488
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list #=> Array
|
8489
|
+
# resp.configuration_policy.security_hub.security_controls_configuration.security_control_custom_parameters[0].parameters["NonEmptyString"].value.enum_list[0] #=> String
|
8490
|
+
#
|
8491
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/UpdateConfigurationPolicy AWS API Documentation
|
8492
|
+
#
|
8493
|
+
# @overload update_configuration_policy(params = {})
|
8494
|
+
# @param [Hash] params ({})
|
8495
|
+
def update_configuration_policy(params = {}, options = {})
|
8496
|
+
req = build_request(:update_configuration_policy, params)
|
8497
|
+
req.send_request(options)
|
8498
|
+
end
|
8499
|
+
|
7379
8500
|
# Updates the finding aggregation configuration. Used to update the
|
7380
8501
|
# Region linking mode and the list of included or excluded Regions. You
|
7381
8502
|
# cannot use `UpdateFindingAggregator` to change the aggregation Region.
|
@@ -8180,6 +9301,24 @@ module Aws::SecurityHub
|
|
8180
9301
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
8181
9302
|
# },
|
8182
9303
|
# ],
|
9304
|
+
# aws_account_name: [
|
9305
|
+
# {
|
9306
|
+
# value: "NonEmptyString",
|
9307
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
9308
|
+
# },
|
9309
|
+
# ],
|
9310
|
+
# resource_application_name: [
|
9311
|
+
# {
|
9312
|
+
# value: "NonEmptyString",
|
9313
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
9314
|
+
# },
|
9315
|
+
# ],
|
9316
|
+
# resource_application_arn: [
|
9317
|
+
# {
|
9318
|
+
# value: "NonEmptyString",
|
9319
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
9320
|
+
# },
|
9321
|
+
# ],
|
8183
9322
|
# },
|
8184
9323
|
# note: {
|
8185
9324
|
# text: "NonEmptyString", # required
|
@@ -8920,6 +10059,24 @@ module Aws::SecurityHub
|
|
8920
10059
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
8921
10060
|
# },
|
8922
10061
|
# ],
|
10062
|
+
# aws_account_name: [
|
10063
|
+
# {
|
10064
|
+
# value: "NonEmptyString",
|
10065
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
10066
|
+
# },
|
10067
|
+
# ],
|
10068
|
+
# resource_application_name: [
|
10069
|
+
# {
|
10070
|
+
# value: "NonEmptyString",
|
10071
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
10072
|
+
# },
|
10073
|
+
# ],
|
10074
|
+
# resource_application_arn: [
|
10075
|
+
# {
|
10076
|
+
# value: "NonEmptyString",
|
10077
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS
|
10078
|
+
# },
|
10079
|
+
# ],
|
8923
10080
|
# },
|
8924
10081
|
# group_by_attribute: "NonEmptyString",
|
8925
10082
|
# })
|
@@ -8933,44 +10090,63 @@ module Aws::SecurityHub
|
|
8933
10090
|
req.send_request(options)
|
8934
10091
|
end
|
8935
10092
|
|
8936
|
-
#
|
8937
|
-
#
|
10093
|
+
# Updates the configuration of your organization in Security Hub. Only
|
10094
|
+
# the Security Hub administrator account can invoke this operation.
|
8938
10095
|
#
|
8939
10096
|
# @option params [required, Boolean] :auto_enable
|
8940
|
-
# Whether to automatically enable Security Hub
|
8941
|
-
# organization.
|
10097
|
+
# Whether to automatically enable Security Hub in new member accounts
|
10098
|
+
# when they join the organization.
|
8942
10099
|
#
|
8943
|
-
#
|
8944
|
-
#
|
10100
|
+
# If set to `true`, then Security Hub is automatically enabled in new
|
10101
|
+
# accounts. If set to `false`, then Security Hub isn't enabled in new
|
10102
|
+
# accounts automatically. The default value is `false`.
|
8945
10103
|
#
|
8946
|
-
#
|
8947
|
-
# `
|
10104
|
+
# If the `ConfigurationType` of your organization is set to `CENTRAL`,
|
10105
|
+
# then this field is set to `false` and can't be changed in the home
|
10106
|
+
# Region and linked Regions. However, in that case, the delegated
|
10107
|
+
# administrator can create a configuration policy in which Security Hub
|
10108
|
+
# is enabled and associate the policy with new organization accounts.
|
8948
10109
|
#
|
8949
10110
|
# @option params [String] :auto_enable_standards
|
8950
|
-
# Whether to automatically enable Security Hub [default standards][1]
|
8951
|
-
#
|
10111
|
+
# Whether to automatically enable Security Hub [default standards][1] in
|
10112
|
+
# new member accounts when they join the organization.
|
8952
10113
|
#
|
8953
|
-
#
|
8954
|
-
#
|
8955
|
-
# standards
|
10114
|
+
# The default value of this parameter is equal to `DEFAULT`.
|
10115
|
+
#
|
10116
|
+
# If equal to `DEFAULT`, then Security Hub default standards are
|
10117
|
+
# automatically enabled for new member accounts. If equal to `NONE`,
|
10118
|
+
# then default standards are not automatically enabled for new member
|
10119
|
+
# accounts.
|
8956
10120
|
#
|
8957
|
-
#
|
8958
|
-
# this
|
10121
|
+
# If the `ConfigurationType` of your organization is set to `CENTRAL`,
|
10122
|
+
# then this field is set to `NONE` and can't be changed in the home
|
10123
|
+
# Region and linked Regions. However, in that case, the delegated
|
10124
|
+
# administrator can create a configuration policy in which specific
|
10125
|
+
# security standards are enabled and associate the policy with new
|
10126
|
+
# organization accounts.
|
8959
10127
|
#
|
8960
10128
|
#
|
8961
10129
|
#
|
8962
10130
|
# [1]: https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-standards-enable-disable.html
|
8963
10131
|
#
|
10132
|
+
# @option params [Types::OrganizationConfiguration] :organization_configuration
|
10133
|
+
# Provides information about the way an organization is configured in
|
10134
|
+
# Security Hub.
|
10135
|
+
#
|
8964
10136
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
8965
10137
|
#
|
8966
10138
|
#
|
8967
10139
|
# @example Example: To update organization configuration
|
8968
10140
|
#
|
8969
|
-
# #
|
8970
|
-
# #
|
10141
|
+
# # This operation updates the way your organization is configured in Security Hub. Only a Security Hub administrator
|
10142
|
+
# # account can invoke this operation.
|
8971
10143
|
#
|
8972
10144
|
# resp = client.update_organization_configuration({
|
8973
|
-
# auto_enable:
|
10145
|
+
# auto_enable: false,
|
10146
|
+
# auto_enable_standards: "NONE",
|
10147
|
+
# organization_configuration: {
|
10148
|
+
# configuration_type: "CENTRAL",
|
10149
|
+
# },
|
8974
10150
|
# })
|
8975
10151
|
#
|
8976
10152
|
# @example Request syntax with placeholder values
|
@@ -8978,6 +10154,11 @@ module Aws::SecurityHub
|
|
8978
10154
|
# resp = client.update_organization_configuration({
|
8979
10155
|
# auto_enable: false, # required
|
8980
10156
|
# auto_enable_standards: "NONE", # accepts NONE, DEFAULT
|
10157
|
+
# organization_configuration: {
|
10158
|
+
# configuration_type: "CENTRAL", # accepts CENTRAL, LOCAL
|
10159
|
+
# status: "PENDING", # accepts PENDING, ENABLED, FAILED
|
10160
|
+
# status_message: "NonEmptyString",
|
10161
|
+
# },
|
8981
10162
|
# })
|
8982
10163
|
#
|
8983
10164
|
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/UpdateOrganizationConfiguration AWS API Documentation
|
@@ -9165,7 +10346,7 @@ module Aws::SecurityHub
|
|
9165
10346
|
params: params,
|
9166
10347
|
config: config)
|
9167
10348
|
context[:gem_name] = 'aws-sdk-securityhub'
|
9168
|
-
context[:gem_version] = '1.
|
10349
|
+
context[:gem_version] = '1.98.0'
|
9169
10350
|
Seahorse::Client::Request.new(handlers, context)
|
9170
10351
|
end
|
9171
10352
|
|