跳转到内容
Multilogin帮助中心

如何在 Postman 中用密码保护浏览器配置文件

在 Multilogin 中,你可以为浏览器配置文件设置密码,限制启动、克隆、移动或更新等操作。多位团队成员使用同一配置文件时,这能帮助你控制谁可以修改它。

➡️ 此功能仅通过 API 提供。要在 Postman 中设置,请前往“Collections” → “Multilogin API” → “Profile Management” → “Set Profile Password”。

你可以选择哪些操作需要配置文件密码,并使用配置文件身份验证令牌授权支持的请求。

谁可以使用此 API 请求?

配置文件密码如何工作

配置文件密码保护允许你选择哪些 API 操作需要额外的身份验证。

为配置文件设置密码后,用户必须先使用该密码完成身份验证,才能执行所选操作。“Log in Profile” API 请求会返回配置文件身份验证令牌,你可以将其用于支持的请求。

只有 restricted 字段中列出的操作需要额外验证。“Profile Move”请求使用另一种方式,下文会说明。

重要:如果不指定任何限制,默认会限制所有支持的操作。

如果只想限制部分操作,请将对应的键加入 restricted 字段。例如,只限制配置文件更新时,使用 profile_update。

密码保护可以限制哪些操作

限制键 API 操作
profile_move Profile Move
profile_clone Profile Clone
profile_start Start Browser Profile
profile_export Profile Export, Cookie Export
profile_update Profile Update, Profile Partial Update
profile_data_change Cookie Import

开始之前

你需要准备:

  • API 令牌或自动化令牌:用于验证发送到 Multilogin API 的请求。在 Postman 的“Authorization” → “Bearer Token”中填写。
  • 配置文件身份验证令牌:用于授权受密码保护的配置文件上的指定操作。通过“Log in Profile”生成,并在需要时放入 X-Profile-Authentication 请求头。
  • 要保护的浏览器配置文件 ID
  • 已导入 Multilogin API 集合的 Postman

如果还没准备好,请参阅:

使用 API 令牌或自动化令牌授权 Postman 请求。部分受保护的操作还需要单独的配置文件身份验证令牌。

如何设置密码

第 1 步:找到 API 请求

  1. 前往“Collections” → “Multilogin API”文件夹
  2. 打开“Profile Management”文件夹
  3. 打开 POST Set Profile Password,配置请求
Postman Profile Management 中选中 Set Profile Password 请求,并打开 Params 标签页。
  1. 从“Params”选项卡切换到“Authorization”
  2. 将“Auth Type”设为“Bearer Token”
  3. 在右侧“Token”字段中粘贴之前复制的 API 令牌
Postman Set Profile Password 请求,Authorization 中已选择 Bearer Token。

第 2 步:复制配置文件 ID

参阅如何复制 Multilogin 配置文件 ID。设置密码保护时需要这个 ID。

第 3 步:编辑并发送请求

  1. 打开“Body”选项卡,编辑参数:
    1. profile_id:上一步复制的配置文件 ID
    2. password:配置文件密码。至少包含 7 个字符,其中至少有一个大写字母、一个数字和一个特殊字符
    3. confirm_password:再次输入同一密码
    4. restricted: 
      1. profile_move:限制将配置文件移动到其他文件夹,对应 POST Profile Move
      2. profile_clone:对应 POST Profile Clone
      3. profile_start:对应 GET Start Browser Profile
      4. profile_export:对应 POST Profile Export 和 POST Cookie Export
      5. profile_update:对应 POST Profile Update 和 POST Profile Partial Update
      6. profile_data_change:限制导入 Cookie。对应 POST Cookie Import 

        你可以自行选择要限制的操作。例如,只想限制配置文件更新时,在 restricted 中保留 profile_update 即可。如果清空整个 restricted 列表,默认会启用所有限制。

  2. 点击“Send”
Postman Set Profile Password 的 JSON 请求体,显示 profile_id、password、confirm_password 和 restricted 操作键。

如何获取配置文件身份验证令牌

设置密码后,你和使用该配置文件的其他用户需要生成与密码关联的专用令牌。操作如下。

第 1 步:找到 API 请求

  1. 前往“Collections” → “Multilogin API”文件夹
  2. 打开“Profile Management”文件夹
  3. 打开 POST Log in Profile,配置请求
Postman Profile Management 中选中 Log In Profile 请求,并打开 Params 标签页。
  1. 从“Params”选项卡切换到“Authorization”
  2. 将“Auth Type”设为“Bearer Token”
  3. 在右侧“Token”字段中粘贴之前复制的 API 令牌
Postman Log In Profile 请求,Authorization 中已选择 Bearer Token。

第 2 步:复制配置文件 ID

参阅如何复制 Multilogin 配置文件 ID。获取令牌时需要配置文件 ID,生成的令牌仅关联该配置文件。

第 3 步:编辑并发送请求

  1. 打开“Body”选项卡,编辑参数:
    1. password:你或其他用户通过 POST Set Profile Password 设置的配置文件密码
    2. profile_id:上一步复制的配置文件 ID
  2. 点击“Send”
Postman Log In Profile 的 JSON 请求体,标出 password 和 profile_id。

第 4 步:从响应正文复制令牌

复制完整令牌,不要包含两侧的引号。对受密码保护的配置文件发送请求时,需要使用这个令牌。

Postman 配置文件登录响应,突出显示生成的身份验证令牌。

如何对受密码保护的配置文件发送请求

设置密码并通过“Log in Profile”获取令牌后,就可以执行受限制的 API 请求。不是所有接口都需要这个令牌,只有 restricted 中指定的操作需要。支持的操作如下:

  • POST Profile Move
  • POST Profile Clone
  • GET Start Browser Profile
  • POST Profile Update
  • POST Profile Partial Update 
  • POST Cookie Export
  • POST Cookie Import
  • POST Profile Export

POST Profile Move 的操作方式不同,详见后文。

第 1 步:找到要运行的 API 请求

从上面的列表中选择要使用的接口。本文以 GET Start Browser Profile 为例。其他请求的位置、参数和接口地址可能不同。

第 2 步:编辑请求参数

本例请按照如何使用 Postman 启动 Multilogin 配置文件中的“开始之前”步骤操作。

第 3 步:添加配置文件身份验证请求头

  1. 复制如何获取配置文件身份验证令牌一节中的令牌
  2. 打开“Headers”选项卡,点击空白的“Key”字段
Postman Start Browser Profile 请求,突出显示用于新增请求头的空白 Key 行。
  1. 在“Key”字段中输入 X-Profile-AuthenticationPostman Start Browser Profile 请求,突出显示 X-Profile-Authentication 请求头键。
  1. 在“Value”字段中输入 Bearer ,后接你的配置文件身份验证令牌。
Postman Start Browser Profile 请求,X-Profile-Authentication 中已填入身份验证令牌。

第 4 步:点击“Send”

完成准备后,即可向受密码保护的配置文件发送请求。

如何运行 Profile Move 请求

POST Profile Move 的处理方式与其他接口基本相同,但请求正文有所不同。

第 1 步:将默认请求正文替换为适用于密码保护的版本

  1. POST Profile Move 的默认请求正文如下:
Postman Profile Move 的 JSON 请求体,包含 dest_folder_id 和 ids 数组。
  1. 将其替换为包含 password 参数的请求正文。你可以参阅 API 文档,也可以复制下面的示例:
    {
        "dest_folder_id": "{{FolderCreateID}}",
        "profiles": [
            {
                "profile_id": "{{ProfileMimic}}",
                "password": "{{ProfilePassword}}"
            }
        ]
    }
  1. 替换以下参数值:
    1. dest_folder_id:目标文件夹 ID。获取方法见如何在 DevTools 中获取配置文件、文件夹和工作区 ID
    2. profile_id:之前获取的配置文件 ID
    3. password:为配置文件设置的密码
Postman Profile Move 的 JSON 请求体,包含 dest_folder_id,以及含 profile_id 和 password 的 profiles。

第 2 步:点击“Send”

如果配置正确,配置文件会移动到目标文件夹。

此请求不需要配置文件身份验证令牌。

如何移除密码

如果不再需要密码保护,可以按以下步骤移除密码。

第 1 步:找到 API 请求

按如何对受密码保护的配置文件发送请求中查找请求的方式操作。本次使用的 POST Remove Password 位于“Profile Management”文件夹。

第 2 步:编辑请求参数

填写配置文件 ID。获取方法见如何复制 Multilogin 配置文件 ID。

Postman Remove Password 请求,显示 JSON 请求体中的 profile_ids 数组。

第 3 步:添加令牌并发送请求

  1. 从“Params”选项卡切换到“Authorization”
  2. 将“Auth Type”设为“Bearer Token”
  3. 在右侧“Token”字段中粘贴 API 令牌
  1. 添加 X-Profile-Authentication 请求头,值为 Bearer 后接配置文件身份验证令牌,然后点击“Send”
Postman Remove Password 请求,显示 JSON 请求体中的 profile_ids 数组。

常见问题

为什么 Postman 返回“Wrong JWT token”?

普通 API 令牌可能已过期或不正确。普通 API 令牌在 30 分钟后过期。

获取新令牌或使用有效的自动化令牌,然后检查“Authorization” → “Bearer Token”。

为什么会出现“Missing authorization header”?

检查是否已在“Authorization” → “Bearer Token”中填写普通 API 令牌。

对于需要配置文件身份验证的请求,还要检查 X-Profile-Authentication 请求头。

为什么无法执行受限制的操作?

检查配置文件 ID 是否正确、你的工作区角色是否允许该操作,以及是否已提供所需的配置文件身份验证信息。

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区