Skip to main content

AWS

🚧Documentation Under Construction

We are actively working to improve this documentation. The content you see here may be incomplete, subject to change, or may not fully reflect the current state of the feature. We appreciate your understanding as we continue to enhance our docs.

A Brightspot plugin that provides integration with Amazon Web Services (AWS) for content management and media processing capabilities.

Core components​

Client configuration​

  • AwsPlugin: Main plugin that manages AWS client instances and credential providers
  • AwsClientConfig: Abstract configuration for AWS clients with support for custom HTTP clients and credentials
  • StaticAwsClientConfig: Implementation for static credential configuration with region and access key support
  • AwsFilter: Servlet filter for lifecycle management of AWS resources

Submodules​

S3 storage integration​

  • Location: s3/
  • Purpose: Amazon S3 storage item implementation for file storage and retrieval
  • Key Component: S3StorageItem for handling S3-based file operations

SES email integration​

  • Location: ses/
  • Purpose: Amazon Simple Email Service integration for email functionality

Web interface​

  • Location: web/
  • Purpose: Web application components with Docker containerization support

Test framework​

  • Location: test/
  • Purpose: Testing utilities and integration test support

AI and media processing integrations​

Amazon Comprehend​

Natural language processing service for automatic tag and section generation from text content. Analyzes article text to suggest relevant tags and categorization.

Amazon Rekognition​

Image analysis service for automatic keyword generation from uploaded images. Provides content-aware tagging and object recognition capabilities.

Amazon Textract​

Document text extraction service for PDFs and image files. Extracts searchable text from documents, spreadsheets, and presentations.

Amazon Transcribe​

Speech-to-text service for generating transcripts from audio and video files. Enables text search capabilities for multimedia content.

Architecture​

The platform uses AWS SDK v2 with the following key patterns:

  • Credential Management: Supports multiple credential providers including environment variables, IAM roles, and static credentials
  • Client Caching: Utilizes Caffeine caching for efficient AWS client reuse and resource management
  • HTTP Client Configuration: Configurable Apache HTTP client with connection pooling
  • Plugin Architecture: Modular design with separate submodules for different AWS services
  • Lifecycle Management: Automatic resource cleanup and shutdown hooks for proper resource disposal