ossbrowser is a graphical management tool developed by Alibaba Cloud. This tool provides features similar to Windows Explorer. This topic describes how to install and log on to ossbrowser.

Procedure

  1. Download and install ossbrowser.
    Current version Download URL Description
    1.16.0 Windows x32 Windows 7 and later versions are supported.
    Windows x64
    macOS Applications that are not verified by developers cannot be run on macOS. If this issue occurs, modify the security settings of your system. For more information, see What do I do if I cannot run ossbrowser on macOS?.
    Linux x64 (not recommended) If issues occur when you install ossbrowser on Linux, download and compile the source code to troubleshoot the issues.
  2. Log on to ossbrowser. In this topic, Windows is used in the example to describe the procedure.
    1. Double-click oss-browser.exe.
    2. Use one of the following methods to log on to ossbrowser:
      • Use an AccessKey pair to log on to ossbrowser

        You can use the AccessKey pair of an Alibaba Cloud account or a RAM user to log on to ossbrowser.

        The following table describes the parameters that you can configure when you use an AccessKey pair to log on to ossbrowser.

        Parameter Description
        Endpoint Select the endpoint of region that you want to access.
        • Default (Public Cloud): The endpoint of the region in which the current bucket is located is used to log on to ossbrowser.

          When you select this value, you can select HTTPS encryption to encrypt data transmission.

        • Customize: The endpoint point of another region is used to log on to ossbrowser. Example: https://oss-cn-beijing.aliyuncs.com. For more information about regions and endpoints, see Regions and endpoints.
        • cname: A custom domain name is used to access Object Storage Service (OSS) resources. You must map a custom domain name to the bucket that you want to access in advance. For more information, see Map custom domain names. After you map a custom domain name to the bucket, enter the custom domain name to access the bucket.
        AccessKeyId and AccessKeySecret Enter the AccessKey pair of your account. For more information about how to obtain the AccessKey pair, see Create an AccessKey pair.
        Notice To ensure data security, we recommend that you use the AccessKey pair of a Resource Access Management (RAM) user to log on to ossbrowser. Before you use the AccessKey pair of a RAM user to log on to ossbrowser, you must grant the following permissions to the RAM user: AliyunOSSFullAccess, AliyunRAMFullAccess, and AliyunSTSAssumeRoleAccess. For more information about how to grant the permissions, see Permission management.
        Preset OSS Path If the current account has only permissions to access a specific bucket or a specific path in a bucket, you must specify this parameter in the following format:

        oss://bucketname/path. For example, if you are authorized to access only objects or subdirectories in the examplefolder directory of a bucket named examplebucket, enter oss://examplebucket/examplefolder/.

        If pay-by-requester is enabled for the bucket that you are authorized to access and you are not the bucket owner, select request payer. Otherwise, the AccessDenied error is returned when you access the resources specified by Preset OSS Path. If you select request payer, you are charged the traffic and requests fees that are generated when you access the resources specified by Preset OSS Path. For more information about how to enable pay-by-requester, see Enable pay-by-requester.

        Region If you select Default (Public Cloud) for Endpoint, you must set Region to the bucket in which the resources specified by Preset OSS Path are stored.
        Keep me logged in If you select this option, ossbrowser remains logged on next time you start ossbrowser.
        Remember If you select this option, your AccessKey pair used to log on to ossbrowser is saved. Next time you log on to ossbrowser, click AK Histories and select the saved AccessKey pair instead of entering the AccessKey pair again.
        Warning For security reasons, do not select this option if you use a shared computer.
      • Use an authorization code to log on to ossbrowser

        To authorize other users to temporarily access specific resources in your buckets, you can generate an authorization code that can be used by these users to log on to ossbrowser. The authorization code becomes invalid after it expires. For more information about how to use an authorization code to log on to ossbrowser, see Log on to ossbrowser by using STS tokens.