AWS Cloudtrail

Consume events from Amazon Cloudtrail using AWS SDK version 2.x.

What’s inside

AWS Cloudtrail component, URI syntax: aws-cloudtrail:label

Please refer to the above links for usage and configuration details.

Maven coordinates

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-aws-cloudtrail-starter</artifactId>
</dependency>

Spring Boot Auto-Configuration

The starter supports 23 options, which are listed below.

Name	Description	Default	Type
camel.component.aws-cloudtrail.access-key	Amazon AWS Access Key		String
camel.component.aws-cloudtrail.autowired-enabled	Whether autowiring is enabled. This is used for automatic autowiring options (the option must be marked as autowired) by looking up in the registry to find if there is a single instance of matching type, which then gets configured on the component. This can be used for automatic configuring JDBC data sources, JMS connection factories, AWS Clients, etc.	true	Boolean
camel.component.aws-cloudtrail.bridge-error-handler	Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only, and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component and make this possible for future releases. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.	false	Boolean
camel.component.aws-cloudtrail.cloud-trail-client	Amazon Cloudtrail client to use for all requests for this endpoint. The option is a software.amazon.awssdk.services.cloudtrail.CloudTrailClient type.		CloudTrailClient
camel.component.aws-cloudtrail.configuration	Component configuration. The option is a org.apache.camel.component.aws.cloudtrail.CloudtrailConfiguration type.		CloudtrailConfiguration
camel.component.aws-cloudtrail.enabled	Whether to enable auto configuration of the aws-cloudtrail component. This is enabled by default.		Boolean
camel.component.aws-cloudtrail.event-source	Specify an event source to select events		String
camel.component.aws-cloudtrail.health-check-consumer-enabled	Used for enabling or disabling all consumer based health checks from this component	true	Boolean
camel.component.aws-cloudtrail.health-check-producer-enabled	Used for enabling or disabling all producer based health checks from this component. Notice: Camel has by default disabled all producer based health-checks. You can turn on producer checks globally by setting camel.health.producersEnabled=true.	true	Boolean
camel.component.aws-cloudtrail.max-results	Maximum number of records that will be fetched in each poll	1	Integer
camel.component.aws-cloudtrail.override-endpoint	Set the need for overriding the endpoint. This option needs to be used in combination with uriEndpointOverride option	false	Boolean
camel.component.aws-cloudtrail.profile-credentials-name	If using a profile credentials provider this parameter will set the profile name.		String
camel.component.aws-cloudtrail.proxy-host	To define a proxy host when instantiating the Cloudtrail client		String
camel.component.aws-cloudtrail.proxy-port	To define a proxy port when instantiating the Cloudtrail client		Integer
camel.component.aws-cloudtrail.proxy-protocol	To define a proxy protocol when instantiating the Cloudtrail client	https	Protocol
camel.component.aws-cloudtrail.region	The region in which Cloudtrail client needs to work. When using this parameter, the configuration will expect the lowercase name of the region (for example ap-east-1) You’ll need to use the name Region.EU_WEST_1.id()		String
camel.component.aws-cloudtrail.secret-key	Amazon AWS Secret Key		String
camel.component.aws-cloudtrail.session-token	Amazon AWS Session Token used when the user needs to assume a IAM role		String
camel.component.aws-cloudtrail.trust-all-certificates	If we want to trust all certificates in case of overriding the endpoint	false	Boolean
camel.component.aws-cloudtrail.uri-endpoint-override	Set the overriding uri endpoint. This option needs to be used in combination with overrideEndpoint option		String
camel.component.aws-cloudtrail.use-default-credentials-provider	Set whether the Cloudtrail client should expect to load credentials through a default credentials provider or to expect static credentials to be passed in.	false	Boolean
camel.component.aws-cloudtrail.use-profile-credentials-provider	Set whether the Cloudtrail client should expect to load credentials through a profile credentials provider.	false	Boolean
camel.component.aws-cloudtrail.use-session-credentials	Set whether the CloudTrail client should expect to use Session Credentials. This is useful in situation in which the user needs to assume a IAM role for doing operations in CloudTrail.	false	Boolean

Name

Description

Default

Type

camel.component.aws-cloudtrail.access-key

Amazon AWS Access Key

String

camel.component.aws-cloudtrail.autowired-enabled

Whether autowiring is enabled. This is used for automatic autowiring options (the option must be marked as autowired) by looking up in the registry to find if there is a single instance of matching type, which then gets configured on the component. This can be used for automatic configuring JDBC data sources, JMS connection factories, AWS Clients, etc.

true

Boolean

camel.component.aws-cloudtrail.bridge-error-handler

Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler. Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only, and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component and make this possible for future releases. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.

false

Boolean

camel.component.aws-cloudtrail.cloud-trail-client

Amazon Cloudtrail client to use for all requests for this endpoint. The option is a software.amazon.awssdk.services.cloudtrail.CloudTrailClient type.

CloudTrailClient

camel.component.aws-cloudtrail.configuration

Component configuration. The option is a org.apache.camel.component.aws.cloudtrail.CloudtrailConfiguration type.

CloudtrailConfiguration

camel.component.aws-cloudtrail.enabled

Whether to enable auto configuration of the aws-cloudtrail component. This is enabled by default.

Boolean

camel.component.aws-cloudtrail.event-source

Specify an event source to select events

String

camel.component.aws-cloudtrail.health-check-consumer-enabled

Used for enabling or disabling all consumer based health checks from this component

true

Boolean

camel.component.aws-cloudtrail.health-check-producer-enabled

Used for enabling or disabling all producer based health checks from this component. Notice: Camel has by default disabled all producer based health-checks. You can turn on producer checks globally by setting camel.health.producersEnabled=true.

true

Boolean

camel.component.aws-cloudtrail.max-results

Maximum number of records that will be fetched in each poll

Integer

camel.component.aws-cloudtrail.override-endpoint

Set the need for overriding the endpoint. This option needs to be used in combination with uriEndpointOverride option

false

Boolean

camel.component.aws-cloudtrail.profile-credentials-name

If using a profile credentials provider this parameter will set the profile name.

String

camel.component.aws-cloudtrail.proxy-host

To define a proxy host when instantiating the Cloudtrail client

String

camel.component.aws-cloudtrail.proxy-port

To define a proxy port when instantiating the Cloudtrail client

Integer

camel.component.aws-cloudtrail.proxy-protocol

To define a proxy protocol when instantiating the Cloudtrail client

https

Protocol

camel.component.aws-cloudtrail.region

The region in which Cloudtrail client needs to work. When using this parameter, the configuration will expect the lowercase name of the region (for example ap-east-1) You’ll need to use the name Region.EU_WEST_1.id()

String

camel.component.aws-cloudtrail.secret-key

Amazon AWS Secret Key

String

camel.component.aws-cloudtrail.session-token

Amazon AWS Session Token used when the user needs to assume a IAM role

String

camel.component.aws-cloudtrail.trust-all-certificates

If we want to trust all certificates in case of overriding the endpoint

false

Boolean

camel.component.aws-cloudtrail.uri-endpoint-override

Set the overriding uri endpoint. This option needs to be used in combination with overrideEndpoint option

String

camel.component.aws-cloudtrail.use-default-credentials-provider

Set whether the Cloudtrail client should expect to load credentials through a default credentials provider or to expect static credentials to be passed in.

false

Boolean

camel.component.aws-cloudtrail.use-profile-credentials-provider

Set whether the Cloudtrail client should expect to load credentials through a profile credentials provider.

false

Boolean

camel.component.aws-cloudtrail.use-session-credentials

Set whether the CloudTrail client should expect to use Session Credentials. This is useful in situation in which the user needs to assume a IAM role for doing operations in CloudTrail.

false

Boolean