You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
TOS Browser
Logging in to TOS Browser
Copy page
Download PDF
Logging in to TOS Browser
This topic uses macOS to illustrate how to log in to TOS Browser.​
Prerequisites​
Logging in to TOS Browser with AK/SK or STS temporary credentials​
  1. After installation, open the login screen by double-clicking the TOS Browser icon.​
  1. On the AK Log in tab, enter your login information, and then click Log in. The parameters are described below.​
  • ​
    Parameter​
    Required​
    Description​
    Endpoint​
    Yes​
    The endpoint to which you want to log in. Options:​
    • Public cloud (Default): Uses the access domain of TOS public services. HTTPS encryption is selected by default when the Public cloud option is selected.​
    • Custom: Uses a custom domain name to log in. For more information on TOS endpoints, see Regions and endpoints.​
    HTTPS encryption​
    No​
    When Endpoint is set to Public cloud, HTTPS encryption is selected by default to secure the transmission of data.​
    Access Key ID​
    Yes​
    The access key ID (AK) of your account.​
    Secret Access Key​
    Yes​
    The secret access key (SK) of your account.​
    tip​
    For instructions on how to view the AK and SK, see Viewing the Access Key ID and Secret Access Key.​
    STS Token​
    No​
    Security Token Service (STS) token.​
    tip​
    When logging into TOS Browser with only temporary STS credentials, you must enter the STS token. For more information, see Accessing TOS with temporary credentials of Security Token Service.​
    Access path​
    No​
    A direct path to the corresponding resource. Filling in the path allows you to quickly navigate to the resource. Format: tos://bucket/folder/.​
    • If your AK has permissions for all buckets, the access path is optional.​
    • If your AK only has permissions for a specific bucket or a path within a bucket, however, the access path is required.​
    Remarks​
    No​
    Remarks for a login session, which makes account management easier. The details are as follows:​
    • It supports up to 30 characters.​
    • It cannot start with a hyphen (-).​
    • If left blank, it defaults to -.​
    Automatically log in​
    No​
    When this option is selected, TOS Browser will log you in automatically next time.​
    Remember the key​
    No​
    When this option is selected, TOS Browser will record your key information.​
    danger​
    Avoid selecting this option on temporary computers to prevent key leakage and other risks.​
    Historical session​
    No​
    TOS Browser keeps track of your session history, including your access paths, public cloud endpoints, custom endpoints, and access key IDs. Click Historical session to view this information in the Historical session dialog. Specifically:​
    • Up to 100 AK entries can be saved in the session history, with up to 500 access path entries saved under each AK.​
    • Click Use to return to the login screen with the corresponding information automatically filled in.​
    • If you modify the information on the login screen and log in, the information in the session history will update automatically.​
    • Click the edit icon in the Remarks column to edit the remarks.​
    • Click Delete, and confirm the deletion by clicking Delete in the box that appears.​
    ​
Logging in to TOS Browser with an account​
You can log in to TOS Browser with your account. Once logged in, you will have permissions for the associated objects and folders.​
warning​
Your TOS Browser account login session lasts 12 hours. After this time, you will be automatically logged out. This may interrupt any ongoing tasks. If you need to run tasks for an extended period, consider logging in to TOS Browser with AK/SK.​
  1. After installation, open the login screen by double-clicking the TOS Browser icon.​
  1. On the TOS Browser login screen, click the Account log in tab, and then click Log In.​
  1. By default, your browser will open the Volcano Engine console login page. Enter your account name and password on that page and click Sign in.​
  • After you log in to the Volcano Engine console, TOS Browser will automatically retrieve your account information and log you in.​
tip​
If you close the browser while logging in, click Restart browser log in in TOS Browser to reopen the login page. Alternatively, you can click Cancel Log in and log in to TOS Browser again using your account.​
Logging in to TOS Browser with a share link​
You must obtain the share link before logging in to TOS Browser with it.​
warning​
  • Once you log in to TOS Browser using a share link, you will only have read access to the corresponding object or folder.​
  • Login information for share links will not be saved in the session history.​
  • You can create share links through the console or TOS Browser. For instructions, see the Sharing objects and Sharing folders sections in Basic object operations.​
  1. After installation, open the login screen by double-clicking the TOS Browser icon.​
  1. On the TOS Browser login screen, click the Share link log in tab.​
  1. Enter a share link and click Log in.​
  • After logging in with a share link, you can select multiple objects and click Download to download them in bulk. You can also click One click download all to download all objects.​
Logging in to TOS Browser with an authorization code​
You must obtain the authorization code before logging in to TOS Browser with it.​
tip​
  • Authorization codes allow you to read and write to specific objects or folders. Compared to share links, authorization codes provide more flexible and precise control over permissions. For more information, see Creating an authorization code.​
  • Login information for authorization codes will not be saved in the session history.​
  1. After installation, open the login screen by double-clicking the TOS Browser icon.​
  1. On the TOS Browser login screen, click the Auth code log in tab.​
  1. Enter an authorization code and click Log in.​
Switching between sessions and languages​
​
Switching between sessions
Changing the language
​
Follow the steps below to switch between sessions.​
  1. Click the ​​ icon in the upper-right corner.​
  1. In the box that appears, click Switch session.​
  1. In the Switch session dialog, click Switch in the Actions column to switch to the corresponding session.​
​
Using an HTTP proxy​
If the server sits behind a private network and external access must go through a unified gateway, you will need an HTTP proxy to access TOS. Follow the steps below to use an HTTP proxy in TOS Browser:​
  1. After installation, open the login screen by double-clicking the TOS Browser icon.​
  1. On the TOS Browser login screen, click the ​​ icon in the upper-right corner.​
  1. In the Settings dialog, click System settings.​
  1. Set Proxy Configuration to Custom proxy, enter the Proxy address and Proxy port, and then click Save.​
  1. In the Prompt dialog, click Restart immediately to apply the proxy settings.​
​
Last updated: 2026.03.18 18:48:57