TECNOLOGIA X - Alias - O que é o Alias
Este artigo contém os seguintes tópicos:
O que é o Alias
Condições para cadastrar um Alias
Onde o Alias aparece
Casos de uso
Características
Por que o Alias não aparece na seleção de domínio ao criar usuário?
O que é o Alias?
O Alias é um mecanismo de configuração do tenant que permite definir uma identificação alternativa para o nome e o domínio de um tenant na plataforma Senior X.
O Alias é composto pelos seguintes campos:
- tenantAlias: identificação alternativa para o nome do tenant;
- domainAlias: identificação alternativa para o domínio do tenant.
O Alias permite que o tenant seja identificado ou acessado por uma referência alternativa, sem alterar seus identificadores principais cadastrados na plataforma.
Condições para cadastrar um Alias
Para cadastrar um Alias, a identificação informada deve estar disponível na plataforma Senior X.
O domínio do Alias deve ser único em toda a plataforma. Portanto, não é possível cadastrá-lo caso o domínio informado já esteja associado a outro tenant ou utilizado por outro Alias.
Onde o Alias aparece?
O Alias pode ser utilizado como uma identificação alternativa do tenant durante a autenticação.
Ao acessar a plataforma utilizando o domínio configurado como, a autenticação será direcionada para o tenant ao qual o Alias está associado.
Casos de uso
O Alias é destinado a cenários em que o tenant precisa ser identificado ou acessado por um nome ou domínio mais amigável ou representativo, sem alterar seus identificadores primários.
Exemplos:
1. Migração de nome comercial
Uma empresa que alterou sua razão social ou nome comercial pode utilizar um Alias para representar o novo nome sem a necessidade de recriar o tenant.
2. Identificação alternativa para acesso
Um cliente pode utilizar um domínio mais amigável ou representativo para acessar a plataforma, mantendo o domínio principal do tenant.
3. Simplificação de integrações
Sistemas externos podem utilizar a identificação alternativa do tenant em cenários em que seja necessário referenciar o tenant por um nome ou domínio mais simples.
Características
| Característica | Alias |
|---|---|
| Propósito | Identificação alternativa do tenant como um todo |
| Quantidade | Um único Alias por tenant |
| Login de usuários | Sim |
| Exibido na seleção de domínio ao criar usuário | Não |
| Unicidade | Deve ser único em toda a plataforma |
Ao criar um usuário em um tenant que possui Alias, o Alias não é apresentado na lista de domínios, desta forma, deve ser selecionado o domínio principal do tenant ou um domínio alternativo, conforme a configuração disponível.
Por que o Alias não aparece na seleção de domínio ao criar usuário?
Ao criar um novo usuário pela tela de Gestão de Usuários da plataforma, o campo Domínio apresenta:
- o domínio principal do tenant;
- os domínios alternativos cadastrados para o tenant.
O Alias não é exibido nessa seleção, pois ele não é considerado um domínio de usuário. O Alias funciona como uma identificação alternativa do tenant, e não como um domínio adicional para cadastro de usuários.
Dessa forma, o usuário deve ser criado utilizando o domínio principal ou um domínio alternativo disponível para o tenant.
Posteriormente, caso a autenticação seja realizada utilizando o domínio do Alias, a plataforma identificará o tenant associado ao Alias e direcionará o processo de autenticação para o tenant correspondente.