Защита профиля паролем в Multilogin позволяет ограничить действия с браузерными профилями: например, запуск, клонирование, перемещение или обновление. Так вам проще контролировать изменения, когда с одними и теми же профилями работают несколько участников команды.

➡️ Эта функция доступна только через API. Чтобы настроить ее в Postman, откройте «Collections» → «Multilogin API» → «Profile Management» → «Set Profile Password».

Вы сами можете выбрать, для каких действий нужен пароль профиля, и можете использовать токен аутентификации профиля, чтобы авторизовать поддерживаемые запросы.

Как работает пароль профиля

Защита паролем позволяет выбрать, для каких действий через API нужна дополнительная аутентификация.

Если профиль защищен, перед выбранными действиями нужно ввести его пароль. Запрос «Log in Profile» возвращает токен аутентификации профиля — его можно добавлять в поддерживаемые запросы.

Дополнительная аутентификация нужна только для действий, указанных в поле restricted. Запрос «Profile Move» работает иначе — подробности ниже.

Важно: если вы не указали ограничения, по умолчанию ограничиваются все поддерживаемые действия.

Чтобы ограничить только определенные действия, добавьте их ключи в поле restricted. Например, укажите profile_update, если хотите ограничить только обновление профиля.

Что ограничивает защита паролем

Перед началом

Вам понадобятся:

• API-токен или токен автоматизации: подтверждает ваши запросы к Multilogin API. В Postman введите его в «Authorization» → «Bearer Token».
• Токен аутентификации профиля: авторизует выбранные действия с профилем, защищенным паролем. Создайте его через «Log in Profile», а затем при необходимости добавьте в заголовок X-Profile-Authentication.
• ID браузерного профиля, который вы хотите защитить.
• Postman с коллекцией Multilogin API.

Если чего-то из этого еще нет, воспользуйтесь этими инструкциями:

• Как получить API-токен Multilogin
• Как получить токен автоматизации Multilogin
• Как скопировать ID браузерного профиля и облачного телефона

Для авторизации запросов в Postman вы будете использовать API-токен или токен автоматизации. Для некоторых защищенных действий также нужен отдельный токен аутентификации профиля.

Как задать пароль

Шаг 1: найдите API-запрос

1. Откройте папку «Collections» → «Multilogin API».
2. Откройте папку «Profile Management».
3. Откройте запрос POST Set Profile Password, чтобы его настроить.

4. На вкладке «Params» перейдите в «Authorization».
5. Выберите «Bearer Token» в качестве Auth Type.
6. В поле «Token» справа вставьте скопированный ранее API-токен.

Шаг 2: скопируйте ID профиля

Подробнее — в статье Как скопировать 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 
         

         Вы сами решаете, какие действия блокировать. Например, если нужно заблокировать только обновление профиля, добавьте параметр profile_update и не указывайте остальные. Но если убрать все из раздела «restricted», по умолчанию включатся все ограничения.

          
2. Нажмите «Send»

Как получить токен аутентификации профиля

После того как вы задали пароль, вам (и другим пользователям, с которыми вы делитесь профилем) нужно создать специальный токен, привязанный к этому паролю. Вот как это сделать. 

Шаг 1: найдите API-запрос

1. Откройте папку «Collections» → «Multilogin API».
2. Откройте папку «Profile Management».
3. Откройте запрос POST Log in Profile, чтобы его настроить.

4. На вкладке «Params» перейдите в «Authorization».
5. Выберите «Bearer Token» в качестве Auth Type.
6. В поле «Token» справа вставьте скопированный ранее API-токен.
    

Шаг 2: скопируйте ID профиля

Подробнее — в статье Как скопировать ID профилей в Multilogin. 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: измените значения в запросе

В нашем случае выполните шаги из раздела «Перед началом» в статье Как открыть профиль Multilogin в 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}}"
           }
       ]
   }

1. Замените значения параметров:
   1. dest_folder_id: ID папки, в которую вы хотите переместить профиль. Как его найти — в статье Как получить ID профилей, папок и проектов в DevTools
   2. profile_id: ID самого профиля, который вы получили на предыдущем шаге.
   3. password: пароль, который вы использовали для защиты профиля. 

Шаг 2: нажмите «Send» 

Если вы все настроили правильно, профиль переместится в другую папку.

Как удалить пароль 

Если защита профиля вам больше не нужна, пароль можно удалить. Вот как это сделать. 

Шаг 1: найдите API-запрос 

Этот шаг такой же, как шаг 2 в статье Как выполнить запрос для профиля с защитой паролем. В этом случае запрос POST Remove Password находится в папке «Profile Management».

Шаг 2: измените значения в запросе

Добавьте ID профиля. Как его найти — в статье Как скопировать ID профилей в Multilogin.

Шаг 3: добавьте API-токен и нажмите «Send»

1. На вкладке «Params» перейдите в «Authorization».
2. Выберите «Bearer Token» в качестве Auth Type.
3. В поле «Token» справа вставьте свой API-токен.

1. Нажмите «Send».

FAQ

Почему Postman возвращает «Wrong JWT token»?

Возможно, ваш обычный API-токен истек или указан неверно. Срок действия обычных API-токенов — 30 минут.

Получите новый токен или используйте действующий токен автоматизации, а затем проверьте «Authorization» → «Bearer Token».

Почему я получаю «Missing authorization header»?

Проверьте, что обычный API-токен указан в «Authorization» → «Bearer Token».

Если запросу нужна аутентификация профиля, проверьте также заголовок X-Profile-Authentication.

Почему я не могу выполнить запрос с ограничением?

Проверьте, что вы используете правильный ID профиля, что ваша роль в проекте разрешает это действие и что вы добавили нужные данные аутентификации профиля.