Descoberta

A Descoberta permite escanear provedores de identidade (Active Directory, Entra ID e Google Workspace) para encontrar e vincular contas existentes aos funcionários do RH.

Quando Usar Descoberta

• Implementação inicial do Sincroniza
• Adição de novo provedor de identidade
• Auditoria periódica de vinculações
• Após importação de novos funcionários do RH

Acessando Descoberta

1. No menu lateral, em Dados, clique em Contas
2. Na aba Funcionários Não Vinculados, inicie uma descoberta

Criando um Job de Descoberta

Iniciar Nova Descoberta

1. Clique em Iniciar Descoberta
2. Configure os parâmetros:

Parâmetro	Descrição
Provedor	Active Directory, Entra ID ou Google Workspace
Incluir Desabilitadas	Se deve escanear contas desabilitadas
Filtro de Busca	Filtro LDAP ou consulta para limitar escopo

Filtros de Busca

Para Active Directory:

# Buscar em OU específica
(memberOf=CN=Usuarios,OU=Groups,DC=corp,DC=local)

# Buscar por departamento
(department=TI)

# Excluir contas de serviço
(&(objectClass=user)(!(cn=svc*)))

Para Entra ID:

# Por departamento
department eq 'TI'

# Por tipo de usuário
userType eq 'Member'

Executar Descoberta

1. Após configurar, clique em Executar
2. O job é criado e inicia a execução

Acompanhando a Execução

Status do Job

Status	Descrição
Pendente	Aguardando início
Escaneando	Buscando contas no provedor
Correspondendo	Executando algoritmo de match
Aguardando Revisão	Correspondências prontas para revisão
Concluído	Processo finalizado
Falha	Erro durante o escaneamento ou a correspondência
Cancelado	Job substituído por um novo job de descoberta

flowchart TD
    A["Pendente"] --> B["Escaneando"]
    B --> C["Correspondendo"]
    C -->|"correspondências encontradas"| D["Aguardando Revisão"]
    C -->|"sem correspondências"| F["Concluído"]
    D -->|"revisão finalizada"| F
    B -->|erro| E["Falha"]
    C -->|erro| E

    classDef process fill:#f3e5f5,stroke:#4a148c,stroke-width:2px,color:#1a1a1a
    classDef startEnd fill:#e1f5fe,stroke:#01579b,stroke-width:2px,color:#1a1a1a
    class A,B,C,D process
    class F startEnd

Um job em qualquer estado não terminal é marcado como Cancelado automaticamente quando um novo job de descoberta é criado.

Progresso

Durante a execução:

• Número de contas escaneadas
• Número de correspondências encontradas
• Tempo decorrido

Revisando Correspondências

Quando o job está em "Aguardando Revisão":

Informações por Correspondência

Campo	Descrição
Conta	Nome de usuário / UPN da conta
Funcionário	Funcionário sugerido
Confiança	Nível de confiança (Alta, Média ou Baixa)
Critérios	O que correspondeu (email, nome, etc.)

Níveis de Confiança

O nível de confiança é determinado por qual critério encontrou a correspondência:

Nível	Critério que correspondeu	Indicador	Recomendação
Alta	Matrícula ou e-mail	🟢	Elegível para aprovação automática
Média	UPN ou nome de usuário	🟡	Revisar antes de aprovar
Baixa	Nome completo ou parcial	🟠	Verificar cuidadosamente
Manual	Vinculação feita pelo administrador	⚪	Já confirmada

Aprovando Correspondências

Aprovar Individual

1. Revise a correspondência
2. Verifique se conta e funcionário correspondem
3. Clique em ✅ para aprovar

Rejeitar Individual

1. Se a correspondência estiver incorreta
2. Clique em ❌ para rejeitar

Aprovar em Lote

• Aprovar Selecionados / Rejeitar Selecionados: decide sobre as correspondências marcadas
• Auto-Aprovar Todas: aprova automaticamente todas as correspondências com confiança Alta (matrícula ou e-mail)

Aplicar Vinculações

Após revisar todas as correspondências:

1. Clique em Aplicar Vinculações
2. Contas aprovadas são vinculadas aos funcionários
3. O job é marcado como concluído

Resultados da Descoberta

Estatísticas

Métrica	Descrição
Contas Escaneadas	Total de contas encontradas
Correspondências	Quantas correspondências foram geradas
Aprovadas	Quantas foram aprovadas
Rejeitadas	Quantas foram rejeitadas
Vinculadas	Quantas vinculações foram aplicadas
Órfãs	Contas sem correspondência

Contas Órfãs

Contas que não corresponderam a nenhum funcionário:

Situação	Ação Sugerida
Conta de serviço	Ignorar (não é funcionário)
Funcionário não importado	Verificar dados do RH
Conta antiga	Considerar desabilitação
Nome diferente	Vincular manualmente

Vinculação Manual

Para vincular uma conta que não foi encontrada automaticamente:

1. Acesse a lista de funcionários
2. Abra os detalhes do funcionário
3. Clique em Vincular Conta
4. Selecione o provedor
5. Informe o identificador da conta
6. Confirme a vinculação

Histórico de Descobertas

Acessando o Histórico

1. Na lista de descobertas, veja jobs anteriores
2. Clique em um job para ver detalhes

Informações do Histórico

• Data de execução
• Parâmetros utilizados
• Estatísticas finais
• Lista de vinculações aplicadas

Descobertas Periódicas

Por que Executar Periodicamente

• Novos funcionários admitidos
• Novas contas criadas manualmente
• Auditoria de vinculações

Frequência Recomendada

Situação	Frequência
Operação normal	Mensal
Muitas admissões	Semanal
Auditoria	Trimestral

Boas Práticas

Recomendações

1. Execute antes da primeira sync: Vincule contas existentes antes de iniciar sincronização automática.

2. Use filtros: Limite o escopo para evitar escanear milhares de contas.

3. Revise correspondências de baixa confiança: Não confie apenas no algoritmo.

4. Investigue órfãs: Podem indicar contas que deveriam ser desabilitadas.

5. Documente vinculações manuais: Registre por que uma vinculação foi feita manualmente.

Atenção

• Vinculações aplicadas são permanentes (podem ser desfeitas manualmente)
• Correspondências incorretas podem causar atualização de dados errados
• Em caso de dúvida, rejeite e investigue

Próximos Passos

• Funcionários - Verifique vinculações aplicadas
• Primeira Sincronização - Execute após descoberta
• Conceitos de Descoberta - Entenda o algoritmo em detalhes