Pular para o conteúdo
MultiloginCentral de ajuda

Como habilitar a 2FA (autenticação de 2 fatores) no Postman

Use os endpoints de 2FA do Multilogin no Postman para configurar e gerenciar a 2FA de uma conta com e-mail e senha.

➡️ Importe a coleção da API do Multilogin → autentique suas solicitações no Postman → execute “Set up 2FA” → adicione a entrada gerada ao aplicativo autenticador → envie o código atual com “Enable 2FA”.

Se você entra no Multilogin com Google, Apple ou outro provedor social, gerencie a 2FA por esse provedor, e não pelo Multilogin.

Se preferir fazer isso pela CLI do Multilogin, siga nosso artigo Como ativar a 2FA na CLI.

Antes de começar

Use este fluxo somente se você entra no Multilogin com e-mail e senha.

Se você entra com Google, Apple ou outro provedor social, gerencie a 2FA por esse provedor, e não pelo Multilogin.

Verifique se:

  • O Postman está instalado
  • A coleção da API do Multilogin foi importada
  • Suas solicitações no Postman usam um Token da API do Multilogin válido
  • Você entra no Multilogin com e-mail e senha
  • Você tem um aplicativo autenticador compatível pronto para usar

Como configurar o Google Authenticator

  1. Baixe o Google Authenticator na sua loja de aplicativos (iOS, Android)
  2. Abra o aplicativo → faça login na sua conta do Google
  3. Clique no ícone de mais (+) na área inferior direita
  4. Selecione “Enter a setup key”. Na próxima seção, você vai inserir a chave manualmente, sem usar um conversor de QR code online.

Como usar endpoints 2FA com o Postman

Use um aplicativo autenticador compatível, como Google Authenticator ou Microsoft Authenticator, para gerar seus códigos de 2FA.

Como configurar 2FA para um usuário

  1. Acesse a página do Documentador e localize ou importe os endpoints 2FA
  2. Use o endpoint “Set up 2FA” para obter seus objetos device_id e otp_url_bytes
  3. Guarde device_id para a próxima solicitação. Decodifique otp_url_bytes localmente com o exemplo em Python 3 abaixo. Não cole esse valor em sites, chats ou chamados de suporte.
  4. Salve o exemplo como decode_2fa.py, execute python3 decode_2fa.py (ou python decode_2fa.py no Windows) e cole otp_url_bytes no campo de entrada oculto. O script não faz solicitações de rede.
  5. No aplicativo autenticador, adicione uma conta manualmente com o nome exibido e o valor de Secret. Selecione códigos baseados em tempo. Use o algoritmo, a quantidade de dígitos e o período exibidos. Se o aplicativo não aceitar esses parâmetros, use um autenticador compatível, sem alterar os valores.
  6. Continue com “Enable 2FA” abaixo usando o código atual. Após a configuração, limpe os dados copiados da área de transferência e feche o terminal. Mantenha a chave secreta em sigilo.

Exemplo de decodificação local (requer Python 3). A chave aparece apenas no seu computador; não é necessário usar um site para converter QR codes.

import base64
import getpass
from urllib.parse import parse_qs, unquote, urlparse

encoded = getpass.getpass("otp_url_bytes: ").strip()
uri = urlparse(base64.b64decode(encoded, validate=True).decode("utf-8"))
if uri.scheme != "otpauth" or uri.netloc != "totp":
    raise ValueError("Expected a time-based otpauth setup URI")
settings = parse_qs(uri.query)
secret = settings.get("secret", [""])[0]
if not secret:
    raise ValueError("The setup URI has no secret")
print("Account:", unquote(uri.path.lstrip("/")))
print("Secret:", secret)
print("Algorithm:", settings.get("algorithm", ["SHA1"])[0])
print("Digits:", settings.get("digits", ["6"])[0])
print("Period:", settings.get("period", ["30"])[0])
Requisição Set up 2FA no Postman com device_name em Body e device_id e otp_url_bytes na resposta.

Como habilitar 2FA para um usuário

  1. Vá para o ponto final “Enable 2FA” → vá para “Body”
  2. Use o device_id obtido anteriormente
  3. Digite o código do Google Authenticator em totp_code → pressione “Send”
  4. Seus códigos de backup serão gerados → armazene-os em um local seguro
Requisição Enable 2FA no Postman com device_id, totp_code e backup_codes na resposta de sucesso.

Como configurar 2FA para um novo dispositivo

  1. Obtenha o novo device_id por meio do endpoint “Set up 2FA”
  2. Vá para o ponto final “Set up new device for 2FA”
  3. Preencha o novo device_id
  4. Insira o código do Google Authenticator em totp_code → pressione “Send”
  5. Uma mensagem de sucesso aparecerá na saída
Requisição Set up new device for 2FA no Postman com device_id, totp_code e resposta de sucesso.

Como habilitar/desabilitar 2FA no trabalho espaço

  1. Vá para o ponto final “Enable/Disable 2FA for workspace”
  2. Na aba “Body” → selecione true ou false para ativar/desativar
  3. Pressione “Send” → uma mensagem de confirmação aparecerá
Requisição Enable/Disable 2FA for Workspace no Postman com enable: true e resposta de confirmação.

Como remover 2FA de um dispositivo

  1. Vá para o ponto final “Revoke device for 2FA”
  2. Vá para “Body”
  3. Preencha o device_id que deseja remover → pressione “Send”
  4. Uma mensagem de sucesso/falha aparece como saída
Requisição Revoke device for 2FA no Postman com device_id e confirmação de remoção do dispositivo.

Fique por dentro

Veja as últimas atualizações, troque dicas e explore casos de uso práticos.

Novidades do produtoCanal no TelegramPergunte a outrosChat no TelegramExplore casos de usoComunidade no Discord