Skip to content
Guia da Central de Ajuda · Definições de conta e área
3 min de leituraVerificado 2026-11-16

Perfil e preferências

Atualize dados pessoais de acesso, idioma da interface, fuso horário e preferências de notificação.

Neste guia

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

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
PERFIL DE OPERADOR, TOTP 2FA E GESTÃO DE SESSÕES
ETAPA 01 CAMADA DE BROWSER / CLIENTE DO OPERADOR
IU de Perfil e Idioma
(/settings/account/*)
Aplicação Autenticadora
(RFC 6238 TOTP 6 díg.)
Gestor de Sessões
Ativas por Dispos.
ETAPA 02 CONTROLADORES USERS, AUTH E SESSION (API)
Identidade e Preferências
GET/api/v1/users/me/profile
PUT/api/v1/users/me/profile
`PUT/api/v1/users/:id/preferences
Tema: light | dark | system
Segurança e Controlo de Sessões
POST/api/v1/auth/2fa/setup
POST/api/v1/auth/2fa/verify
POST/api/v1/users/change-passw
DELETE/api/v1/sessions/:id
ETAPA 03 CAMADA DE PERSISTÊNCIA E AUDITORIA DE SEGURANÇA
Registo User (Segredo TOTP encriptado, Hash Bcrypt, Códigos de Recuperação)
Armazenamento in-memory cache de Refresh Tokens (Invalidação imediata ao mudar palavra-p.)

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/:slug e 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çãoCampo APIComportamento e Âmbito
Nome de Apresentação e AvatarfirstName, lastName / PUT /api/v1/users/me/avatarApresentado nas listas de equipa, histórico de revisões de modelos e registos de auditoria (GET /api/v1/audit-log/export.csv).
Idioma da Interfacelocale (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 Tematheme (light, dark, system)Guarda o esquema cromático preferido entre dispositivos e sincroniza com os tokens CSS semânticos.
Fuso Horário de Visualizaçãotimezone (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çãoObjeto notificationsAtiva 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

HTTP
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:

JSON
{
  "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. 1
    Gerar Segredo e URI QR (POST /api/v1/auth/2fa/setup): Devolve um URI otpauth://totp/ encriptado e segredo base32 (GET /api/v1/auth/2fa/status verifica o estado atual).
  2. 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-codes renova-os).
  3. 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.
HTTP
POST /api/v1/auth/2fa/verify HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "482910"
}
JSON
{
  "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/:sessionId e DELETE /api/v1/sessions/others): Apresenta endereço IP, User-Agent do 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

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.