Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Amazon S3 Connector for Confluence user guide:https://hotovo.jira.com/wiki/spaces/HP/pages/87851023/Confluence+-+Amazon+S3+storage+connector+for+Confluence

Panel

Administration

The administration section gives you the ability to manage your Amazon S3 Buckets.

Create Bucket Association

To create a new Bucket association, click on "Add new bucket association"

Image Added


You need to fill in all fields to successfully add new bucket association:

  • Friendly name — represents the name of the account that will be used in the macro and it will mask your real S3 Bucket name.

  • Bucket name — represents your real Amazon S3 account name

  • Access Key — This is actually a username. It is alphanumeric text string that uniquely identifies the user who owns the account. It is Access Key.

  • Access Secret — This key plays the role of a password . It’s called secret because it is assumed to be known by the owner only.

Image Added


To test your Bucket credentials just click on the button “Test connection” and you will be inform about validation result.

Image Added


Once you fill in all fields click on the button “Save” and your account will be stored.

Image Added


If you need to change your bucket association details you can do it when you click on the button “Edit” at the end of the row with listed account details.

Image Added


If you want to delete your existing configured bucket association only click on the button “Delete” at the end of the row with account details you want to remove.

Image Added


Using the S3 Macro on a page

Macro "Amazon S3 Storage Connector" is responsible for rendering the content of Amazon S3 Buckets.

Create a new page or edit an existing page, open a Macro browser and click on the category "Media".

Image Added


Click on the macro and to show the configuration page where you can set the following parameters:

  • Title — Set title for macro content. It will be shown before the content.
  • Bucket — Set the bucket whose content will be shown. Buckets can be configured only in administration.
  • Show border — Allow showing borders around macro content.
  • Display image thumbnails — Allow rendering thumbnails of images.
  • View as:
    • Directory listing — Bucket content will be rendered as directory listing which is similar to a traditional file manager.
    • Tree structure — Bucket content will be rendered in a tree view structure.

Image Added


Selected path in macro will be used as a default root path when a macro is rendered on a page. It means that user cannot traverse above of selected path.

To insert macro with set configuration into a page just click on the button Insert.

Image Added


To edit macro just click on the macro placeholder when editing a page. Property panel gives you also ability to quickly change the title of the macro.

Image Added


Example of Macro content

Image Added