Visão geral
O seu perfil pessoal de operador rege a forma como inicia sessão no Painel do Passinstance (/settings/account/profile, /preferences, /notifications, /authentication, /two-factor-authentication e /sessions), como os textos e carimbos de data/hora são localizados na sua sessão do browser e como recebe avisos de segurança. Ao contrário das definições globais em Definições da Empresa, as alterações efetuadas em Conta -> Perfil e Preferências aplicam-se estritamente à sua identidade User individual, sem afetar os idiomas dos cartões dos clientes nem as vistas dos colegas.
Arquitetura de Identidade, MFA e Ciclo de Vida de Sessões
Importante: Alterar o seu Idioma da Interface ou Modo de Tema pessoal afeta apenas a sua sessão no Painel. Os textos dos cartões entregues aos clientes finais, as páginas inteligentes
/d/:sluge os formulários PassFlow seguem sempre as regras de idioma definidas em cada modelo e nas Definições da Empresa.
Perfil Pessoal e Preferências de Interface
Aceda a Conta -> Perfil (/settings/account/profile) e Preferências (/settings/account/preferences) para configurar a sua identidade de operador e preferências visuais:
| Definição | Campo API | Comportamento e Âmbito |
|---|---|---|
| Nome de Apresentação e Avatar | firstName, lastName / PUT /api/v1/users/me/avatar | Apresentado nas listas de equipa, histórico de revisões de modelos e registos de auditoria (GET /api/v1/audit-log/export.csv). |
| Idioma da Interface | locale (en, de, es, fr, it, nl, pt) | Controla o dicionário do Painel independentemente dos idiomas do espaço de trabalho ou dos modelos de cartão. |
| Modo de Tema | theme (light, dark, system) | Guarda o esquema cromático preferido entre dispositivos e sincroniza com os tokens CSS semânticos. |
| Fuso Horário de Visualização | timezone (identificador IANA) | Formata os registos de atividade na sua vista pessoal mantendo o alinhamento do fuso horário do espaço para relatórios. |
| Canais de Notificação | Objeto notifications | Ativa ou desativa alertas por e-mail sobre importações em lote concluídas, expiração de certificados, recibos de faturação e avisos de sessão. |
Atualizar Perfil e Preferências via API
PUT /api/v1/users/me/profile HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"firstName": "Elena",
"lastName": "Rostova",
"timezone": "Europe/Berlin"
}
Utilize PUT /api/v1/users/:userId/preferences (ou GET /api/v1/users/me/settings) para atualizar idioma de interface, tema e preferências de notificação:
{
"id": "usr_019331a0-4c22-7b10-8a99-112233445566",
"email": "elena.rostova@example.com",
"firstName": "Elena",
"lastName": "Rostova",
"locale": "en",
"timezone": "Europe/Berlin",
"theme": "dark",
"twoFactorEnabled": true,
"updatedAt": "2026-11-16T09:31:00.000Z"
}
Registo de Autenticação de Dois Fatores (TOTP 2FA)
O Passinstance suporta autenticação multifator com códigos temporários RFC 6238 (TOTP) em /settings/account/two-factor-authentication, compatível com 1Password, Google Authenticator, Authy e Palavras-passe da Apple. Os espaços também podem impor 2FA obrigatória por função administrativa através de Membros da Equipa e Permissões.
-
1
Gerar Segredo e URI QR (
POST /api/v1/auth/2fa/setup): Devolve um URIotpauth://totp/encriptado e segredo base32 (GET /api/v1/auth/2fa/statusverifica o estado atual). -
2
Verificar e Ativar (
POST /api/v1/auth/2fa/verify+/api/v1/auth/2fa/enable): Submeta um código válido de 6 dígitos da sua app autenticadora para ativar a 2FA e receber códigos de recuperação de uso único (POST /api/v1/auth/2fa/regenerate-backup-codesrenova-os). -
3
Guarda Segura dos Códigos de Recuperação: Armazene em local seguro os códigos de recuperação gerados; cada código só pode ser usado uma vez em caso de perda do dispositivo móvel.
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"code": "482910"
}
{
"twoFactorEnabled": true,
"verifiedAt": "2026-11-16T09:32:15.000Z",
"recoveryCodes": [
"PI-894A-221C",
"PI-773B-904D",
"PI-112E-665F",
"PI-550C-338A"
]
}
Rotação de Palavra-passe e Gestão de Sessões Ativas
Em Conta -> Autenticação (/settings/account/authentication) e Sessões (/settings/account/sessions), pode alterar a palavra-passe e inspecionar todas as sessões autenticadas associadas à sua conta:
-
Rotação de Palavra-passe (
POST /api/v1/users/change-password): Exige confirmação da palavra-passe atual (e código TOTP ativo se a 2FA estiver ligada). A alteração revoga automaticamente todos os outros tokens de atualização ativos em dispositivos secundários. -
Inspeção e Revogação de Sessões (
GET /api/v1/users/sessions,DELETE /api/v1/sessions/:sessionIdeDELETE /api/v1/sessions/others): Apresenta endereço IP,User-Agentdo browser/SO, estado de confiança do dispositivo (/api/v1/sessions/trust-device) e última atividade para encerramento remoto de sessões.
Documentação Relacionada
-
Configure políticas de segurança do espaço de trabalho em Segurança da Conta e Acesso.
-
Defina moeda da organização, morada fiscal e idioma predefinido em Definições da Empresa.
