# Perfis de utilizador e atributos

Campos de perfil padrão, atributos de perfil personalizados e visibilidade.

O **perfil** de um utilizador é o conjunto de campos que descrevem a conta. A plataforma traz um conjunto fixo de campos padrão e permite alargar o perfil com **atributos personalizados** próprios, definidos uma única vez de forma centralizada e atribuídos aos diretórios que os devem utilizar.

## Campos de perfil padrão

Todos os diretórios disponibilizam um conjunto comum de campos padrão. Os mais importantes são:

| Campo | Notas |
|---|---|
| **E-mail** | Contacto principal e, na maioria dos diretórios, o identificador de início de sessão. Pode ser verificado. |
| **Nome de utilizador** | Identificador secundário opcional. |
| **Nome completo** | Nome próprio, apelido e, opcionalmente, um nome do meio. |
| **N.º de telemóvel** | Número de telefone, utilizado para fatores SMS; pode ser verificado. É suportado um segundo número opcional. |
| **Título**, **Departamento**, **Nome da empresa** | Atributos profissionais. O nome da empresa está desativado por predefinição e partilha o mesmo armazenamento com o valor que uma sincronização de diretório entrega. |
| Localização do escritório, número de colaborador, data de admissão | Atributos profissionais adicionais, disponíveis onde o diretório permite a edição do perfil. |

Cada diretório controla, **por campo**, se está ativado, se serve como **identificador de início de sessão**, se é **obrigatório** e se surge durante o **registo** (off / optional / required). Pelo menos um identificador tem de estar sempre ativo. Esta configuração é feita no próprio diretório, consulte [Diretórios de utilizadores → Esquema de perfil](https://dts-identity.com/pt/docs/directories/user-directories.md).

### Que sistema detém um campo

Se um campo de perfil pode ser editado na console depende do diretório:

- **Diretórios locais**: os campos são aqui sempre editáveis. A plataforma é a fonte da verdade.
- **Diretórios enterprise sincronizados**: a origem Active Directory / LDAP a montante detém os seus campos. São **só de leitura** na console, exceto se a **sincronização upstream (write-back)** estiver ativada para esse diretório, caso em que as edições feitas aqui são propagadas de volta para a origem. Com o write-back desligado, os campos do formulário são apresentados, mas desativados.

Isto está diretamente ligado aos comutadores de ativação / obrigatoriedade por campo e à definição de sincronização upstream do diretório, consulte [Diretórios de utilizadores → Sincronização](https://dts-identity.com/pt/docs/directories/user-directories.md).

Nos diretórios **AD/LDAP**, o perfil expõe os identificadores próprios do diretório, **Common Name**, **Organizational Unit** (escolhida a partir de um seletor de OU) e **User principal name**, em vez da edição livre de e-mail e nome de utilizador.

### Dados de perfil versus dados que conferem acesso

Um perfil transporta dois tipos de dados, e a diferença determina quem pode editar um campo:

- Os **dados de perfil** descrevem a pessoa e mudam com a sua vida, não com o seu acesso: nome apresentado, número de telefone, idioma preferido, localização do escritório, tamanho da t-shirt para o kit de onboarding. Onde um diretório permite self-service, **os utilizadores mantêm estes campos por si próprios**.
- Os **dados que conferem acesso** são tudo aquilo que um sistema lê para decidir o que a pessoa pode fazer: pertença a grupos, funções, estado da conta, centro de custo ou departamento quando uma aplicação deriva permissões daí, um número de cliente em que uma aplicação confia. Um campo destes **nunca** é aberto ao self-service: um valor que o utilizador possa alterar é um valor que o utilizador se pode conceder a si mesmo. Mantenha-o controlado pelo administrador ou sincronizado a partir do sistema que o detém.

Se um atributo sai ou não da plataforma decide-se **por aplicação**, no separador **Atributos** da aplicação: uma aplicação OIDC seleciona os atributos personalizados que recebe como claims, uma aplicação SAML ou WS-Federation mapeia-os nas respetivas attribute statements. Definir um atributo nunca o expõe, por isso, por si só. Trate tudo o que acaba num token ou numa Assertion como dados operacionais: emita apenas o que a aplicação recetora necessita e nunca exponha valores internos ou sensíveis por esta via.

## Atributos de perfil personalizados

> **Nota:** Os atributos de perfil personalizados fazem parte da funcionalidade **profile metadata**, disponível a partir do nível Advanced (e durante o Trial).

Quando os campos padrão não chegam, defina um **atributo personalizado**. Os atributos personalizados são criados uma única vez num catálogo central e depois **atribuídos a cada diretório** que os deva recolher. Este modelo em dois passos mantém uma definição única consistente entre diretórios, deixando ao mesmo tempo que cada diretório decida se o campo é obrigatório e se surge no registo.

### Definir um atributo personalizado

Os atributos personalizados são geridos na área de diretórios, na página **Atributos personalizados**.

1. Abra **Atributos personalizados** e escolha adicionar um novo atributo.
2. Atribua-lhe um **nome** (o identificador estável) e uma **etiqueta** (o que utilizadores e administradores veem). Os nomes dos campos de perfil padrão e os nomes de claims utilizados em tokens emitidos (por exemplo `email`, `title`, `mobile`, `groups` ou `sub`) são **reservados**, independentemente das maiúsculas e minúsculas: um atributo personalizado com um nome desses pareceria o campo padrão, mas conteria dados distintos, pelo que a criação é rejeitada. Escolha antes um nome próprio, como `jobRole` em vez de `title`.
3. Escolha um **tipo**:

   | Tipo | Utilizar para |
   |---|---|
   | **Text** | Texto curto de forma livre. |
   | **Number** | Valores numéricos. |
   | **Date** | Datas de calendário. |
   | **Select** / **Choice** | Uma lista fixa de opções que define (valor e etiqueta). |
   | **Password** | Um valor secreto. |

4. Opcionalmente, configure:
   - **Descrição**: texto livre apresentado como sugestão por baixo do campo, no registo e no perfil, exatamente como foi introduzido (não traduzido).
   - **Permitir vários valores**: permite que o campo contenha uma lista.
   - **Valor predefinido**.
   - **Unicidade**: por predefinição, o valor de um atributo tem de ser único entre contas (dois utilizadores não podem partilhá-lo, por exemplo um número de colaborador). Ative **Permitir duplicados** para levantar essa restrição e deixar que várias contas tenham o mesmo valor.
   - **Maintained via API only**: o valor é apresentado, mas não é editável manualmente, nem no perfil do utilizador nem na Admin Console; apenas a API de gestão (uma integração ou uma sincronização) o escreve. Um atributo destes também nunca é recolhido no registo.
5. Defina a **visibilidade** (ver abaixo) e guarde.

Todos os atributos personalizados podem ser filtrados através da API de gestão; o índice que sustenta essas consultas é mantido automaticamente.

### Começar a partir de um modelo

Os modelos cobrem atributos de que a maioria dos tenants necessita de qualquer forma, como a dimensão da empresa, o centro de custos, o tipo de vínculo ou a data de admissão. Escolha um em **Attribute template** e o nome, o tipo e as opções são pré-preenchidos, juntamente com uma etiqueta. Nada fica ligado ao modelo: todos os valores são editáveis e o resultado comporta-se exatamente como um atributo definido de raiz.

Os modelos vêm também traduzidos. Uma etiqueta proveniente de um modelo é apresentada a cada utilizador no seu próprio idioma, pelo que um utilizador alemão lê "Unternehmensgröße" onde um utilizador inglês lê "Company size". Depois de escolher um modelo, o próprio campo **Etiqueta** mostra o texto de referência em inglês, porque é a partir desse texto que a tradução é procurada. Deixe-o como está para manter as traduções.

Uma etiqueta que escreva por si é apresentada a todos exatamente como a introduziu, em todos os idiomas. O mesmo se aplica a uma etiqueta de modelo que edite posteriormente, pelo que só a deve alterar se preferir a sua própria formulação às traduções. As etiquetas das opções de um atributo do tipo select seguem a mesma regra.

### Visibilidade

A visibilidade controla onde o atributo é apresentado e quem o pode editar:

| Visibilidade | Comportamento |
|---|---|
| **Oculto** | Não é apresentado no perfil nem na Admin Console. É definido através da API ou recolhido uma única vez no registo, onde um diretório o solicite. |
| **Apenas administrador** | Visível e editável na Admin Console, não para o utilizador final. |
| **Perfil + Admin** | É adicionalmente apresentado ao utilizador no seu perfil, onde o pode editar por si próprio. |

> **Nota:** Assim que um atributo é **atribuído a qualquer diretório**, a sua visibilidade fica **bloqueada** e o atributo não pode ser eliminado enquanto não for removido de todos os diretórios. Isto protege os registos de utilizador existentes e a apresentação do registo/perfil de ficarem dessincronizados face à definição.

### Atribuir a um diretório

Qualquer atributo personalizado pode ser atribuído a um diretório, o que o torna disponível nos utilizadores desse diretório. Onde o valor é definido depende da visibilidade:

- um atributo **Perfil + Admin** surge no perfil do utilizador e, onde estiver ativado, no registo; o utilizador pode preenchê-lo;
- um atributo **Apenas administrador** surge nesses utilizadores na Admin Console, para que o defina; não é apresentado ao utilizador;
- um atributo **Oculto** é definido através da API e não é apresentado no perfil nem na Admin Console. Utilize-o para um valor consumido por uma aplicação confiante (por exemplo, um atributo SAML) que é mantido por uma integração e não por uma pessoa.

Na configuração de atributos do diretório escolhe, por atributo, se surge no **registo** (aí opcional ou obrigatório) e se é **obrigatório** no perfil. A recolha no registo é independente da visibilidade: um atributo **Apenas administrador** ou **Oculto** solicitado no registo é preenchido uma vez por quem se regista e, depois disso, só é legível onde a sua visibilidade o permitir. Utilize esta possibilidade para dados de que necessita no registo mas que não quer que o utilizador volte a consultar, como um código de referência ou um centro de custos. Um atributo **Maintained via API only** não pode ser recolhido no registo, uma vez que quem se regista nunca poderia preencher o respetivo campo. A definição de **obrigatório** aplica-se onde o atributo é apresentado para edição.

A própria definição também é editável a partir deste separador: **Adicionar atributo → Create new attribute** cria um novo atributo e atribui-o de imediato ao diretório, e **Edit attribute** no menu de ações de uma linha abre a caixa de diálogo de definição (etiqueta, tipo, opções, definições). **Configurar** continua a ser o local para as definições de recolha por diretório descritas acima.

A ordem da lista é a ordem de apresentação: o registo, o perfil do utilizador e a página de detalhe do utilizador mostram os atributos exatamente como estão dispostos aqui. Arraste a pega à direita de uma linha para reordenar.

## Consulte também

- [Pessoas](https://dts-identity.com/pt/docs/directories/people.md): onde edita os campos de perfil de um utilizador.
- [Diretórios de utilizadores](https://dts-identity.com/pt/docs/directories/user-directories.md): configuração de campos e definições de registo por diretório.
- [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md): disponibilidade de funcionalidades por nível.
