Configuring a Cloud Object Storage target

A target is an IBM Cloud resource where you can collect auditing events. Use this tutorial to learn how to configure a Cloud Object Storage target in the account.

Scenarios

You can define a Cloud Object Storage bucket as a target in any of the following situations:

You need a solution to monitor the activity in your account that must be Financial Services Validated.
You want to collect and store auditing events in a Cloud Object Storage bucket. You can have the bucket in the account that generates the events or in a different account from the one that generates auditing events.

Prerequisites

Learn about Activity Tracker Event Routing. For more information, see About.
Install the IBM Cloud CLI. For more information, see Installing the IBM Cloud CLI.
Install the latest Activity Tracker Event Routing CLI V2 plugin in your local system. See Installing the Activity Tracker Event Routing CLI.
You need a user ID that is a member, or an owner of, an IBM Cloud account. To get an IBM Cloud user ID, go to: Create an account.
Every user that manages the Activity Tracker Event Routing configuration in your account must be assigned an access policy. The policy determines what actions the user can perform. The allowable actions are customized and defined by Activity Tracker Event Routing as operations that are allowed to be performed on the service. The actions are then mapped to IAM user roles. Learn more.

Your user ID needs administrator platform permissions to manage the IBM Cloud Activity Tracker Event Routing service. Contact the account owner. The account owner can grant another user access to the account for the purposes of managing user access, and managing account resources. Learn more.

Configure a COS bucket

Auditing events that are collected in your account can be stored in IBM Cloud Object Storage (COS) buckets.

When you configure Activity Tracker Event Routing, you must define a target per region. The target defines the COS bucket where auditing events in that region are collected.

Before you create a bucket, consider the following information:

You can create the bucket in any location.
You can only configure 1 bucket per target.
If you have regulatory and compliance requirements, check the locations where you can create a bucket. Then, if performance is critical, consider creating the COS bucket in the same region where the auditing events are generated.

For more information, see Managing IBM Cloud Object Storage (COS) buckets.

You can define a bucket in the account that generates the auditing events or in a different account.

Choose one of the following options to create a bucket:

Table 1. Create bucket requests
Action	More info
Create a bucket through the IBM Cloud UI	Learn more
Create a bucket through the IBM Cloud CLI	Learn more
Create a bucket by using cURL	Learn more
Create a bucket by using the REST API	Learn more
Create a bucket with a different storage class by using the REST API	Learn more
Create a bucket with Key Protect or Hyper Protect Crypto Services managed encryption keys (SSE-KP) by using the REST API	Learn more
Create a bucket by using Terraform	Learn more

Configure service-to-service authorization

Configure service-to-service authorization to your COS bucket so you do not need to pass an API key when writing your encrypted data to the COS bucket.

The following steps show how to define service to service authorization when the COS bucket is available in a different account from where auditing events are generated:

You must complete these steps in the account where the COS bucket is available.

Log in to your IBM Cloud account as the account owner that will be configuring IBM Cloud Activity Tracker Event Routing targets.

After you log in with your user ID and password, the IBM Cloud dashboard opens.
Click Manage > Access (IAM). Manage access and users is displayed.
Click Authorizations.
Click Create.
Select the Source account. Choose Other account. Then, enter the account ID for the source service. An account ID is a 32 character, unique account identifier.
For Source service select Activity Tracker Event Routing and for How do you want to scope the access? select All resources.
For Target service select Cloud Object Storage for How do you want to scope the access? select Resources based on selected attributes.
Select Service instance and string equals the name of your COS instance.
For Service access select Object writer.
Click Authorize. Your new service-to-service authorization will be listed in the Manage authorizations view.

Alternately, you can create the service-to-service policy by running the following command:

ibmcloud iam authorization-policy-create atracker cloud-object-storage "Object Writer"

You will only be able to authorize to the IBM Cloud Object Storage instance using the UI. If you want to limit authorization to a specific IBM Cloud Object Storage bucket, you need to configure authorization using the API.

Create a target

After you create the bucket and configure the authorizartion method, you can configure a target. The target defines the COS bucket where auditing events will be routed.

The region identifies the location from which the writing to the bucket will occur. If you want events from all regions to flow to this one COS bucket, then you only require a single target to be defined.

To create a target, run the following command:

ibmcloud atracker target create --name <TARGET_NAME> --type cloud-object-storage --endpoint <COS_ENDPOINT> --target-crn <COS_TARGET_CRN> --bucket <BUCKET> --region <REGION> --service-to-service-enabled true

Where

--region <REGION>: Name of the region that will process the events, for example, us-south or eu-gb. If not specified, the region logged into, or targeted, will be used.
--name <TARGET_NAME>: The name to be given to the target.
--endpoint <COS_ENDPOINT>: The IBM Cloud Object Storage endpoint to be associated with the IBM Cloud Object Storage bucket.
--bucket <BUCKET>: The name of the IBM Cloud Object Storage bucket to be associated with the target.
--target-crn <COS_TARGET_CRN>: The CRN of the IBM Cloud Object Storage instance.
--service-to-service-enabled: Indicates if service-to-service authorization has been enabled for the bucket. Specify TRUE if service-to-service authorization is enabled and FALSE if service-to-service authorization is not enable.

For example, to create a target in the US-South region, you can run the following command:

ibmcloud atracker target create --name  "My target" --type cloud-object-storage --endpoint "s3.private.us-south.cloud-object-storage.appdomain.cloud" --target-crn "crn:v1:bluemix:public:cloud-object-storage:global:a/<AccountID>:<COSinstanceID>::" --bucket "activity-tracking-bucket-us-south" --region "us-south" --service-to-service-enabled true

To see the target definition in a region, see Getting information about a target using the CLI.

When your target is created the target ID is returned. Make note of the target ID. You will need the target ID to configure a rule that routes events to the target in the account.

Define 1 or more routes in the account. For more information, see Configuring a route.

When you configure a route, you associate a target with the route and define which type of auditing events are collected. The route defines the rules that determine where auditing events are collected in your account. For example, you can define a route that collects auditing events from 2 different regions, and also collects global events.

You can collect global events and location-based events.