Importar

Esta documentação descreve detalhadamente o template de importação em massa de usuários, apresentando cada campo, seu propósito, requisitos de preenchimento e formato esperado. Utilize este guia para garantir que o arquivo CSV/TSV esteja corretamente estruturado antes de realizar a importação.

Campo	Descrição	Obrigatório	Formato	Exemplo
Nome	Nome completo ou identificador do usuário.	Sim	String (máximo 128 caracteres)	Administrator
Nome de usuário	Identificador único para login.	Sim	String (máximo 128 caracteres)	admin
Senha	Senha de acesso.	Não	String (máximo 1024 caracteres)	(vazio ou placeholder)
Chave pública SSH	Chave SSH para autenticação.	Não	Texto livre (ilimitado)	(vazio ou placeholder)
E-mail	Endereço de e-mail do usuário.	Sim	String (máximo 128 caracteres) — deve ser um e-mail válido	[email protected]
WeChat	Identificação WeChat do usuário.	Não	String (máximo 256 caracteres)	(vazio)
Celular	Número de celular.	Não	Texto livre (ilimitado)	(vazio ou placeholder)
MFA	Configuração de autenticação multifator. Valores válidos: 0, 1, 2.	Não	nome(valor), ex.: Ativado(1)	Desativado(0)
Origem	Fonte de autenticação do usuário. Valores: local, ldap, openid, etc.	Não	nome(valor), ex.: Banco de Dados(local)	Banco de Dados(local)
Função da organização	Papéis do usuário na organização.	Não	Array JSON de strings: ["nome(id)", ...]	["Administrador da organização(00000000-0000-0000-0000-000000000005)"]
Grupos de usuários	Grupos aos quais o usuário pertence.	Não	Array JSON de strings	[]
Função de sistema	Papéis do usuário no sistema.	Não	Array JSON de strings	["Administrador do sistema(00000000-0000-0000-0000-000000000001)"]
Tag	Etiquetas associadas ao usuário.	Não	Array JSON de strings: ["chave: valor", ...]	[]
Opções de Senha	Modo de envio de link de redefinição. Valores: email, custom.	Não	nome(valor), ex.: email(email)	email (Gere um link de redefinição de senha e envie para o usuário por e-mail)
Ativação	Indica se a conta está ativa.	Não	Yes ou No	Yes
Necessita atualizar a senha	Exige troca de senha no próximo login.	Não	Yes ou No	No
Data de expiração	Data e hora de expiração da conta.	Não	YYYY/MM/DD HH:MM:SS ±ZZZZ	2094/08/11 01:19:54 +0800
Último atualizador	Usuário ou sistema que realizou a última atualização.	Não	String (máximo 30 caracteres)	System
Observação	Comentários adicionais.	Não	Texto livre (ilimitado)	(vazio ou placeholder)

Tipos de Entrada

Para facilitar a compreensão dos formatos, cada tipo de campo utilizado no template é descrito abaixo como lista, com definição e exemplos.

• String

  • Descrição: Texto com limite de caracteres definido; útil para nomes, identificadores e e‑mails.

  • Formato: até N caracteres (por exemplo, 128).

  • Exemplos: Administrator, user123, [email protected]

• Texto livre

  • Descrição: Texto sem limite ou com limite alto; ideal para observações, notas e chaves SSH.

  • Formato: ilimitado ou conforme necessidade.

  • Exemplos: Minha nota sobre o usuário, ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC...

• Array JSON

  • Descrição: Lista de itens no formato JSON, usado para papéis, grupos e tags.

  • Formato: ["item1(id)", "item2(id)"]

  • Exemplos: ["Administrador da organização(00000000-0000-0000-0000-000000000005)"], []

• Opções

  • Descrição: Valores restritos a um conjunto predefinido, no formato nome(valor).

  • Formato: nome(valor) (nome opcional, valor obrigatório).

  • Exemplos: Ativado(1), Desativado(0), email(email)

• Booleano

  • Descrição: Indicador binário para estados Sim/Não.

  • Formato: Yes / No.

  • Exemplos: Yes, No

• Data e hora

  • Descrição: Timestamp com data, hora e fuso horário, usado para expiração e auditoria.

  • Formato: YYYY/MM/DD HH:MM:SS ±ZZZZ.

  • Exemplo: 2025/07/16 13:12:39 +0000

Utilize sempre o tipo adequado para cada campo, respeitando o formato indicado, para evitar erros na importação