How to Configure an Amazon S3 Destination in the Integration Center
Brief Overview
By using WalkMe’s Integration Center it is possible to either export Insights reports to an Amazon Simple Cloud Storage (S3) bucket or to pull attributes from an Amazon Simple Cloud Storage (S3) bucket and populate data into WalkMe from for analytics and content segmentation.
Option A – Authenticate by Credentials
- In Authentication method choose: “By Credentials”
- Provide Access Key and Secret Key of your Amazon S3
Option B – Authenticate by IAM Role
This option enables adding an S3 bucket destination by having the client create an IAM role that can access their S3 bucket, and enabling WalkMe to assume that role to access it.
- Create S3 bucket with name <bucket-name>
- Create IAM Role with the following permissions and trust relationship:
- IAM Role permissions:
- Replace ‘ <bucket-name> ‘ with actual bucket name
{
"Version"
:
"2012-10-17"
,
"Statement"
: [
{
"Sid"
:
"AllowWalkMeRole0"
,
"Effect"
:
"Allow"
,
"Action"
:
"s3:ListBucket"
,
"Resource"
:
"arn:aws:s3:::<bucket-name>/"
},
{
"Sid"
:
"AllowWalkMeRole1"
,
"Effect"
:
"Allow"
,
"Action"
: [
"s3:GetObject"
,
"s3:PutObject"
,
"s3:DeleteObject"
],
"Resource"
:
"arn:aws:s3:::<bucket-name>/*"
}
]
}
- Trust relationship:
{
"Version"
:
"2012-10-17"
,
"Statement"
: [
{
"Effect"
:
"Allow"
,
"Principal"
: {
"AWS"
: [
"arn:aws:iam::758936404074:role/integrateme-ecs-instance-production"
,
"arn:aws:iam::758936404074:role/rundeck-worker"
,
"arn:aws:iam::758936404074:role/chatbot-asg-prodeu"
,
"arn:aws:iam::758936404074:role/rundeck-worker-eu"
]
},
"Action"
:
"sts:AssumeRole"
,
"Condition"
: {}
}
]
}
- IAM Role permissions:
- In the Integration center – S3 destination setup form:
- Under Authentication Method select: “IAM Role – Bucket on Customer’s side”
- Enter the IAM role ARN value, <bucket-name> and its region
How to Add a Subfolder
To preserve order within the S3 folder, you can create subfolders inside your S3 destination folder. This can be done both for new destinations or editing existing destinations.
This is especially useful when you are using the S3 destination for more than one system, or for more then one analytic purpose, such as different reports exported for different in-house customer departments.
To add a subfolder, please follow these steps:
- Open the S3 destination in Insights
- In the “Optional Bucket Path” field, add a “/” and the name of the subfolder to be added
- In the example image below you can see that the subfolder being added is called “subfolder_name”
- This will create a subfolder “subfolder_name” in the s3 folder instance