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

        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 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): Use the endpoint of the region in which the current bucket is located to log on to ossbrowser.

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

        • Customize: Use the endpoint of another region to log on to ossbrowser. Example: https://oss-cn-beijing.aliyuncs.com. For more information about regions and endpoints, see Regions and endpoints.
        • cname: Use a custom domain name 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 log on to ossbrowser by using the AccessKey pair of a Resource Access Management (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 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 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.