在 Multilogin 中，配置文件密码保护可以限制对浏览器配置文件的操作，例如启动、克隆、移动或更新。多位团队成员使用同一批配置文件时，这样更便于你控制改动。

➡️ 此功能仅支持通过 API 使用。要在 Postman 中设置，请依次进入“Collections” → “Multilogin API” → “Profile Management” → “Set Profile Password”。

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

配置文件密码是如何工作的

密码保护让你选择哪些 API 操作需要额外验证。

配置文件密码保护启用后，用户需要先用该配置文件的密码完成验证，才能执行所选操作。“Log in Profile” API 请求会返回配置文件验证令牌，你可以把它加到受支持的请求中。

只有在 restricted 字段中选择的操作才需要这项额外验证。“Profile Move”请求使用另一种方式，详见下文。

重要：如果你没有指定任何限制，默认会限制所有受支持的操作。

如果只想限制部分操作，请把对应的键添加到 restricted 字段中。例如，只想限制配置文件更新时，使用 profile_update。

密码保护会限制什么

开始之前

你需要准备:

• API 令牌或自动化令牌：用于验证你发送到 Multilogin API 的请求。在 Postman 中，把它填入“Authorization” → “Bearer Token”。
• 配置文件验证令牌：用于授权对受密码保护的配置文件执行所选操作。请通过“Log in Profile”生成，并在需要时将其加入 X-Profile-Authentication 请求头。
• 你要保护的浏览器配置文件的 ID
• 带有 Multilogin API 集合的 Postman

如果还没有这些，请参考以下指南：

• 如何获取 Multilogin API 令牌
• 如何获取您的 Multilogin 自动化令牌
• 如何在Multilogin中复制配置文件ID

你将使用 API 令牌或自动化令牌来授权 Postman 中的请求。某些受保护的操作还需要单独的配置文件验证令牌。

如何设置密码

步骤 1：找到 API 请求

1. 打开“Collections” → “Multilogin API”文件夹
2. 打开“Profile Management”文件夹
3. 打开 POST Set Profile Password 来配置要发送的请求

4. 在“Params”标签页中，进入“Authorization”
5. 将 Auth Type 选为“Bearer Token”
6. 在右侧的“Token”字段中，粘贴你之前复制的 API 令牌

步骤 2：复制配置文件 ID

请参考这篇文章中的内容：如何在Multilogin中复制配置文件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 
         

         你可以自行选择要阻止哪些操作。例如，只想阻止配置文件更新，只需添加 profile_update 选项，其余的不用写。但如果你清空“restricted”部分，所有限制都会默认开启。

          
2. 点击“Send”

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

设置密码后，你（以及你要与之共享配置文件的其他用户）需要生成一个与该密码关联的专用令牌。具体操作如下。

步骤 1：找到 API 请求

1. 打开“Collections” → “Multilogin API”文件夹
2. 打开“Profile Management”文件夹
3. 打开 POST Log in Profile 来配置请求

4. 在“Params”标签页中，进入“Authorization”
5. 将 Auth Type 选为“Bearer Token”
6. 在右侧的“Token”字段中，粘贴你之前复制的 API 令牌
    

步骤 2：复制配置文件 ID

请参考这篇文章中的内容：如何在Multilogin中复制配置文件ID。你需要配置文件 ID 才能获取令牌，因为令牌与该配置文件绑定。

步骤 3：编辑请求并发送

1. 打开“Body”标签页，编辑以下参数：
   1. password：配置文件的密码，也就是你（或其他用户）在 POST Set Profile Password 请求中设置的那个密码
   2. profile_id：你在上一步复制的配置文件 ID
2. 点击“Send”

步骤 4：从响应体中复制令牌

复制令牌中除引号以外的全部内容，这就是你的令牌。对受密码保护的配置文件执行请求时需要用到它。

如何对受密码保护的配置文件执行请求

设置密码并通过 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

步骤 1：找到你要执行的 API 请求

从上面的列表中选择你要使用的请求。本指南以 GET Start Browser Profile 请求为例。请求的位置、参数和地址栏中的值可能有所不同。

步骤 2：编辑请求中的值

这里请按照这篇文章“开始之前”部分的步骤操作：如何使用 Postman 启动浏览器配置文件。

步骤 3：添加配置文件验证令牌请求头

1. 复制以下章节中提到的令牌：如何获取配置文件验证令牌
2. 进入“Header”标签页，点击空的 Key 值

3. 在空的 Key 字段中填入以下值：X-Profile-Authentication
   

4. 在“Value”字段中填入你的令牌。

步骤 4：点击“Send”

准备就绪后，就可以对受密码保护的配置文件执行请求了。

如何执行 Profile Move 请求

POST Profile Move 请求的处理方式与其他请求基本相同，只是请求体有一点不同。

步骤 1：把默认请求体替换为带密码的请求体

1. POST Profile Move 请求体大致如下：
    

2. 请替换成另一个请求体，其中包含 password 参数。你可以在 API 文档 中查看请求体，也可以从下面的表单复制粘贴：

   {
       "dest_folder_id": "{{FolderCreateID}}",
       "profiles": [
           {
               "profile_id": "{{ProfileMimic}}",
               "password": "{{ProfilePassword}}"
           }
       ]
   }

3. 替换这些参数的值：
   1. dest_folder_id：你要把配置文件转移到的文件夹 ID。可参考这篇文章获取：如何在DevTools中获取配置文件、文件夹和工作区ID
   2. profile_id：配置文件本身的 ID，即你在上一步获得的 ID
   3. password：你为保护配置文件设置的密码

步骤 2：点击“Send”

如果配置都正确，配置文件就会被移动到另一个文件夹。

如何移除密码

如果不再需要保护配置文件，你可以移除密码。操作如下。

步骤 1：找到 API 请求

此步骤与以下文章中的步骤 2 相同：如何对受密码保护的配置文件执行请求。这里要用的请求是 POST Remove Password，位于“Profile Management”文件夹中。

步骤 2：编辑请求中的值

添加你的配置文件 ID。可参考这篇文章获取：如何在Multilogin中复制配置文件ID。

步骤 3：添加 API 令牌并点击“Send”

1. 在“Params”标签页中，进入“Authorization”
2. 将 Auth Type 选为“Bearer Token”
3. 在右侧的“Token”字段中，粘贴你的 API 令牌

4. 点击“Send”

FAQ

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

你的常规 API 令牌可能已过期或不正确。常规 API 令牌会在 30 分钟后过期。

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

为什么我会看到“Missing authorization header”？

请确认常规 API 令牌已填入“Authorization” → “Bearer Token”。

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

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

请确认你使用了正确的配置文件 ID，同时请确认你在你工作空间里的角色允许该操作，并且已加入所需的配置文件验证凭据。