Copy
View as MarkdownOpen in ChatGPTOpen in ClaudeReport an issueShare on XShare on LinkedInShare on Facebook

Definições da Aplicação

As definições guardadas na base de dados e editáveis pelo administrador, definidas em SettingService.static.DEFAULTS.

referenceconfigurationsettings
Nesta página

DefiniƧƵes da AplicaĆ§Ć£o

Estas residem em SettingService.static.DEFAULTS, sĆ£o semeadas no arranque por preFlightCheck(), colocadas em cache com um TTL de 2 horas, e editĆ”veis em /settings por qualquer pessoa com a permissĆ£o settings:write (ou settings:admin) ā€” veja ConfiguraĆ§Ć£o.

A pĆ”gina de DefiniƧƵes Globais de administraĆ§Ć£o
A pĆ”gina de DefiniƧƵes Globais de administraĆ§Ć£o.

AutenticaĆ§Ć£o e registo

DefiniĆ§Ć£oPropĆ³sito
cbLoginLayoutLayout utilizado nas pĆ”ginas de autenticaĆ§Ć£o (AuthSplit por predefiniĆ§Ć£o; escolha entre AuthCenter ou AuthSplit)
cbAllowRegistrationAtiva/desativa o registo por autoatendimento
cbAllowForgotPasswordAtiva/desativa o fluxo de esquecimento de palavra-passe
cbAllowRememberMeAtiva/desativa o cookie "lembrar-me"
cbRememberMeDaysDurante quanto tempo um token de "lembrar-me" permanece vĆ”lido (predefiniĆ§Ć£o: 14)
cbRequirePasskeyObriga ao registo de uma passkey antes de aceder Ć  Ć”rea de administraĆ§Ć£o

SeleĆ§Ć£o do layout de inĆ­cio de sessĆ£o

A pƔgina Settings expƵe cbLoginLayout como um seletor:

ValorLayoutAparĆŖncia
AuthSplitapp/layouts/AuthSplit.bxmInĆ­cio de sessĆ£o em dois painĆ©is: marca/funcionalidades Ć  esquerda e o formulĆ”rio Ć  direita. Em ecrĆ£s pequenos, colapsa para o formulĆ”rio com marca compacta. Esta Ć© a predefiniĆ§Ć£o.
AuthCenterapp/layouts/AuthCenter.bxmCartĆ£o de autenticaĆ§Ć£o centrado, com o logĆ³tipo, o formulĆ”rio, e o rodapĆ© de autenticaĆ§Ć£o.

Selecione Auth Center ou Auth Split em /settings, guarde as definiƧƵes, e recarregue a pĆ”gina de autenticaĆ§Ć£o. O handler chama event.setLayout( prc.settings.cbLoginLayout ), pelo que o layout selecionado se aplica ao inĆ­cio de sessĆ£o, ao registo, Ć  ativaĆ§Ć£o de convites, e Ć s pĆ”ginas de recuperaĆ§Ć£o de palavra-passe. TambĆ©m pode definir o valor diretamente na base de dados, ou adicionar um nome de layout personalizado em app/layouts/, se a sua aplicaĆ§Ć£o fornecer esse layout.

PolĆ­tica de palavra-passe e tokens

DefiniĆ§Ć£oPropĆ³sito
cbMinPasswordLengthComprimento mĆ­nimo da palavra-passe (predefiniĆ§Ć£o: 8). SettingService.isValidPassword() tambĆ©m exige uma letra maiĆŗscula, uma letra minĆŗscula, um dĆ­gito, e um carĆ”cter especial, e todos os percursos do lado do servidor que definem uma palavra-passe (registo, ativaĆ§Ć£o de convite, reposiĆ§Ć£o, e alteraĆ§Ć£o no perfil) executam-na
cbPasswordResetExpirationValidade do token de reposiĆ§Ć£o, em minutos (predefiniĆ§Ć£o: 60)
cbInvitationExpirationValidade do token de convite, em dias (predefiniĆ§Ć£o: 7)
cbRegistrationVerificationExpirationValidade do token de verificaĆ§Ć£o de registo, em horas (predefiniĆ§Ć£o: 24)
cbApiTokenMaxValidityMonthsDuraĆ§Ć£o mĆ”xima com que um token de API pode ser emitido (predefiniĆ§Ć£o: 12)
cbAuditLogRetentionDaysIdade, em dias, a partir da qual a tarefa diĆ”ria agendada elimina definitivamente as entradas do registo de auditoria (predefiniĆ§Ć£o: 90). 0 desativa a purga - veja Tarefas Agendadas
cbRateLimitMaxAttemptsTentativas permitidas por IP, por endpoint, antes de o RateLimiter bloquear o inĆ­cio de sessĆ£o/registo/reposiĆ§Ć£o de palavra-passe (predefiniĆ§Ć£o: 5) - veja LimitaĆ§Ć£o de taxa
cbRateLimitWindowSecondsJanela de limitaĆ§Ć£o de taxa, em segundos (predefiniĆ§Ć£o: 300). 0 desativa completamente a limitaĆ§Ć£o de taxa
cbTrustProxyHeadersSe o RateLimiter, o registo de auditoria, e os e-mails de seguranƧa confiam nos cabeƧalhos X-Forwarded-For/X-Cluster-Client-IP para o IP de quem chama (predefiniĆ§Ć£o: true, jĆ” que esta aplicaĆ§Ć£o Ć© tipicamente implantada atrĆ”s de um proxy reverso ou load balancer). Desative isto apenas se a aplicaĆ§Ć£o estiver diretamente exposta Ć  internet, sem nada Ć  frente dela - veja ImplantaĆ§Ć£o atrĆ”s de um proxy
cbEncryptionKey / cbSaltingKeyChaves de encriptaĆ§Ć£o/salting utilizadas pela camada de seguranƧa

Marca e aparĆŖncia

DefiniĆ§Ć£oPropĆ³sito
cbAppNameNome de exibiĆ§Ć£o da aplicaĆ§Ć£o
cbAppLogoLogĆ³tipo mostrado na barra lateral de administraĆ§Ć£o. Ou um URL introduzido manualmente, ou /branding/logo/lg apĆ³s um carregamento via Settings ā€” veja Avatares e logĆ³tipo de marca
cbAppTaglineFrase de destaque mostrada junto ao logĆ³tipo
cbAppBrandTaglineRĆ³tulo de marca curto, mostrado na Ć”rea de marca da barra lateral
cbCopyrightNoticeTexto de direitos de autor renderizado pelo rodapĆ© da aplicaĆ§Ć£o
cbDefaultThemeTema claro/escuro predefinido para novos visitantes

E-mail

DefiniĆ§Ć£oPropĆ³sito
cbDefaultEmailEndereƧo "de" predefinido para o correio de saƭda
cbMailHost / cbMailPortAnfitriĆ£o/porta SMTP
cbMailUsername / cbMailPasswordCredenciais SMTP
cbMailTLS / cbMailSSLIndicadores de seguranƧa de transporte

Registo de auditoria

DefiniĆ§Ć£oPropĆ³sito
cbAuditLogRetentionDaysNĆŗmero de dias durante os quais os registos de auditoria sĆ£o retidos pela purga agendada. Defina como 0 para desativar a purga automĆ”tica (predefiniĆ§Ć£o: 90).

Segredos e encriptaĆ§Ć£o

DefiniĆ§Ć£oPropĆ³sito
cbEncryptionKeySegredo de encriptaĆ§Ć£o AES utilizado pela camada de seguranƧa/armazenamento. Substitua o valor de desenvolvimento gerado automaticamente por um segredo estĆ”vel em produĆ§Ć£o.
cbSaltingKeySal utilizado pelas operaƧƵes de seguranƧa. Mantenha-o estĆ”vel e secreto em produĆ§Ć£o.
ConfiguraçãoVariáveis de ambiente, definições da framework, e configuração por módulo. Estender a AplicaçãoAdicione um novo módulo CRUD, permissão, definição, ou tarefa agendada, seguindo as próprias convenções da aplicação.
Editar esta página Baixar Markdown Última atualização Oct 1, 2026, 2:02:30 PM