Skip to Content

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:

CampoNotas
E-mailContacto principal e, na maioria dos diretórios, o identificador de início de sessão. Pode ser verificado.
Nome de utilizadorIdentificador secundário opcional.
Nome completoNome próprio, apelido e, opcionalmente, um nome do meio.
N.º de telemóvelNúmero de telefone, utilizado para fatores SMS; pode ser verificado. É suportado um segundo número opcional.
Título, Departamento, Nome da empresaAtributos 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ãoAtributos 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.

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.

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:

    TipoUtilizar para
    TextTexto curto de forma livre.
    NumberValores numéricos.
    DateDatas de calendário.
    Select / ChoiceUma lista fixa de opções que define (valor e etiqueta).
    PasswordUm 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:

VisibilidadeComportamento
OcultoNã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 administradorVisí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

Nesta página