Plantonizei

Conta e acesso › Conta e segurança

Começar a ligar as duas etapas

POST/api/v1/me/mfa/enrollPede sessão

Como funciona

Primeiro passo para ligar a autenticação em duas etapas. Pede a senha da conta (password) e devolve o segredo do autenticador: o qrCode para escanear, a uri e o secret para digitar à mão, e o factorId que o passo seguinte usa.

A conta ainda não pede o código depois deste passo: isso só acontece quando POST /me/mfa/confirm recebe o primeiro código certo.

  • Já ligada, dá 400: para trocar de aparelho, desligue antes, assim o autenticador antigo não para de funcionar sem aviso.
  • Uma tentativa anterior que não foi confirmada é descartada.

Não funciona dentro de uma sessão de suporte (a equipe interna na conta do cliente).

Parâmetros

  • passwordCorpo · stringSenha da conta.

Respostas

200 · O fator novo: factorId, qrCode, uri e secret.

  • factorIdstring · Identificador do autenticador cadastrado.
  • qrCodestring · Imagem do QR code para escanear no aplicativo autenticador.
  • secretstring · Segredo do autenticador, para digitar à mão.
  • uristring · Endereço otpauth:// do autenticador, para quem não consegue escanear.

Corpo de exemplo

{
  "factorId": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
  "qrCode": "texto",
  "secret": "texto",
  "uri": "texto"
}