Contents x
WinSCP Integration with Backblaze B2
    • Print
    • Dark
      Light
    Contents

    WinSCP Integration with Backblaze B2

      • Print
      • Dark
        Light
      Article summary

      WinSCP is a free, open-source Windows tool that works as a file transfer client for SFTP, FTP, WebDAV, SCP, and S3. It lets you transfer files between a local and remote computer, including S3-compatible storage like Backblaze B2 Cloud Storage.

      You can use WinSCP with Backblaze B2 by setting up a session to connect to your Backblaze B2 account.

      Enable Backblaze B2

      Before you begin: You must have a Backblaze B2 Cloud Storage account. If you already have a Backblaze account and the left navigation menu contains a B2 Cloud Storage section, your account is already enabled for Backblaze B2.

      1. Sign in to the Backblaze web console.
      2. In the user menu in the upper-right corner of the page, select My Settings.
      3. Under Enabled Products, select the checkbox to enable B2 Cloud Storage.
      4. Review the Terms and Conditions, and click OK to accept them. 

      Create an Application Key

      1. Sign in to the Backblaze web console.
      2. In the left navigation menu under B2 Cloud Storage, click Application Keys.
      3. Click Add a New Application Key, and enter an app key name.
        You cannot search an app key by this name; therefore, app key names are not required to be globally unique. Key names are limited to 100 characters and can contain letters, numbers, and "-", but not I18N characters, such as é, à, and ü.
      4. Select All or select a specific bucket in the Allow Access to Bucket(s) menu.
      5. Optionally, select your access type (Read and Write, Read Only, or Write Only).
      6. Optionally, select Allow List All Bucket Names.
        This option is required for the B2 Native API b2_list_buckets and the S3-Compatible API S3 List Buckets operations.
      7. Optionally, enter a file name prefix to restrict application key access only to files with that prefix.
        Depending on what you selected in step #4, this limits application key access to files with the specified prefix for all buckets or just the selected bucket.
      8. Optionally, enter a positive integer to limit the time, in seconds, before the application key expires.
        The value must be less than 1000 days (in seconds).
      9. Click Create New Key, and note the resulting keyID and applicationKey values.
      Note
      When you create a new app key, the response contains the actual key string, for example N2Zug0evLcHDlh_L0Z0AJhiGGdY. You can always find the keyID on this page, but for security, the applicationKey appears only once. Make sure you copy and securely save this value elsewhere.

      Set up a Backblaze B2 Session in WinSCP

      1. Open WinSCP.
      2. In the connection manager, click New Site.
      3. Select Amazon S3 as your file protocol.
      4. Enter your S3 endpoint URL as your host name.
      5. Enter 443 as your port number.
      6. Enter your Backblaze B2 key ID as your Access key ID.
      7. Enter your Backblaze B2 application key as your Secret access key.
      8. Click Login.
      Was this article helpful?
      Related articles
      What's Next