Account extension fields - Identity as a Service: Central de Documentação do Alibaba Cloud

O gerenciamento de campos no IDaaS EIAM permite que administradores visualizem campos básicos e configurem suas permissões. Também é possível criar, configurar e usar campos de extensão para gerenciar informações de usuários com flexibilidade.

Campos básicos

Descrição do recurso

O sistema predefine campos básicos que contêm informações fundamentais do usuário, como nome de usuário, endereço de e-mail e número de telefone celular. Este recurso permite aos administradores:

Visualize os campos básicos predefinidos pelo sistema.
Configure a exibição dos campos no portal do usuário.
Gerencie as permissões de edição dos usuários para campos específicos.

Procedimento

Acesse a página de gerenciamento de campos básicos
1. Faça logon no IDaaS console. No painel de navegação à esquerda, selecione EIAM. Selecione a instância relevante do IDaaS e clique em Manage na coluna Actions.
2. No menu Account, clique em Field Management > Basic Fields.
Visualize os campos editáveis
1. Na aba Basic Fields, selecione Editable Fields Only na extremidade esquerda.
2. A lista exibe apenas os campos que os usuários têm permissão para editar.

Colunas de campos básicos

Campo	Descrição
Nome de exibição do campo	Nome apresentado para o campo na interface do usuário.
ID do campo	Identificador do campo usado internamente pelo sistema.
Tipo de dados	String
Obrigatório	Indica se o preenchimento do campo é obrigatório.
Único	Defina se o valor do campo deve ser único.
Permissões do usuário	Especifique se o campo é invisível, visível ou editável para os usuários finais.
Actions	É possível edite as permissões do usuário apenas para os campos de nome de exibição, e-mail e número de telefone celular.

Configure as permissões do campo
1. Localize um campo editável na lista de campos básicos.
2. Clique em Edit. Este botão está disponível somente para os campos de nome de exibição, e-mail e número de telefone celular.
3. Na página Edit Field exibida, configure as permissões do usuário.
  - Invisível para usuários: selecione esta opção para ocultar o campo dos usuários.
  - Visível para usuários: escolha esta opção para tornar o campo visível aos usuários.
  - Editável por usuários: marque esta opção para permitir que os usuários editem o campo.
4. Clique em OK para salve a configuração.

Nota

O sistema predefine os campos básicos. Não é possível exclua-os ou adicioná-los.

Campos de extensão

Visão geral do recurso

O IDaaS oferece suporte a extensões personalizadas nos campos da conta para armazenar valores de atributos adicionais, como ID de funcionário, data de nascimento e região. Administradores podem defina e usar novos campos no menu Extended Fields.

Nota

Atualmente, há suporte apenas para campos de extensão de contas. Outros tipos de entidade não são compatíveis.

Crie um campo

Acesse a página Extended Fields e clique em Create Field. O formulário de criação de campo será exibido. A tabela a seguir descreve as informações que devem ser configuradas.

Campo	Descrição	Editável
Nome de exibição do campo	Nome de exibição do campo.	Editável.
ID do campo	Identificador exclusivo do campo. Apenas letras minúsculas e sublinhados são permitidos, e não pode começar com um sublinhado.	Não editável.
Tipo de campo	Forma como o campo é apresentado na página. Valores válidos: Caixa de entrada Lista suspensa Caixa de seleção	Não editável.
Tipo de campo: Caixa de entrada	Após selecione Caixa de entrada, configure os seguintes campos: Tipo de dados: especifique se os dados são uma string ou um número. Valor padrão: valor usado pelo sistema quando nenhum valor é passado para o campo. Semelhante ao valor `DEFAULT` de um campo em um banco de dados relacional.	Tipo de dados: não editável. Valor padrão: editável.
Tipo de campo: Lista suspensa	Tipo de dados: especifique se os dados são uma string ou um número. Itens de dados: defina os pares chave-valor para as opções na lista suspensa. Para garantir a compatibilidade de dados, não é possível exclua um item de dados após sua criação. Você só pode desativá-lo ou ativá-lo ao edite o campo. Após a desativação, o item deixa de aparecer nas opções, mas os dados existentes permanecem inalterados. Valor padrão: especifique a opção padrão do campo inserindo a chave do item de dados.	Tipo de dados: não editável. Itens de dados Adicionar: editável. Desativar ou ative: editável. Exclua: não editável. Modifique chave: não editável. Modifique nome: editável. Valor padrão: editável.
Tipo de campo: Caixa de seleção	Configure os parâmetros da mesma forma que para uma lista suspensa.	Igual ao de uma lista suspensa.
Descrição do campo	Opcional. Informações descritivas exibidas abaixo do campo.	Editável.
Obrigatório	Se selecione, este campo será obrigatório em todas as operações subsequentes de criação e edição de contas. Nota Observação: se você adicionar um campo obrigatório enquanto um provedor de identidade (IdP) estiver em uso para importação de contas, será necessário adicionar o mapeamento de campos na página Identity Provider. Caso contrário, a sincronização falhará.	Não editável.
Único	Especifique se o valor do campo é exclusivo na instância atual. Por exemplo, selecione esta opção ao armazenar IDs de funcionários.	Não editável.
Armazenamento criptografado	Para informações sensíveis, o IDaaS pode criptografar os dados antes de armazená-los no banco de dados para aumentar a segurança.	Não editável.
Permissões do usuário	Administradores possuem permissões totais sobre os campos de extensão. Em alguns casos, é necessário restringir as permissões do usuário para um campo. Especifique as permissões do usuário para o campo de extensão. Valores válidos: Invisível: os usuários não conseguem ver o campo. Visível: os usuários podem ver o valor do campo, mas não podem editá-lo. Editável: os usuários podem visualize e edite seus próprios valores para o campo.	Editável.

Preencher campos de extensão

Após crie um campo, certifique-se de que ele esteja ativado antes de usá-lo.

Acesse a página Accounts And Orgs e clique em Create Account. Na parte superior do formulário exibido, alterne para a aba Extended Field para especifique valores para todos os campos de extensão da conta.

Autoatendimento do usuário

Se as permissões de usuário de um campo estiverem definidas como Visível, os usuários poderão fazer logon em seu portal, clique em My Account e visualize o campo e seu valor em Extended Information.

Caso as permissões estejam definidas como Editável, os usuários poderão clique em na opção de edição do campo para modifique o valor.

Recuperar campos de extensão

As aplicações podem recuperar informações de campos de extensão da conta das três maneiras a seguir:

Método	Descrição
Dev/openapi	As aplicações podem recuperar informações de extensão para qualquer conta especificada. Este método é tipicamente usado para sincronização e trata-se de um recurso de gerenciamento. A Dev/openapi retorna todas as informações de campos de extensão de uma conta sem necessidade de configuração adicional. Para mais informações, consulte API documentation.
OIDC SSO account id_token/userinfo	Após o OIDC SSO, uma aplicação pode recuperar o conteúdo do campo de extensão da conta atualmente conectada. Por padrão, os campos de extensão não são retornados nos resultados do SSO. Nas configurações estendidas do `id_token`, os administradores podem configure o retorno das informações dos campos de extensão. O endpoint OIDC `Userinfo` retorna o mesmo conteúdo que o `id_token`. Use o formato `user.customFieldMap.$field key$.fieldValue`.
Instruções de atributo de conta SAML SSO	Após o SAML SSO, uma aplicação pode recuperar o conteúdo do campo de extensão da conta atualmente conectada. Por padrão, os campos de extensão não são retornados nos resultados do SSO. As Instruções de Atributo de Asserção oferecem suporte a informações de retorno personalizadas, o que permite retornar as informações de extensão no SAMLResponse.

****