Tính năng bảo vệ hồ sơ bằng mật khẩu trong Multilogin cho phép bạn hạn chế các thao tác trên hồ sơ trình duyệt, chẳng hạn như khởi động, nhân bản, di chuyển hoặc cập nhật. Nhờ đó, bạn dễ kiểm soát các thay đổi khi nhiều thành viên trong nhóm cùng làm việc trên một hồ sơ.

➡️ Tính năng này chỉ có qua API. Để thiết lập trong Postman, vào “Collections” → “Multilogin API” → “Profile Management” → “Set Profile Password”.

Bạn có thể chọn thao tác nào cần mật khẩu hồ sơ và dùng token xác thực hồ sơ để ủy quyền cho các yêu cầu được hỗ trợ.

Mật khẩu hồ sơ hoạt động như thế nào

Bảo vệ bằng mật khẩu cho phép bạn chọn thao tác API nào cần xác thực thêm.

Khi bạn bảo vệ một hồ sơ, người dùng phải xác thực bằng mật khẩu của hồ sơ trước khi thực hiện các thao tác đã chọn. Yêu cầu “Log in Profile” trả về token xác thực hồ sơ để bạn đưa vào các yêu cầu được hỗ trợ.

Chỉ những thao tác được chọn trong trường restricted mới cần xác thực thêm này. Yêu cầu “Profile Move” dùng cách khác, được mô tả bên dưới.

Quan trọng: nếu bạn không chỉ định hạn chế nào, tất cả thao tác được hỗ trợ sẽ bị hạn chế theo mặc định.

Để chỉ hạn chế một số thao tác nhất định, hãy thêm khóa của chúng vào trường restricted. Ví dụ, dùng profile_update nếu bạn chỉ muốn hạn chế việc cập nhật hồ sơ.

Mật khẩu hồ sơ hạn chế những thao tác nào

Trước khi bắt đầu

Bạn cần có:

• API token hoặc token tự động hóa: xác thực yêu cầu của bạn gửi tới Multilogin API. Trong Postman, nhập token ở “Authorization” → “Bearer Token”.
• Token xác thực hồ sơ: ủy quyền cho các thao tác đã chọn trên hồ sơ được bảo vệ bằng mật khẩu. Tạo token bằng “Log in Profile”, sau đó đưa vào header X-Profile-Authentication khi cần.
• ID của hồ sơ trình duyệt bạn muốn bảo vệ
• Postman có bộ sưu tập Multilogin API

Nếu bạn chưa có những thứ này, hãy làm theo các hướng dẫn sau:

• Cách lấy API token Multilogin
• Cách lấy mã tự động hóa Multilogin của bạn
• Cách sao chép ID của trình duyệt và hồ sơ di động

Bạn sẽ dùng API token hoặc token tự động hóa để ủy quyền các yêu cầu trong Postman. Một số thao tác được bảo vệ còn cần thêm một token xác thực hồ sơ riêng.

Cách đặt mật khẩu

Bước 1: tìm yêu cầu API

1. Vào thư mục “Collections” → “Multilogin API”
2. Vào thư mục “Profile Management”
3. Mở POST Set Profile Password để cấu hình yêu cầu

4. Ở tab “Params”, chuyển đến “Authorization”
5. Chọn “Bearer Token” làm Auth Type
6. Trong trường “Token” ở bên phải, dán API token bạn đã sao chép trước đó

Bước 2: sao chép ID hồ sơ

Xem thông tin trong bài viết: Cách sao chép ID của trình duyệt và hồ sơ di động. Bạn cần ID này để bảo vệ hồ sơ.

Bước 3: chỉnh sửa yêu cầu và gửi đi

1. Mở tab “Body” và chỉnh sửa các tham số:
   1. profile_id: ID của hồ sơ bạn đã sao chép ở bước trước
   2. password: mật khẩu của hồ sơ. Mật khẩu cần có ít nhất 7 ký tự, trong đó có ít nhất một chữ hoa, một số và một ký tự đặc biệt
   3. confirm_password: nhập lại đúng mật khẩu đó
   4. restricted: 
      1. profile_move: hạn chế tùy chọn di chuyển hồ sơ sang thư mục khác. Liên quan đến yêu cầu POST Profile Move
      2. profile_clone: liên quan đến POST Profile Clone
      3. profile_start: liên quan đến GET Start Browser Profile
      4. profile_export: liên quan đến POST Profile Export và POST Cookie Export
      5. profile_update: liên quan đến POST Profile Update và POST Profile Partial Update
      6. profile_data_change: hạn chế việc nhập cookie. Liên quan đến POST Cookie Import 
         

         Bạn tự chọn thao tác nào cần chặn. Ví dụ, nếu chỉ muốn chặn việc cập nhật hồ sơ, bạn chỉ cần thêm tùy chọn profile_update và bỏ các tùy chọn còn lại. Nhưng nếu bạn xóa hết mọi thứ trong mục “restricted”, tất cả hạn chế sẽ được bật theo mặc định.

          
2. Nhấp vào “Send”

Cách nhận token xác thực hồ sơ

Sau khi đặt mật khẩu, bạn (và những người khác mà bạn chia sẻ hồ sơ) cần tạo một token riêng gắn với mật khẩu đó. Làm theo các bước dưới đây. 

Bước 1: tìm yêu cầu API

1. Vào thư mục “Collections” → “Multilogin API”
2. Vào thư mục “Profile Management”
3. Mở POST Log in Profile để cấu hình yêu cầu

4. Ở tab “Params”, chuyển đến “Authorization”
5. Chọn “Bearer Token” làm Auth Type
6. Trong trường “Token” ở bên phải, dán API token bạn đã sao chép trước đó
    

Bước 2: sao chép ID hồ sơ

Xem thông tin trong bài viết: Cách sao chép ID của trình duyệt và hồ sơ di động. Bạn cần ID hồ sơ để lấy token, vì token gắn với đúng hồ sơ đó.

Bước 3: chỉnh sửa yêu cầu và gửi đi

1. Mở tab “Body” và chỉnh sửa các tham số:
   1. password: mật khẩu của hồ sơ, tức là mật khẩu bạn (hoặc người dùng khác) đã đặt trong yêu cầu POST Set Profile Password
   2. profile_id: ID của hồ sơ bạn đã sao chép ở bước trước
2. Nhấp vào “Send”

Bước 4: sao chép token từ phần thân phản hồi

Sao chép toàn bộ token, trừ dấu ngoặc kép. Đó chính là token của bạn. Bạn sẽ cần nó để thực hiện các yêu cầu trên hồ sơ được bảo vệ bằng mật khẩu.

Cách thực hiện yêu cầu trên hồ sơ được bảo vệ bằng mật khẩu

Sau khi đặt mật khẩu và nhận token từ yêu cầu Log in Profile, bạn có thể thực hiện một số yêu cầu API “nhạy cảm”. Không phải yêu cầu nào cũng cần token, chỉ những yêu cầu trong danh sách “restricted” mới cần. Danh sách như sau:

• 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

Bước 1: tìm yêu cầu API bạn muốn thực hiện

Chọn trong danh sách trên yêu cầu bạn muốn dùng. Trong hướng dẫn này, chúng tôi dùng yêu cầu GET Start Browser Profile làm ví dụ. Vị trí của yêu cầu, tham số và giá trị trên thanh endpoint có thể khác. 

Bước 2: chỉnh sửa giá trị trong yêu cầu

Trong trường hợp này, hãy làm theo các bước ở mục “Trước khi bắt đầu” trong bài viết: Bắt đầu một hồ sơ với Postman.

Bước 3: thêm header chứa token xác thực hồ sơ

1. Sao chép token được nhắc đến ở mục Cách nhận token xác thực hồ sơ
2. Mở tab “Header” và nhấp vào ô Key trống

3. Điền giá trị sau vào ô Key trống: X-Profile-Authentication
   

4. Điền token của bạn vào ô “Value”. 

Bước 4: nhấp vào “Send”

Sau khi chuẩn bị xong, bạn có thể thực hiện yêu cầu trên hồ sơ được bảo vệ bằng mật khẩu.

Cách thực hiện yêu cầu Profile Move

POST Profile Move — cách xử lý yêu cầu này gần giống các yêu cầu khác, trừ một điểm khác ở phần thân yêu cầu. 

Bước 1: thay phần thân yêu cầu mặc định bằng phần thân có mật khẩu

1. POST Profile Move — phần thân yêu cầu sẽ trông như thế này:
    

2. Hãy thay bằng phần thân yêu cầu khác có tham số password. Bạn có thể xem phần thân yêu cầu trong tài liệu API hoặc sao chép từ khung bên dưới:

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

1. Thay giá trị của các tham số:
   1. dest_folder_id: ID thư mục bạn muốn chuyển hồ sơ đến. Bạn có thể lấy ID này theo bài viết: Cách lấy ID hồ sơ, thư mục và không gian làm việc trong DevTools
   2. profile_id: chính ID của hồ sơ, bạn đã lấy ở bước trước
   3. password: mật khẩu bạn đã dùng để bảo vệ hồ sơ 

Bước 2: nhấp vào “Send” 

Nếu bạn cấu hình đúng, hồ sơ sẽ được chuyển sang thư mục khác.

Cách xóa mật khẩu 

Nếu không cần bảo vệ hồ sơ nữa, bạn có thể xóa mật khẩu. Cách làm như sau. 

Bước 1: tìm yêu cầu API 

Bước này giống Bước 2 trong bài Cách thực hiện yêu cầu trên hồ sơ được bảo vệ bằng mật khẩu. Lần này, yêu cầu POST Remove Password nằm trong thư mục “Profile Management”.

Bước 2: chỉnh sửa giá trị trong yêu cầu

Thêm ID hồ sơ của bạn. Bạn có thể lấy ID này theo bài viết: Cách sao chép ID của trình duyệt và hồ sơ di động.

Bước 3: thêm API token và nhấp vào “Send”

1. Ở tab “Params”, chuyển đến “Authorization”
2. Chọn “Bearer Token” làm Auth Type
3. Trong trường “Token” ở bên phải, dán API token của bạn

1. Nhấp vào “Send”

FAQ

Tại sao Postman trả về “Wrong JWT token”?

API token thông thường của bạn có thể đã hết hạn hoặc không đúng. API token thông thường hết hạn sau 30 phút.

Hãy lấy token mới hoặc dùng token tự động hóa còn hiệu lực, rồi kiểm tra “Authorization” → “Bearer Token”.

Tại sao tôi nhận được “Missing authorization header”?

Kiểm tra xem API token thông thường đã có trong “Authorization” → “Bearer Token” chưa.

Với các yêu cầu cần xác thực hồ sơ, hãy kiểm tra thêm header X-Profile-Authentication.

Tại sao tôi không thể thực hiện thao tác bị hạn chế?

Hãy kiểm tra xem bạn đang dùng đúng ID hồ sơ, vai trò trong không gian làm việc có cho phép thao tác đó không và bạn đã đưa vào thông tin xác thực hồ sơ cần thiết.