Nomes e identificadores

O XGuardian permite administrar o nome e a descrição das aplicações e definir identificadores de scan legíveis e padronizados.

Esses dados aparecem na navegação, no inventário, nos resultados de análise e nos relatórios associados à organização.

As regras abaixo são aplicadas pela interface e pelos serviços de processamento. Assim, o mesmo comportamento é mantido para os diferentes tipos de scan e integrações disponíveis na plataforma.

Gerenciamento de aplicações

Nome da aplicação

O nome da aplicação pode ser informado durante o cadastro e alterado posteriormente na página de detalhes da própria aplicação.

Para editar:

Abra a aplicação.
Use o ícone de edição ao lado do título.
Informe o novo nome.
Selecione Salvar.

A ação Cancelar descarta a alteração em andamento.

O campo aceita texto com acentuação, espaços e caracteres de pontuação usuais.

Exemplos:

Portal do Cliente - Produção
Aplicação #1: API & Portal
Financeiro (Legado)

O nome é obrigatório, não pode conter caracteres de controle e deve ser único dentro da mesma organização. Caso já exista uma aplicação com o nome informado, o XGuardian apresenta uma mensagem de validação e preserva o cadastro atual.

Descrição da aplicação

A descrição pode ser preenchida no cadastro ou editada diretamente na página da aplicação, usando o mesmo padrão de salvar ou cancelar.

Ela aceita texto livre, inclusive pontuação, e comporta até 2.000 caracteres.

Identificadores de scan

O nome do scan é um identificador operacional. Ele é utilizado para localizar análises, relacionar artefatos e diferenciar execuções da mesma aplicação.

Caracteres aceitos

Um nome de scan pode conter:

letras de A a Z e de a a z;
números de 0 a 9;
espaços;
hífen: -;
sublinhado: _;
ponto: ..

Exemplos válidos:

release-1_0.2
api.prod_2026-08
Portal Cliente - homologacao.01

Outros caracteres especiais não são aceitos no identificador de scan. Isso mantém compatibilidade com registros internos, metadados de processamento e artefatos armazenados pela plataforma.

Fluxos cobertos

A regra é aplicada de forma consistente na criação de scans por:

upload de arquivo;
repositório Git;
repositório Bitbucket;
integração Azure DevOps;
análise DAST;
análise de imagem Container;

Ao informar um nome fora do padrão, a interface exibe a regra de preenchimento. Os serviços do XGuardian também repetem essa validação antes de iniciar o processamento, o que evita que uma integração ou chamada direta grave um identificador incompatível.

Boas práticas

Use nomes curtos, descritivos e fáceis de pesquisar.
Inclua versão, ambiente ou data somente quando isso ajudar a diferenciar execuções, como api.prod_2026-08.
Mantenha uma convenção por equipe para facilitar a leitura de relatórios e históricos.
Evite reutilizar o mesmo identificador para scans diferentes.

Mensagens de validação comuns

Situação	Comportamento do XGuardian
Nome de aplicação em branco	Solicita o preenchimento do campo.
Nome de aplicação já utilizado na organização	Impede a gravação e informa que o nome já existe.
Descrição acima de 2.000 caracteres	Impede a gravação e solicita redução do texto.
Nome de scan com caractere fora do padrão	Informa os caracteres permitidos e não inicia o scan.
Nome de scan em branco	Solicita o preenchimento do identificador.

Segurança e integridade

As validações são aplicadas tanto na experiência web quanto nos serviços responsáveis por criar aplicações e processar scans.

Essa dupla verificação mantém os nomes consistentes entre a tela, as integrações e os registros operacionais.