Feature/assume role

[sliu008]

Feature: S3 Role Assumption via Role Mapping

Summary of Changes:

• New Capability:
  Forge now supports assuming AWS IAM roles for S3 downloads based on bucket name patterns, allowing access to buckets requiring different credentials than the default Lambda/ECS role.

• Configuration:

  • Added support for a role_mappings object in the config, mapping regex patterns or exact bucket names to role ARNs.
  • Example and documentation provided in the new ROLE_MAPPING.md.

• Code Changes:

  • Updated FootprintHandler.java:
    • Added logic to check for role mappings and assume roles using AWS STS when downloading from S3.
    • Refactored S3 download methods to accept config and use assumed credentials if needed.
    • Added helper methods for role assumption and credential management.
  • Updated dependencies in build.gradle to include aws-java-sdk-sts.

• Documentation:

  • README.md updated with usage instructions and configuration examples.
  • New ROLE_MAPPING.md with detailed documentation and best practices.

• Tests:

  • Enhanced FootprintHandlerTest.java:
    • Added tests for role mapping, regex matching, and download logic with/without role assumption.
    • Added a new test input file: input_with_role_mapping.json.

• Files Added/Changed:

  • Major files: FootprintHandler.java, FootprintHandlerTest.java, ROLE_MAPPING.md, input_with_role_mapping.json, README.md, build.gradle.