S3 Service Access

This page gives you an overview how you get access to our S3 services. The access management varies between the Ceph-based and the Cloudian-based solution whereby both serve the S3 API.

The below overview guides you through this process.

Access Guides

Select Region:

Select S3 Backend:

Grant Access (project admin only)

The Object Storage (S3) needs to be enabled for each SWITCHengines project.

  1. Login to https://engines.admin.switch.ch
  2. Select Object Storage tab of your target project
  3. Enable the Object Storage (S3) by clicking the "Add Object Storage (S3) To Project" button

After a few seconds, you should be able to see a new section on the Object Storage tab of your project.

Important: Reach out to your project administrator to get access to the Object Storage (S3) service.

Access Credentials

In order to get access to the S3 service, you need the information about access key, secret key and endpoint . You get this information from:

  • SWITCHEngines AdminUI (project admins only): Object Storage -> "Show Credentials"
  • SWITCHEngines Dashboard
    1. Open: Project -> Object Storage (S3) -> Dashboard 
      ( You will be redirected to our S3 Dashboard: https://cmc.os.switch.ch )
    2. Select: User Icon -> Security Credentials

S3 Dashboard and Help

You can login to the dashboard via https://engines.switch.ch under Project -> Object Storage (S3) -> Dashboard

This will redirect you to our S3 dashboard where you can manage your data.

  • Security Credentials: User Icon -> Security Credentials
  • Endpoint: User Icon -> Security Credentials
  • Help: Help 

Access Credentials

The Ceph-based object storage is natively integrated into our Openstack infrastructure.
You can get Access Key, Secret Key and Endpoint via:

  • SWITCHengines Dashboard:
    • Select target region (ZH/LS)
    • Project -> API Access
    • Under "View Credentials", you get the EC2 Access and Secret Key
      api access
  • Openstack CLI: 
    1. Make sure you have the OpenStack CLI tool installed (see Openstack CLI )
    2. Source your OpenStack credentials
    3. Run the OpenStack command:
      openstack ec2 credentials list
    4. You should get your EC2 Access Key and Secret Key for the project.

The EC2 credentials are valid per user in a given project (tenant) for both region (LS or ZH).

 

Dashboard

Click in SWITCHenginesUI on the Project -> Object Store -> Containers.

To create a Bucket (alias Container) click on the "+ Container" button.

create bucket

Next, you need to enter a name for the Bucket. Be sure to chose a valid bucket name.

Once done, please confirm by clicking on "Submit" in the bottom right corner.

name bucket

 

The new Bucket is now visible

bucket visible
 

Select S3 Backend:

Access Credentials

The Ceph-based object storage is natively integrated into our Openstack infrastructure.
You can get Access Key, Secret Key and Endpoint via:

  • SWITCHengines Dashboard:
    • Select target region (ZH/LS)
    • Project -> API Access
    • Under "View Credentials", you get the EC2 Access and Secret Key
      api access
  • Openstack CLI: 
    1. Make sure you have the OpenStack CLI tool installed (see Openstack CLI )
    2. Source your OpenStack credentials
    3. Run the OpenStack command:
      openstack ec2 credentials list
    4. You should get your EC2 Access Key and Secret Key for the project.

The EC2 credentials are valid per user in a given project (tenant) for both region (LS or ZH).

 

Dashboard

Click in SWITCHenginesUI on the Project -> Object Store -> Containers.

To create a Bucket (alias Container) click on the "+ Container" button.

create bucket

Next, you need to enter a name for the Bucket. Be sure to chose a valid bucket name.

Once done, please confirm by clicking on "Submit" in the bottom right corner.

name bucket

 

The new Bucket is now visible

bucket visible