Skip to main content

AWS

Source code Package

The AWS destination package allows you to send events to various AWS services using walkerOS. Currently, it supports AWS Firehose with plans to add more services like SNS, SQS, CloudWatch, and Lambda.

You can add the destination multiple times, each with one AWS service configured, or once with all services combined. This flexibility allows you to use different credentials or handle error handling individually.

Installation

To get started, install the package via npm:

npm install @elbwalker/destination-node-aws

Configuration

Configure the AWS destination with your AWS credentials and settings.

Example

import destinationAWS from '@elbwalker/destination-node-aws';

const config = {
firehose: firehoseConfig,
};

await elb('walker destination', destinationAWS, config);

Firehose

To configure AWS Firehose, use the following example:

const firehoseConfig = {
streamName: 'your-firehose-stream-name',
region: 'eu-central-1', // e.g., 'eu-central-1' for Frankfurt
credentials: {
accessKeyId: 'your-access-key-id',
secretAccessKey: 'your-secret-access-key',
},
};

await elb('walker destination', destinationAWS, { firehose: firehoseConfig });

Optional Configuration Fields

  • region: AWS region where your services are hosted.
  • credentials: AWS credentials for authentication, containing accessKeyId and secretAccessKey.

Permissions

When using AWS credentials, it's recommended to follow the principle of least privilege. Never grant more permissions than what is necessary to perform the intended functions.

During initial setup, the credentials may require broader permissions to create necessary resources. For production environments, it is recommended to assign specific permissions directly to the resources required.

For more detailed information, refer to the official AWS IAM documentation.

info

If you need professional support with your walkerOS implementation, check out our services.