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 Operating system Description
    1.16.0 Windows x32 Windows 7 and later are supported.

    If ossbrowser does not run as expected after it is installed, you can refer to What do I do if I cannot run ossbrowser after I install a software on Windows? to troubleshoot the issue.

    Windows x64
    Windows Server (not recommended) If you encounter compatibility issues when you install ossbrowser on Windows Server, build source code on your own to resolve the issues.
    macOS Unverified applications 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 the source code from GitHub and compile the 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:
      • Log on to ossbrowser by using an AccessKey pair

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

        ak

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

        Parameter Description
        Endpoint Select the endpoint of the region that you want to access.
        • Default (Public Cloud): The endpoint of the region in which the bucket to access is located is used to log on to ossbrowser. If you select this value, you can select HTTPS encryption to encrypt data in transit.
          Notice If you select this value, buckets located in the China (Ulanqab) and Philippines (Manila) regions cannot be accessed. To access buckets located in these regions, you must set the value to Customize.
        • Customize: The endpoint of a custom region is used to log on to ossbrowser. Example: oss-cn-wulanchabu.aliyuncs.com. If you select this value, you can use all Object Storage Service (OSS) endpoints for access in the Alibaba Cloud public cloud. For more information about regions and endpoints, see Regions and endpoints.
        • cname: A custom domain name is used to access 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 Obtain an AccessKey pair.
        Notice To ensure data security, we recommend that you log on to ossbrowser by using the AccessKey pair of a RAM user. 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, see Permission management.
        Preset OSS Path If the current account has permissions to access only 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 for the traffic and requests 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 specify the region of 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.
      • Log on to ossbrowser by using an authorization code

        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.