API keys

From Account Settings, you can set up company information, access API keys, view Blueshift-provided Amazon S3 bucket details, and so on.

API keys

Perform the following steps to access the API keys section:

• Click the hamburger menu next to your user name in the top right corner.
• Click Account Settings.
• Navigate to the API Keys tab.
  • Note that access to view API keys depends on your assigned access level.

The API keys section contains the following:

• Site ID: A unique identifier for your account, required in API requests to specify your site. For example, in the API URL https://api.getblueshift.com/api/v1/resource?site_id=<site_id>, replace <site_id> with your account's Site ID found in the API Keys tab.
• Event API Key: Use this key to authenticate your events if event verification is enabled for your account.
• Event Verification Key: Used to validate the authenticity of events; keep this key private and secure, as it should not be exposed publicly.
• Event Signatures Generated Using: Specifies the hashing algorithm used to generate event signatures for verification. You can choose between SHA-256 and MD5 from the dropdown list.
  • For more information, refer to Event verification (signed events).
• User API key: Use this key to read/write all your account data programmatically. You can manually regenerate your User API key. The current User API key expires when you generate a new key.
• Blueshift API Password: A secure, system-generated password for basic authentication with Blueshift APIs. This password is generated on request and saved to your account, enabling seamless integration where authentication is required.
• Amazon S3 Folder Details: Provides the access credentials and path to interact with your S3 folder. Use this information to read or write content securely. Ensure the credentials are kept confidential, and access is restricted.
• Auth Token for Census Integration: A unique token to authenticate and integrate with the Census integration. Keep this token private and secure to maintain the integrity of your integration.

Amazon S3 bucket

Blueshift uses the Blueshift Customer bucket in AWS to store data, reports, audit trail logs, etc.

The Amazon S3 Folder Details are found in the API Keys tab. Use this information to read/write content from your S3 folder.

S3 bucket:

EU Region: bsft-prod-euw1-customers/<site_name>/
Rest of the world: bsft-customers/<site_name>/

• The account Admin role can access the S3 folder credentials.
• You can manually regenerate your S3 Folder Access key. The S3 Folder Access Key is valid for 30 days after it is generated.

Note: Admins may receive an email prompting them to regenerate the S3 Folder Access Key. If you are not using the key, regeneration is not required.