Pure commitment.

USING FILE BROWSERS WITH CLOUD STORAGE

(ECS)

version 1.0

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 2 of 16

CONTENTS

Overview 3

API endpoints 4

Windows applications 5 Cyberduck 5 S3 Browser 8

Browser extensions 10 Chrome — Atmos for Chrome 10 Firefox — AtmosFox 12

Summary 14

More information 14

About UKCloud 15

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 3 of 16

OVERVIEW

UKCloud’s Cloud Storage service is an object storage solution based on Dell EMC Elastic Cloud Storage (ECS). Access is via a RESTful application programming interface (API).

Web applications can easily interact with the API, but the ability to browse the contents of the storage using a graphical client can be useful, as it provides a user-friendly interface to the storage. This enables, for example:

• Verification by developers that their applications or scripts work as intended with the storage

• Bulk import or export of content by users

• Easy maintenance and housekeeping of the objects in the storage system

ECS provides two APIs that you can use to manage Cloud Storage: the S3-compatible API and the EMC ECS Atmos API.

Note! If you write content to Cloud Storage using one of the APIs, you cannot subsequently access that content using the other API. Choose carefully which API you want to use before beginning a project, as it will be difficult to move between them.

In this Blueprint, we’ll look at some of the many applications that enable you to browse an object storage system. We’ll look at two categories:

• Windows applications

• Browser extensions for Chrome and Firefox

The inclusion of applications in this Blueprint should not be taken as an endorsement or recommendation of them by UKCloud. However, we have tested them with our Cloud Storage service and verified that they work correctly.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 4 of 16

API ENDPOINTS

Cloud Storage provides different API endpoints to access your storage, depending on the UKCloud site and connectivity type you are using. Make sure you use the correct endpoint to ensure the best possible performance for your solution.

S3 API endpoint Atmos API endpoint

Corsham (Assured)

Internet cas.cor00005.ukcloud.com atmos.cas.cor00005.ukcloud.com

PSN Assured cas.cor00005.psnassured.

ukcloud.com atmos.cas.cor00005.psnassured.

ukcloud.com

N3 cas.cor00005.ukcloud.

thirdparty.nhs.uk/

atmos.cas.cor00005.ukcloud.

thirdparty.nhs.uk/

Farnborough (Assured)

Internet cas.frn00006.ukcloud.com atmos.cas.frn00006.ukcloud.com

PSN Assured cas.frn00006.psnassured.

ukcloud.com atmos.cas.frn00006.psnassured.

ukcloud.com

N3 cas.frn00006.ukcloud.

thirdparty.nhs.uk

atmos.cas.frn00006.ukcloud.

thirdparty.nhs.uk/

If you’re using the ENHANCED option (geo-resilient storage), you can use either the Corsham or Farnborough endpoints. In the event of a site failure, there will be an outage to objects created on the failed site. UKCloud will bring these objects online in the other site within about 15 minutes.

Contact UKCloud support if you are unsure which endpoint to use.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 5 of 16

WINDOWS APPLICATIONS

This section takes you through installing and configuring two applications: Cyberduck and S3 Browser.

Cyberduck

Cyberduck is an open source cross-platform file browser for HTTP-based object storage solutions. It utilises the S3 endpoints to establish connectivity with the ECS platform over HTTPS.

To install and configure Cyberduck:

1. Download Cyberduck from the following location:

https://cyberduck.io/

2. Install Cyberduck using either the default settings or specifying your own configuration.

3. Download the Cloud Storage Cyberduck profile from the following location:

https://github.com/UKCloud/cloud-storage/blob/master/cyberduck/UKCloud Cloud Storage-ECS.cyberduckprofile

Or directly from EMC:

https://developer-content.emc.com/downloads/jive_attach_proxy.htm?ecnCommID=3939&ecnCommName=ECS%20-%20Elastic%20Cloud%20Storage&ecnAttachmentName=EMC%20ECS%20S3%20(HTTPS%20with%20AWS2).cyberduckprofile&ecnContainerURL=/docs/DOC-27683&reqURL=/servlet/JiveServlet/download/27683-11-131318/EMC%20ECS%20S3%20(HTTPS%20with%20AWS2).cyberduckprofile

Note! If you download this profile using a browser, ensure the file name is

.cyberduckprofile.

4. Browse to the downloaded file and double-click to open it.

5. Complete the fields in the new connection dialog box.

• Ensure you enter the correct endpoint in the Server field, as shown in API endpoints.

• The Access Key ID is your User ID, which you can find in the Storage section of the Portal.

• When you’re done, click the x icon to close the dialog box.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 6 of 16

6. You can see the new connection in the Cyberduck UI.

7. Right-click the connection and select Connect to server.

8. In the Login dialog box, in the Secret Access Key field, enter your Cloud Storage secret key.

If you’ve forgotten or don’t know your secret key, you can reset it in the Storage section of the Portal.

Note! Unless you want the password to be saved, deselect the Save password check box.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 7 of 16

9. After you’ve authenticated yourself with your secret key, you can view, upload and download files as normal.

10. For additional information, see Connecting to ECS with Cyberduck at:

https://community.emc.com/docs/DOC-27683

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 8 of 16

S3 Browser

S3 Browser is a Windows client for Amazon S3 that you can easily configure to work with the S3-compatible API on Cloud Storage. It’s free for personal use; a licence fee is payable for business use.

To install and configure S3 Browser:

1. Download S3 Browser from the following location:

http://s3browser.com/

2. Execute the installer and follow the prompts in the wizard to complete the installation.

3. The first time you launch S3 Browser, you’ll be prompted for your account credentials. Fill in the form with your Cloud Storage credentials.

a. From the Account Type list, select S3 Compatible Storage.

b. Ensure you enter the correct endpoint in the REST Endpoint field, as shown in API endpoints.

c. The Access Key ID is your User ID, which you can find in the Storage section of the Portal.

d. The Secret Access Key is your secret key. If you’ve forgotten or don’t know your secret key, you can reset it in the Storage section of the Portal.

e. If you are using version 6.x.x of the browser, be sure to select Use secure transfer (SSL/TLS). This option is not available or necessary for version 5.x.x.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 9 of 16

4. When you’re done, click Save changes. The application automatically connects to Cloud Storage and displays your buckets (if you have any).

5. For detailed usage instructions, see the documentation available on the S3 Browser web site.

Note! Not all S3 features are implemented by the ECS S3-compatible API, so some functionality may not work. However, common file operations (create, read, write and delete) all work well.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 10 of 16

BROWSER EXTENSIONS

This section takes you through installing and configuring browser extensions that enable you to browse the contents of Cloud Storage using your web browser.

Atmos extensions are available for both Chrome and Firefox. Although the extensions included in this Blueprint were natively built for the Atmos platform, they also work with ECS using Atmos endpoints and therefore work well with Cloud Storage.

S3 extensions are also available for both browsers, but none of them include the functionality to customise the server host name, which is a requirement for connecting to Cloud Storage. If we find S3 browser extensions that offer this functionality in the future, we’ll update this Blueprint.

Chrome — Atmos for Chrome

To install and configure Atmos for Chrome:

1. Download and install the extension from the following location:

https://chrome.google.com/webstore/detail/atmos-for-chrome/befofpjhdclgccimklkaheifjajbcmnk

2. After you complete the installation, you’ll see a globe icon in your browser toolbar. Click this icon to launch the extension.

3. To connect the extension to Cloud Storage, click the Manage Accounts button.

4. Add an account for Cloud Storage using your credentials, which you can find in the Storage section of the UKCloud Portal.

Note! The UID value is a combination of the subtenant ID (bucket name) and your

user ID, joined by a forward slash (/): subtenant_id/user_id. Ensure you enter the correct endpoint in the Atmos URL field, as shown in API endpoints.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 11 of 16

5. When you’re done, click Save, then Close.

6. You can now:

• Browse the buckets and files stored in your account

• Use the toolbar buttons to upload files and folders

• Double-click items to download them

• Access other operations for selected items through context menus

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 12 of 16

Firefox — AtmosFox

To install and configure AtmosFox:

1. Download and install the extension from the following location:

https://addons.mozilla.org/en-US/firefox/addon/atmosfox/

2. After you complete the installation, in Firefox, select AtmosFox Explorer from the Tools menu to launch the extension.

Note! You may need to press the Alt key to reveal the Tools menu.

3. To connect to Cloud Storage, in the Manage Account dialog box, specify your Cloud Storage credentials, which you can find in the Storage section of the UKCloud Portal.

Note! The UID value is a combination of the subtenant ID (bucket name) and your

user ID, joined by a forward slash (/): subtenant_id/user_id. Ensure you enter the correct endpoint in the Atmos URL field, as shown in API endpoints.

4. When you’re done, click Save, then Close.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 13 of 16

5. You can now browse the buckets and files stored in your account.

You’ll see two lists of files: your local machine on the left and your Cloud Storage on the right. Use the large red arrows in the centre to transfer files to and from Cloud Storage. Context menus work well on both sides, enabling you to access a variety of functions.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 14 of 16

SUMMARY

In this Blueprint you’ve learned how to use different file browsers to interact with your Cloud Storage service.

If you don’t have Cloud Storage associated with your UKCloud account, or you're having problems accessing your Cloud Storage service using the supplied credentials, contact UKCloud Support for assistance.

If you need more help with an application or extension referenced in this Blueprint, please consult the application provider.

MORE INFORMATION

For further information about UKCloud and how we can help you, please email us at info@ukcloud.com.

Using file browsers with Cloud Storage UKC-GEN-575 © UKCloud Ltd, 2017 Open Page 15 of 16

ABOUT UKCLOUD

UKCloud is dedicated to the UK Public Sector. We provide assured, agile and value-based true public cloud that enable our customers to deliver enhanced performance through technology.

• We’re focused on cloud. Delivering a true cloud platform that is scalable, flexible, assured and cost-effective.

• We’re open. You are never locked in. Using industry

standards and open source software we enable flexibility and choice across multiple cloud solutions.

• Dedicated to the UK Public Sector. Our business is designed

specifically to serve and understand the needs of public sector organisations.

• We develop communities. We

bring together communities of users that are able to share datasets, reuse code, test ideas and solve problems.

• Customer engagement. We will only be successful if our customers are successful. We embody this in the promise: Easy to adopt. Easy to use. Easy to leave.

Additional information about UKCloud can be found at www.ukcloud.com or by following us on Twitter at @ukcloudltd.

UKCloud. The power behind public sector technology.

UKCloud Ltd

A8 Cody Technology Park Ively Road, Farnborough Hampshire, GU14 0LX

T 01252 303300 E info@ukcloud.com

www.ukcloud.com

@ukcloudltd

ukcloudltd

ukcloud-ltd

Reasonable efforts have been made to ensure the accuracy of the information contained in this document. No advice given or statements or recommendations made shall in any circumstances constitute or be deemed to constitute a warranty by UKCloud Ltd as to the accuracy of such advice, statements or recommendations. UKCloud Ltd shall not be liable for any loss, expense, damage or claim howsoever arising out of the advice given or not given or statements made or omitted to be made in connection with this document.

No part of this document may be copied, reproduced, adapted or redistributed in any form or by any means without the express prior written consent of UKCloud Ltd.

© UKCloud Ltd 2017 All Rights Reserved.

UKC-GEN-575 • 08/2017 • version 1.0