Conta e acesso › Conta e segurança
Começar a ligar as duas etapas
POST/api/v1/me/mfa/enrollPede sessãoComo 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çootpauth://do autenticador, para quem não consegue escanear.
Corpo de exemplo
{
"factorId": "3f0c2a5e-9b1d-4c7e-8a21-6d0f5b7ca91e",
"qrCode": "texto",
"secret": "texto",
"uri": "texto"
}