Referencing Remote Files

Example URL Protocol Description
  • http://www.mycomany.com/document.pdf
  • https://www.mycompany.com/document.pdf
http/https Accessing files in the manner requires you to make the files accessible over the internet via a web server. Use this method only when the files/content are not of a secure nature.
  • http://user:password@www.mycomany.com/document.pdf
  • https://user:password@www.mycompany.com/document.pdf
http/https with Basic Authentication Using Basic Authentication, you can make your files accessible over the internet only to those who know the correct username and password. The credentials are passed in as part of the URL. It is recommended that only the https protocol be used with this method so the credentials are protected during the request transmission.
  • s3://[bucket-name]/[file-key]
  • s3://mycompany-bucket/document.pdf
Amazon S3 For those that have an Amazon S3 account, you can specify the location of the file by passing in the name of the bucket followed by the file name (or key) of the file. The file is stored in your S3 account and privacy is strictly under your control. You will need to make sure to grant “read only” access to the MessageGears Amazon account so we will be able to retrieve the file.
The MessageGears Amazon S3 canonical user id is: 2dd8e53f1a8e4dfe3a6893d1229635b4915661d95f5283df75215779ce462819
You’ll need to grant “read” access to this ID in Amazon S3 if you want only MessageGears to be able to read your file.