Amazon S3 Files for Confluence

Atlassian Approved for Confluence Data Center on 2019-09-20

Helps to Store, manage, versioning and centralize space or project related files or documents on Amazon AWS S3 bucket.

Features

Beside Upload, Option to attach and detach existing AWS S3 Files on Confluence.
Helps Files Versioning in AWS S3 bucket
Provides Macros
- Amazon S3 Files Summary {amazon-s3-files-summary}
- Amazon S3 File Link {amazon-s3-file-link}
Space S3 Documents REST API

If your upgrading from older than version 2.0.2, please re-update the bucket configuration.

Quick Start Steps

Step-1

Go to General Configuration → Configure Amazon S3 Buckets.

Note:

Access Secret Keys are not required If you are Confluence is hosted on AWS EC2.
- You can attach S3 role to EC2 with read and write access
- If you are bucket is on different account then use Bucket policy to grant permission to Confluence Hosted account.
For Access Secret Keys two ways to get i.e.
- Create IAM User through Console (Simple & easy step)
- create IAM User through Instance profile

Step-2

Go to page options i.e. Click (…) → Amazon S3 Files

Attach existing files or upload new one.

Attach / Link existing Amazon S3 File to Space via REST API.

% curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/attach/document" \
   -H "Content-Type: application/json" --data '{"bucketConfigId": 4, "spaceKey": "DT", \
   "pageId": 4816905, "documentKey": "s3://ilaesolution/documents/DT/pom.xml"}'
{"status":19,"message":"Amazon S3 File has been attached to Space. File ID #19"}
%

Upload new Amazon S3 File via REST API.

% curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/upload/document" \
  -H "X-Atlassian-Token: no-check" -F bucketId=4 -F pageId=4816905 -F file=@/tmp/pom.xml
{"status":0,"message":"Space S3 File Upload Successful. (documents/DT/pom.xml)"}
%

To overwrite: -F updateDocument=true

Step-3

Go to page Edit → Add Amazon S3 File Link or Amazon S3 Files Summary macros.

Results:

Step-4

For Debug. Go to, Logging and profiling → Add new entry

Package / Class Name: com.tse.confluence.spaces3documents.plugin
Logging Level: DEBUG