WinSCP is a free, open-source Windows application for file transfer via Amazon S3, WebDAV, FTP, SFTP, and SCP. It's primarily used to securely upload, download, and manage files between a local computer and remote servers. This guide walks you through configuring the WinSCP to manage your buckets and objects.
It's crucial to have access to a Windows workstation and your sObject Storage credentials, which you'll obtain when you deploy sObject from your Psychz Dashboard.
Important Note: While creating the sObject, the system will display the following details
Access Key: DRTYHBVJGBGCHBNJ
Secret Access Key: UTGjuhtfgyTHJGHhuuhgghhtYUIJHGfyghhbhjgfHGGH
Endpoint URL: https://sobject.uswest1.psychz.net
You must copy and save the data in a secure place, as you will need this information while creating the bucket. After 60 minutes, this information will disappear from the dashboard.
Download and Install WinSCP
Access the WinSCP Website
- On your Windows workstation, open a web browser and navigate to https://winscp.net/eng/download.php
Download and install the Software
- Once on the homepage, locate and click the "Download WinSCP 6.3.3" button.
- After the download is complete, open the installer file. Follow the on-screen instructions to install the WinSCP on your workstation.
Launch WinSCP
After installation, you can launch WinSCP by finding it in your Start menu or by double-clicking its desktop icon.
Add a New Site
Navigate to New Site
- In the WinSCP interface, locate the "New Site" on the left side.
Enter Session Details
- From the "File Protocol" dropdown, choose "Amazon S3". This setting allows WinSCP to connect to storage services that use the S3 API.
Enter Host Name and Port
- In the "Host Name" field, enter the URL provided by Psychz for sObject service.
Port: 443
Enter Access Key ID and Secret Access Key
- Enter your Access Key ID. This unique identifier for your account is shared with you when you create sObject.
- Enter your Secret Access Key. This acts as a password for your Access Key ID and is also shared with your Access Key ID at the time of sObject creation.
Select Default Region & URL Style
- Click on Advanced and choose Advanced. Select "S3" under "Environment" on the left-hand side of the window.
- Select "US-west-1" from the default region dropdown menu.
- Select "Virtual Host" from the URL style dropdown menu.
Click the "Login" button to connect to your object storage. WinSCP will then attempt to connect to Psychz's sObject using the provided credentials.
Upload a File to Bucket
Navigate to your Bucket
- Once logged in, you will see a list of your available S3 buckets in the right panel (remote system).
- Double-click the bucket where you want to upload the file.
- Navigate to a specific folder inside the bucket.
Select and Upload a File
- In the left panel (local system), navigate to the folder on your computer where the file is stored.
- Drag and drop the file from the left panel (your local system) to the right panel (S3 bucket).
- Alternatively, you can select the file in the left panel and click the Upload button.
Confirm File Upload
- After the file transfer completes, it will appear in your S3 bucket.
Set Bucket/File Permissions
- Right-click on the file or folder.
- Choose Properties from the context menu.
- From ACL section, select/check "R" to enable permission. R (Read): Allows the selected group (Owner, Users, or Everyone) to view or download the file.
This file/folder can now be accessed using the following virtual bucket hostname: `<bucketname>.sobject.uswest1.psychz.net`.
You have successfully configured WinSCP to connect to Psychz's sObject. You can begin managing your object storage directly from the WinSCP interface. With these steps, you can access, upload, and manage your data.