登录ossbrowser 2.0

更新时间:
复制 MD 格式

This topic describes how to log on to ossbrowser 2.0 and explains the relevant configuration options.

Permissions

Before you log on, ensure your account has the required permissions for ossbrowser 2.0.

  • Alibaba Cloud account: By default, an Alibaba Cloud account has full permissions for all of its resources. No additional permissions are required.

  • RAM user: To log on and view the list of all buckets and objects, a RAM user must have at least the oss:ListBuckets, oss:ListObjects, and oss:GetBucketInfo permissions for all buckets.

  • STS temporary access credential: To log on and view the list of objects in a specific bucket, the STS temporary access credential must have at least the oss:ListObjects and oss:GetBucketInfo permissions for the specified bucket.

  • authorization code: Permissions for an authorization code are configured by an Alibaba Cloud account or a RAM administrator after they log on to ossbrowser 2.0 and perform the File Authorization operation.

After you log on to ossbrowser 2.0 by using a RAM user or an STS temporary access credential, you must also configure the required permission policies for the operations you want to perform. Use the following table to configure permissions based on the required features. For more information about how to create custom policies and grant permissions to a RAM user, see Create custom policies and Manage permissions for RAM users.

Required permissions for features

Feature

Action

Description

Permission recommendation

Log on to ossbrowser 2.0

oss:ListBuckets

Lists all buckets that you own.

If you need to access only a specific bucket, the oss:ListBuckets permission is not required. However, you cannot access the bucket list page.

oss:ListObjects

Lists information about all objects in a bucket.

To access the object list, you must have the oss:ListObjects permission.

oss:GetBucketInfo

Views information about a bucket.

To access a specific bucket by using a preset path, the oss:GetBucketInfo permission is required. If you do not have this permission, you can still access the bucket by manually specifying its region.

Manage buckets

oss:ListBuckets

Lists all buckets that you own.

To view the bucket list, you must have the oss:ListBuckets permission.

oss:PutBucket

Creates a bucket.

To create a bucket, you must have the oss:PutBucket permission.

oss:GetBucketInfo

Views information about a bucket.

To obtain basic information about a bucket, you must have the oss:GetBucketInfo permission.

oss:DeleteBucket

Deletes a bucket.

To delete a bucket, configure the oss:DeleteBucket permission with caution.

Object list

oss:ListObjects

Lists information about all objects in a bucket.

To list objects, you must have the oss:ListObjects permission.

Upload and download

oss:ListObjects

Lists information about all objects in a bucket.

To download a folder, you must have the oss:ListObjects permission.

oss:GetObject

Downloads an object.

To download an object, you must have the oss:GetObject permission.

oss:PutObject

Uploads an object.

To upload an object, you must have the oss:PutObject permission.

Copy, move, and rename

oss:ListBuckets

Lists all buckets that you own.

To copy or move objects across buckets, you must have the oss:ListBuckets permission.

oss:ListObjects

Lists information about all objects in a bucket.

To copy, move, or rename folders, you must have the oss:ListObjects permission.

oss:GetObject

Downloads an object.

The oss:GetObject permission is required for the source bucket.

oss:PutObject

Uploads an object.

The oss:PutObject permission is required for the destination bucket.

oss:DeleteObject

Deletes an object.

When you move or rename an object, the oss:DeleteObject permission is required for the source bucket. Otherwise, the source object cannot be deleted.

oss:GetBucketInfo

Views information about a bucket.

If versioning is enabled for a bucket, ossbrowser 2.0 can only overwrite objects that have the same name. The client calls GetBucketInfo to query the versioning status of the bucket, but this permission is not required. If you do not have this permission and an error message appears, you can close the message to proceed. When versioning is enabled for the bucket, the Skip and Ask conflict policies do not take effect. The objects can only be overwritten.

Delete objects

oss:ListObjects

Lists information about all objects in a bucket.

To delete a directory, you must have the oss:ListObjects permission.

oss:DeleteObject

Deletes an object.

To delete objects, configure the oss:DeleteObject permission with caution.

Part management

oss:ListParts

Lists all successfully uploaded parts that belong to a specific upload ID.

To view parts, you must have the oss:ListParts permission.

oss:ListMultipartUploads

Lists all in-progress multipart upload events. These events are initiated but not yet completed (Complete) or aborted (Abort).

To delete parts, you must have the oss:ListMultipartUploads permission.

Object restoration

oss:RestoreObject

Restores an Archive Storage, Cold Archive, or Deep Cold Archive object.

To restore an object, you must have the oss:RestoreObject permission.

Procedure

  1. Choose a logon method

    ossbrowser 2.0 provides four logon methods, as shown in the following table.

    Logon method

    Description

    AK

    If you are a resource owner, or if team members need long-term access to OSS resources and want to stay logged in for an extended period, we recommend that you use the AccessKey (AK) of an Alibaba Cloud account or a RAM user to log on to ossbrowser 2.0.

    Account

    If you are a resource owner, or if team members need long-term access to OSS resources and require daily security verification, we recommend logging on by scanning a QR code with the Alibaba Cloud app, Alipay, or DingTalk, or by using an Alibaba Cloud account, a RAM user account, or a mobile verification code.

    Important

    The account logon method does not support the File Authorization operation. To perform this operation, use a different logon method.

    Log on with STS

    If a team member needs temporary access to your OSS resources, a RAM user can assume a RAM role to call the STS service and obtain an STS temporary access credential. Other team members can then use this temporary credential to log on and access your OSS resources.

    Auth-Code

    If a team member needs temporary or long-term access to some of your OSS resources, you can log on to ossbrowser 2.0 by using an AccessKey, authorize access to OSS resources, and generate an authorization code. Other team members can then use this authorization code to log on and access the authorized OSS resources.

    Choose a logon method based on your use case.

    AK

    The AK method supports logging on with the AccessKey of an Alibaba Cloud account or a RAM user. For data security, we recommend using a RAM user's AccessKey.

    Log on with an Alibaba Cloud account

    1. Obtain an AccessKey.

      1. Obtain an existing AccessKey: Use the AccessKey ID and AccessKey Secret that you saved locally when you created the AccessKey.

      2. Create an AccessKey: If you have forgotten your AccessKey, go to the Create AccessKey page, click Create AccessKey, and follow the on-screen instructions to create an AccessKey. After the AccessKey is created, click Download CSV File in the dialog box to save it locally. Then, log on with the new AccessKey ID and AccessKey Secret.

    2. Click AK and enter your account's AccessKey ID and AccessKey Secret to log on.

      image

    Log on as a new RAM user

    To create a RAM user, you must use an account that has permissions to manage RAM users, such as an Alibaba Cloud account. Log on to the Alibaba Cloud console and perform the following steps.

    1. Create a RAM user.

      1. Click Create User and follow the console instructions to create a RAM user.

        Note

        For more information, see Create a RAM user.

      2. Click Download CSV File. This file contains the AccessKey required for the RAM user to log on. Keep this file secure.

    2. Grant permissions to the RAM user.

      1. Go to the Users page, select the target user, and then click .

      2. In the search box, copy and add the required permissions for ossbrowser 2.0 operations, AliyunRAMFullAccess, and AliyunSTSAssumeRoleAccess.

        Note

        For more information about RAM user authorization and custom authorization, see Manage permissions for RAM users and Create custom policies.

    3. Click AK and enter the AccessKey ID and AccessKey Secret from the CSV file to log on.

      image

    Log on as an existing RAM user

    1. Obtain an AccessKey.

      1. Obtain an existing AccessKey: Use the AccessKey ID and AccessKey Secret that you saved locally when you created the AccessKey.

      2. Create an AccessKey: If you have forgotten your AccessKey, log on to the Alibaba Cloud console as the target RAM user. Go to the Users page, click the target RAM user, and then click Create AccessKey on the user details page. Follow the on-screen instructions to create an AccessKey. After the AccessKey is created, click Download CSV File in the dialog box to save it locally. Then, log on with the new AccessKey ID and AccessKey Secret.

    2. Confirm OSS authorization.

      1. Go to the Users page, select the target user, and then click Permissions to check whether the user has permissions to manage OSS resources, such as the AliyunOSSFullAccess permission.

      2. If the user does not have permissions to manage OSS resources, click Add Permissions on the user's Permissions page. In the search box, copy and add the AliyunOSSFullAccess, AliyunRAMFullAccess, and AliyunSTSAssumeRoleAccess permissions.

        Note

        For more information about RAM user authorization and custom authorization, see Manage permissions for RAM users and Create custom policies.

    3. Click AK and enter the RAM user's AccessKey ID and AccessKey Secret to log on.

      image

    Account logon

    1. Click Account.

      image

    2. Click to open the Alibaba Cloud Logon Page and select a logon method.image

    STS logon

    Important

    The STS Token text box appears only after you enter an AccessKey ID in the STS.***** format.

    1. Obtain an STS temporary access credential. For more information, see Use an STS temporary access credential to access OSS.

    2. Click AK, and enter the AccessKey ID, AccessKey Secret, and SecurityToken from the temporary access credential to log on.

      image

    Authorization code logon

    1. Obtain an authorization code. For more information, see File Authorization.

    2. Click Auth-Code and enter the obtained authorization code to log on.

      image

  2. Configure an Endpoint

    Important

    You cannot use a CDN domain name to log on to ossbrowser 2.0.

    Endpoint

    Description

    Public endpoint

    If you are using ossbrowser 2.0 from your local computer, select Public Endpoint.

    image

    Internal endpoint

    Use this endpoint on the Alibaba Cloud internal network, for example, from an ECS instance where ossbrowser 2.0 is installed. Select Internal Endpoint. The ECS instance and the target bucket must be in the same region. For more information about how to create an ECS instance, see Create an ECS instance.

    image

    Specified domain name

    Note

    After you log on to the ossbrowser client by using a specified domain name, you cannot switch to another bucket.

    This applies when you log on with a specified domain name. For example, if you enable the transfer acceleration feature, you can enter the Endpoint. For information about how to enable transfer acceleration and obtain an accelerated endpoint, see Use transfer acceleration to access OSS.

    image

    Custom domain name

    This applies to scenarios where you access OSS resources through a custom domain name. You need to enter your own domain name that is bound to OSS. For information about how to bind a custom domain name, see Bind a custom domain name.

    image

    PrivateLink

    Note

    When you log on to the ossbrowser client through a PrivateLink connection, you must specify the target bucket in the preset OSS path. You cannot switch to other buckets while the client is running.

    Use this endpoint for secure and stable private connections from within the Alibaba Cloud internal network, such as from an ECS instance. Ensure that the ECS instance and the endpoint are in the same VPC, and the ECS instance and the target bucket are in the same region.

    Enter the endpoint service domain name. For information about how to create an ECS instance, create an endpoint, and obtain the endpoint service domain name, see Create an ECS instance and Create an endpoint.

    image

    CloudBox

    Note

    After you log on to ossbrowser 2.0 by using a CloudBox endpoint, the File Authorization operation is not supported.

    This applies to scenarios where you access a CloudBox environment. You need to enter the data domain of the CloudBox to log on to ossbrowser 2.0.

    image

  3. Configure a preset OSS path

    If you have permissions for only some resources in a bucket, you must specify the OSS resource path. Examples are as follows:

    1. To access an entire bucket, such as all objects in bucketname.image

    2. To access a directory within a bucket, such as the folder directory in bucketname.

      image

    3. To access a specific object within a bucket, such as the file object in the folder directory of bucketname.

      image

  4. Configure the bucket region

    Important

    If you need to access a specific bucket, configure the preset OSS path before you configure the bucket region.

    Endpoint type

    Configuration method

    Example

    Public Endpoint

    In the upper-right corner of the logon page, click Advanced Settings > Default Region and select the region of the target bucket.

    imageimage

    Internal Endpoint

    Specified Domain

    From the Default Region drop-down list, select the region of the target bucket.

    image

    Custom Domain

    PrivateLink

  5. Verify the result

    After a successful logon, the interface shown in the following figure appears. To quickly get started with ossbrowser 2.0, see Common operations.

    image

Other settings

Parameter

Description

Pay-by-requester

If the bucket you are authorized to access has requester pays mode enabled and you are not the bucket owner, you must select Pay-by-requester. In the upper-right corner of the logon page, click Advanced Settings and enable Pay-by-requester.

Important
  • If the bucket you are authorized to access has the requester pays mode enabled, but you are not the owner and have not selected Pay-by-requester, you will receive an AccessDenied error when you try to access the specified resource under the preset OSS path.

  • After you select Pay-by-requester, you can access the specified resource under the preset OSS path, and you will be charged for the traffic, requests, and other fees incurred from accessing the bucket. For more information about the requester pays mode, see Requester Pays.

Keep Me Logged on

If you select Keep Me Logged on, ossbrowser 2.0 will keep you logged in. The next time you open the client, you will be logged in automatically.

Record Session

If you select Record Session, ossbrowser 2.0 saves the AccessKey. The next time you log on, click AK history to select a saved key and log on directly.

Warning

To avoid unnecessary information security risks, do not select this option on a temporary or shared computer.