1. Home
  2. admin
  3. storage
  4. editing
  5. s3 compatible

Roles

These are the roles that are needed:

  • Admin
  • Read storage
  • Write storage
  • Reindex storage

Links

Editing S3 Compatible Storage

This gives an overview of the parameters on the editing settings for an S3 Compatible Storage. You only need to change the fields that you wish to when editing. Secret Key will be kept blank

General Settings Tab

  • Name - The given name for displaying in iconik
  • Storage Purpose - Purpose for the storage. See Storage Overview for more information.
  • Storage Type - Non-editable.
  • Default Storage - Will be used as the default storage for uploads and transfers
  • Access Key - The access key for the S3 storage you wish to use.
  • Secret Key - The secret key for the S3 storage you wish to use. This will not be displayed after adding, but will be securely stored and can be updated, otherwise leave it blank.
  • Bucket - The name of the S3 bucket.
  • Path - If left empty, iconik will use the whole bucket. Otherwise defines which part of the bucket the storage should start at.
  • Region - The region which the bucket is located at.
  • Endpoint - The endpoint for your bucket.
  • Use Acceleration. Turn this off.
  • Add unique id to the filenames - turn this on to avoid filename collisions. This setting will be inactive for archive storages - and the filename will be kept as it is on the source storage
  • Read - If enabled, iconik will be able to read files on this storage.
  • Write - If enabled iconik will be able to write files to this storage.
  • Delete - If enabled, iconik will be allowed to delete files on this storage. Please note, that if this is set to true, that when an asset is deleted in iconik it will also be removed from this storage upon Purging

Scan Settings Tab

Scan Settings

  • Enable Scan - You can enable scanning for new files on this storage. A label "SCAN" will be visible next to the storage in the list. Click on SCAN to scan through the cloud storage and add the new files to iconik.
  • Scan Directories - If you added a path here it will be used as the root point for scanning. You can optionally add as many as you wish.
  • Auto Scan - Will automatically scan for new content periodically.

Files

  • Ignore Files Patterns - The ISG will ignore to scan the files which contain the pattern from this field. Examples:
    • *exclude* (match file/folder with substring exclude)
    • *.pdf (match file/folder that ends on .pdf)
    • You can also use regular expressions: re:/^.*\.png$/ (match file/folder with .png ending)
  • Consider identical files the same - Compares the checksum of the file found to all files in iconik, if it matches it will create a new file entry for the file on the existing asset.
  • Don't aggregate pattern - Even if a file is considered the same by checksum you can setup patterns to make sure that the file is marked as unique. See Storage Scanning
  • Aggregate on same storage - Files that are considered the same will only be aggregated into the same asset on the same storage.
  • Filename is external id - Will populate the external ID field on the asset with the filename of the file.
  • Sidecar metadata required - Requires that a sidecar file is present to import a file for iconik Storage Gateway Storages.
  • Sidecar metadata view - The Metadata View that is used to show the sidecar metadata.
  • Metadata Conversion Url - The (Optional) URL to be called for metadata translation for the sidecar metadata.
  • Headers - The (Optional) Headers to be sent to the above URL.
  • ACL Template - The ACL Template that will be used to set permissions on assets created from files on this storage.
  • Group Access - The User Group that will be given access to the assets created from files find during scanning.

Directories

  • Collection Directory Mapping - When enabled this will create a collections that map the directories on the file system.
  • Folder Name Tags Metadata View - This will map the folder name into a metadata tags in the metadata view defined. Choose the metadata view with a tags field in it.
  • Folder name tags metadata view field name - (shown when a tag field is found in a metadata view selected by Folder Name Tags Metadata View ).

Transcode Settings Tab

Transcode Settings

  • Transcode Exclude Patterns - The ISG will not transcode which contain the pattern from this field.

Transcoders

Here you can add the ability for this storage to utilize the transcoders you have defined.

To add transcoders, select the transcoder from the list and click to continue.

To remove a transcoder click the trash icon next to it.

ACLs Tab

The ACLs tab for storage defines who is allowed to use the storage. You can add individual users or groups of users, and the interface uses the same mechanism as adding Access Controls to Assets

Learn more