Struct SecurityHubClient

pub struct SecurityHubClient { /* private fields */ }

A client for the AWS SecurityHub API.

Implementations

impl SecurityHubClient

pub fn new(region: Region) -> SecurityHubClient

Creates a client backed by the default tokio event loop.

The client will use the default credentials provider and tls client.

pub fn new_with<P, D>( request_dispatcher: D, credentials_provider: P, region: Region, ) -> SecurityHubClient

where P: ProvideAwsCredentials + Send + Sync + 'static, D: DispatchSignedRequest + Send + Sync + 'static,

pub fn new_with_client(client: Client, region: Region) -> SecurityHubClient

Trait Implementations

impl Clone for SecurityHubClient

fn clone(&self) -> SecurityHubClient

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl SecurityHub for SecurityHubClient

fn accept_invitation<'life0, 'async_trait>( &'life0 self, input: AcceptInvitationRequest, ) -> Pin<Box<dyn Future<Output = Result<AcceptInvitationResponse, RusotoError<AcceptInvitationError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Accepts the invitation to be a member account and be monitored by the Security Hub master account that the invitation was sent from.

When the member account accepts the invitation, permission is granted to the master account to view findings generated in the member account.

fn batch_disable_standards<'life0, 'async_trait>( &'life0 self, input: BatchDisableStandardsRequest, ) -> Pin<Box<dyn Future<Output = Result<BatchDisableStandardsResponse, RusotoError<BatchDisableStandardsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disables the standards specified by the provided StandardsSubscriptionArns.

For more information, see Security Standards section of the AWS Security Hub User Guide.

fn batch_enable_standards<'life0, 'async_trait>( &'life0 self, input: BatchEnableStandardsRequest, ) -> Pin<Box<dyn Future<Output = Result<BatchEnableStandardsResponse, RusotoError<BatchEnableStandardsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Enables the standards specified by the provided StandardsArn. To obtain the ARN for a standard, use the DescribeStandards operation.

For more information, see the Security Standards section of the AWS Security Hub User Guide.

fn batch_import_findings<'life0, 'async_trait>( &'life0 self, input: BatchImportFindingsRequest, ) -> Pin<Box<dyn Future<Output = Result<BatchImportFindingsResponse, RusotoError<BatchImportFindingsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Imports security findings generated from an integrated third-party product into Security Hub. This action is requested by the integrated product to import its findings into Security Hub.

The maximum allowed size for a finding is 240 Kb. An error is returned for any finding larger than 240 Kb.

After a finding is created, BatchImportFindings cannot be used to update the following finding fields and objects, which Security Hub customers use to manage their investigation workflow.

• Confidence

• Criticality

• Note

• RelatedFindings

• Severity

• Types

• UserDefinedFields

• VerificationState

• Workflow

fn batch_update_findings<'life0, 'async_trait>( &'life0 self, input: BatchUpdateFindingsRequest, ) -> Pin<Box<dyn Future<Output = Result<BatchUpdateFindingsResponse, RusotoError<BatchUpdateFindingsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Used by Security Hub customers to update information about their investigation into a finding. Requested by master accounts or member accounts. Master accounts can update findings for their account and their member accounts. Member accounts can update findings for their account.

Updates from BatchUpdateFindings do not affect the value of UpdatedAt for a finding.

Master accounts can use BatchUpdateFindings to update the following finding fields and objects.

• Confidence

• Criticality

• Note

• RelatedFindings

• Severity

• Types

• UserDefinedFields

• VerificationState

• Workflow

Member accounts can only use BatchUpdateFindings to update the Note object.

fn create_action_target<'life0, 'async_trait>( &'life0 self, input: CreateActionTargetRequest, ) -> Pin<Box<dyn Future<Output = Result<CreateActionTargetResponse, RusotoError<CreateActionTargetError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Creates a custom action target in Security Hub.

You can use custom actions on findings and insights in Security Hub to trigger target actions in Amazon CloudWatch Events.

fn create_insight<'life0, 'async_trait>( &'life0 self, input: CreateInsightRequest, ) -> Pin<Box<dyn Future<Output = Result<CreateInsightResponse, RusotoError<CreateInsightError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Creates a custom insight in Security Hub. An insight is a consolidation of findings that relate to a security issue that requires attention or remediation.

To group the related findings in the insight, use the GroupByAttribute.

fn create_members<'life0, 'async_trait>( &'life0 self, input: CreateMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<CreateMembersResponse, RusotoError<CreateMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the master account. To successfully create a member, you must use this action from an account that already has Security Hub enabled. To enable Security Hub, you can use the EnableSecurityHub operation.

After you use CreateMembers to create member account associations in Security Hub, you must use the InviteMembers operation to invite the accounts to enable Security Hub and become member accounts in Security Hub.

If the account owner accepts the invitation, the account becomes a member account in Security Hub. A permissions policy is added that permits the master account to view the findings generated in the member account. When Security Hub is enabled in the invited account, findings start to be sent to both the member and master accounts.

To remove the association between the master and member accounts, use the DisassociateFromMasterAccount or DisassociateMembers operation.

fn decline_invitations<'life0, 'async_trait>( &'life0 self, input: DeclineInvitationsRequest, ) -> Pin<Box<dyn Future<Output = Result<DeclineInvitationsResponse, RusotoError<DeclineInvitationsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Declines invitations to become a member account.

fn delete_action_target<'life0, 'async_trait>( &'life0 self, input: DeleteActionTargetRequest, ) -> Pin<Box<dyn Future<Output = Result<DeleteActionTargetResponse, RusotoError<DeleteActionTargetError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Deletes a custom action target from Security Hub.

Deleting a custom action target does not affect any findings or insights that were already sent to Amazon CloudWatch Events using the custom action.

fn delete_insight<'life0, 'async_trait>( &'life0 self, input: DeleteInsightRequest, ) -> Pin<Box<dyn Future<Output = Result<DeleteInsightResponse, RusotoError<DeleteInsightError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Deletes the insight specified by the InsightArn.

fn delete_invitations<'life0, 'async_trait>( &'life0 self, input: DeleteInvitationsRequest, ) -> Pin<Box<dyn Future<Output = Result<DeleteInvitationsResponse, RusotoError<DeleteInvitationsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Deletes invitations received by the AWS account to become a member account.

fn delete_members<'life0, 'async_trait>( &'life0 self, input: DeleteMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<DeleteMembersResponse, RusotoError<DeleteMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Deletes the specified member accounts from Security Hub.

fn describe_action_targets<'life0, 'async_trait>( &'life0 self, input: DescribeActionTargetsRequest, ) -> Pin<Box<dyn Future<Output = Result<DescribeActionTargetsResponse, RusotoError<DescribeActionTargetsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of the custom action targets in Security Hub in your account.

fn describe_hub<'life0, 'async_trait>( &'life0 self, input: DescribeHubRequest, ) -> Pin<Box<dyn Future<Output = Result<DescribeHubResponse, RusotoError<DescribeHubError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns details about the Hub resource in your account, including the HubArn and the time when you enabled Security Hub.

fn describe_products<'life0, 'async_trait>( &'life0 self, input: DescribeProductsRequest, ) -> Pin<Box<dyn Future<Output = Result<DescribeProductsResponse, RusotoError<DescribeProductsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns information about the available products that you can subscribe to and integrate with Security Hub in order to consolidate findings.

fn describe_standards<'life0, 'async_trait>( &'life0 self, input: DescribeStandardsRequest, ) -> Pin<Box<dyn Future<Output = Result<DescribeStandardsResponse, RusotoError<DescribeStandardsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of the available standards in Security Hub.

For each standard, the results include the standard ARN, the name, and a description.

fn describe_standards_controls<'life0, 'async_trait>( &'life0 self, input: DescribeStandardsControlsRequest, ) -> Pin<Box<dyn Future<Output = Result<DescribeStandardsControlsResponse, RusotoError<DescribeStandardsControlsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of security standards controls.

For each control, the results include information about whether it is currently enabled, the severity, and a link to remediation information.

fn disable_import_findings_for_product<'life0, 'async_trait>( &'life0 self, input: DisableImportFindingsForProductRequest, ) -> Pin<Box<dyn Future<Output = Result<DisableImportFindingsForProductResponse, RusotoError<DisableImportFindingsForProductError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disables the integration of the specified product with Security Hub. After the integration is disabled, findings from that product are no longer sent to Security Hub.

fn disable_security_hub<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<DisableSecurityHubResponse, RusotoError<DisableSecurityHubError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disables Security Hub in your account only in the current Region. To disable Security Hub in all Regions, you must submit one request per Region where you have enabled Security Hub.

When you disable Security Hub for a master account, it doesn't disable Security Hub for any associated member accounts.

When you disable Security Hub, your existing findings and insights and any Security Hub configuration settings are deleted after 90 days and cannot be recovered. Any standards that were enabled are disabled, and your master and member account associations are removed.

If you want to save your existing findings, you must export them before you disable Security Hub.

fn disassociate_from_master_account<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<DisassociateFromMasterAccountResponse, RusotoError<DisassociateFromMasterAccountError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disassociates the current Security Hub member account from the associated master account.

fn disassociate_members<'life0, 'async_trait>( &'life0 self, input: DisassociateMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<DisassociateMembersResponse, RusotoError<DisassociateMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Disassociates the specified member accounts from the associated master account.

fn enable_import_findings_for_product<'life0, 'async_trait>( &'life0 self, input: EnableImportFindingsForProductRequest, ) -> Pin<Box<dyn Future<Output = Result<EnableImportFindingsForProductResponse, RusotoError<EnableImportFindingsForProductError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Enables the integration of a partner product with Security Hub. Integrated products send findings to Security Hub.

When you enable a product integration, a permissions policy that grants permission for the product to send findings to Security Hub is applied.

fn enable_security_hub<'life0, 'async_trait>( &'life0 self, input: EnableSecurityHubRequest, ) -> Pin<Box<dyn Future<Output = Result<EnableSecurityHubResponse, RusotoError<EnableSecurityHubError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Enables Security Hub for your account in the current Region or the Region you specify in the request.

When you enable Security Hub, you grant to Security Hub the permissions necessary to gather findings from other services that are integrated with Security Hub.

When you use the EnableSecurityHub operation to enable Security Hub, you also automatically enable the following standards.

• CIS AWS Foundations

• AWS Foundational Security Best Practices

You do not enable the Payment Card Industry Data Security Standard (PCI DSS) standard.

To not enable the automatically enabled standards, set EnableDefaultStandards to false.

After you enable Security Hub, to enable a standard, use the BatchEnableStandards operation. To disable a standard, use the BatchDisableStandards operation.

To learn more, see Setting Up AWS Security Hub in the AWS Security Hub User Guide.

fn get_enabled_standards<'life0, 'async_trait>( &'life0 self, input: GetEnabledStandardsRequest, ) -> Pin<Box<dyn Future<Output = Result<GetEnabledStandardsResponse, RusotoError<GetEnabledStandardsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of the standards that are currently enabled.

fn get_findings<'life0, 'async_trait>( &'life0 self, input: GetFindingsRequest, ) -> Pin<Box<dyn Future<Output = Result<GetFindingsResponse, RusotoError<GetFindingsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of findings that match the specified criteria.

fn get_insight_results<'life0, 'async_trait>( &'life0 self, input: GetInsightResultsRequest, ) -> Pin<Box<dyn Future<Output = Result<GetInsightResultsResponse, RusotoError<GetInsightResultsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists the results of the Security Hub insight specified by the insight ARN.

fn get_insights<'life0, 'async_trait>( &'life0 self, input: GetInsightsRequest, ) -> Pin<Box<dyn Future<Output = Result<GetInsightsResponse, RusotoError<GetInsightsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists and describes insights for the specified insight ARNs.

fn get_invitations_count<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<GetInvitationsCountResponse, RusotoError<GetInvitationsCountError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the count of all Security Hub membership invitations that were sent to the current member account, not including the currently accepted invitation.

fn get_master_account<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<GetMasterAccountResponse, RusotoError<GetMasterAccountError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Provides the details for the Security Hub master account for the current member account.

fn get_members<'life0, 'async_trait>( &'life0 self, input: GetMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<GetMembersResponse, RusotoError<GetMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns the details for the Security Hub member accounts for the specified account IDs.

fn invite_members<'life0, 'async_trait>( &'life0 self, input: InviteMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<InviteMembersResponse, RusotoError<InviteMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Invites other AWS accounts to become member accounts for the Security Hub master account that the invitation is sent from.

Before you can use this action to invite a member, you must first use the CreateMembers action to create the member account in Security Hub.

When the account owner accepts the invitation to become a member account and enables Security Hub, the master account can view the findings generated from the member account.

fn list_enabled_products_for_import<'life0, 'async_trait>( &'life0 self, input: ListEnabledProductsForImportRequest, ) -> Pin<Box<dyn Future<Output = Result<ListEnabledProductsForImportResponse, RusotoError<ListEnabledProductsForImportError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.

fn list_invitations<'life0, 'async_trait>( &'life0 self, input: ListInvitationsRequest, ) -> Pin<Box<dyn Future<Output = Result<ListInvitationsResponse, RusotoError<ListInvitationsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists all Security Hub membership invitations that were sent to the current AWS account.

fn list_members<'life0, 'async_trait>( &'life0 self, input: ListMembersRequest, ) -> Pin<Box<dyn Future<Output = Result<ListMembersResponse, RusotoError<ListMembersError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Lists details about all member accounts for the current Security Hub master account.

fn list_tags_for_resource<'life0, 'async_trait>( &'life0 self, input: ListTagsForResourceRequest, ) -> Pin<Box<dyn Future<Output = Result<ListTagsForResourceResponse, RusotoError<ListTagsForResourceError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns a list of tags associated with a resource.

fn tag_resource<'life0, 'async_trait>( &'life0 self, input: TagResourceRequest, ) -> Pin<Box<dyn Future<Output = Result<TagResourceResponse, RusotoError<TagResourceError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Adds one or more tags to a resource.

fn untag_resource<'life0, 'async_trait>( &'life0 self, input: UntagResourceRequest, ) -> Pin<Box<dyn Future<Output = Result<UntagResourceResponse, RusotoError<UntagResourceError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Removes one or more tags from a resource.

fn update_action_target<'life0, 'async_trait>( &'life0 self, input: UpdateActionTargetRequest, ) -> Pin<Box<dyn Future<Output = Result<UpdateActionTargetResponse, RusotoError<UpdateActionTargetError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Updates the name and description of a custom action target in Security Hub.

fn update_findings<'life0, 'async_trait>( &'life0 self, input: UpdateFindingsRequest, ) -> Pin<Box<dyn Future<Output = Result<UpdateFindingsResponse, RusotoError<UpdateFindingsError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

UpdateFindings is deprecated. Instead of UpdateFindings, use BatchUpdateFindings.

Updates the Note and RecordState of the Security Hub-aggregated findings that the filter attributes specify. Any member account that can view the finding also sees the update to the finding.

fn update_insight<'life0, 'async_trait>( &'life0 self, input: UpdateInsightRequest, ) -> Pin<Box<dyn Future<Output = Result<UpdateInsightResponse, RusotoError<UpdateInsightError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Updates the Security Hub insight identified by the specified insight ARN.

fn update_standards_control<'life0, 'async_trait>( &'life0 self, input: UpdateStandardsControlRequest, ) -> Pin<Box<dyn Future<Output = Result<UpdateStandardsControlResponse, RusotoError<UpdateStandardsControlError>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Used to control whether an individual security standard control is enabled or disabled.