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

Procedure

  1. Download and install ossbrowser.
    Current versionOperating systemDownload URLDescription
    1.16.0Windows x32oss-browser-win-x32.zipWindows 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 piece of software on Windows? to troubleshoot the issue.

    Note We recommend that you do not install ossbrowser on Windows Server. If you encounter compatibility issues when you install ossbrowser on Windows Server, build source code on your own to resolve the issues.
    Windows x64oss-browser-win-x64.zip
    macOSoss-browser-macos-x64.zipUnverified 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)oss-browser-linux-x64.zipIf 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. This example procedure shows how to log on to ossbrowser on Windows.
    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.

        ak

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

        ParameterDescription
        EndpointSelect the endpoint of the region in which the bucket that you want to access is located.
        • Default (Public Cloud): The default endpoint of the region in which the bucket that you want 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.
          Important For regions that do not support access by using this method, you can select Customize for Endpoint.
        • Customize: The specified endpoint of the region in which the bucket that you want to access 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 of the region to access OSS 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, you can use the custom domain name to access the bucket.
        AccessKeyId and AccessKeySecretEnter the AccessKey pair of your account. For more information about how to obtain the AccessKey pair of an Alibaba Cloud account or a RAM user, see Obtain an AccessKey pair.
        Important 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 PathIf 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 in the path 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 in the path specified by Preset OSS Path. For more information about the pay-by-requester feature, see Pay-by-requester.

        RegionIf you select Default (Public Cloud) for Endpoint, you must specify the region of the bucket in which the resources in the path specified by Preset OSS Path are stored.
        Keep me logged inIf you select this option, you remain logged on next time you start ossbrowser.
        RememberIf you select this option, your AccessKey pair used to log on to ossbrowser is remembered. The next time you log on to ossbrowser, click AK Histories and select the remembered 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.

        1. Log on to ossbrowser as an administrator RAM user.
          Important When you log on to ossbrowser by using your Alibaba Cloud account or as an administrator RAM user, some of the features are inaccessible for data security reasons. Use the AccessKey pair of an administrator RAM user to log on to ossbrowser and generate an authorization code. The administrator RAM user must have the bucket or directory management permissions and must be assigned the AliyunRAMFullAccess permissions and the AliyunSTSAssumeRoleAccess permissions.
        2. Select the objects or directories to be temporarily accessed by the authorized users, and choose More > ACL.
        3. Save the obtained authorization code.
        4. Log out of ossbrowser, and then use the authorization code to log on to ossbrowser.