Ligar o Microsoft Entra ID
O Identiguard lê o Entra ID através do Microsoft Graph. Regista-se uma aplicação no diretório do cliente, concedem-se permissões só de leitura e indicam-se os detalhes ao Identiguard. O Identiguard consulta depois o Microsoft Graph com o intervalo que escolher.
Antes de começar
Seção intitulada “Antes de começar”O que é necessário:
- Uma função no Entra ID que possa registar aplicações e conceder consentimento de administrador.
- A função de admin no workspace do Identiguard. Os membros e os visualizadores veem Only workspace admins can create tenants. (só os admins do workspace podem criar tenants) e um botão Admin Access Required desativado.
- Uma vaga de tenant livre no plano. Consulte o limite de tenants do plano.
1. Registar uma aplicação no Entra ID
Seção intitulada “1. Registar uma aplicação no Entra ID”- No centro de administração do Entra, vá a App registrations → New registration.
- Dê-lhe um nome, como
Identiguard, e registe-a. - Copie o Directory (tenant) ID e o Application (client) ID.
- Em Certificates & secrets, crie um client secret e copie o respetivo Value. Não copie o Secret ID.
2. Conceder permissões
Seção intitulada “2. Conceder permissões”Em API permissions, adicione estas permissões como permissões de application do Microsoft Graph e depois escolha Grant admin consent.
Para a monitorização
Seção intitulada “Para a monitorização”| Permissão | O que permite |
|---|---|
IdentityRiskyUser.Read.All |
Utilizadores de risco |
IdentityRiskEvent.Read.All |
Deteções de risco, como password spray e credenciais divulgadas |
AuditLog.Read.All |
Auditorias do diretório e inícios de sessão |
IdentityRiskyServicePrincipal.Read.All |
Risco de identidades de workload. Requer a licença Workload ID Premium. |
ServiceHealth.Read.All |
A página de estado do Entra ID |
Para os relatórios (opcional)
Seção intitulada “Para os relatórios (opcional)”A página Edit do tenant verifica estas seis permissões e mostra cada uma como Granted (concedida) ou Not granted (não concedida).
| Permissão | Secção do relatório | Também conta como concedida com |
|---|---|---|
Reports.Read.All |
Cobertura de MFA. Requer também o Entra ID P1. | AuditLog.Read.All |
RoleManagement.Read.Directory |
Número de Global Administrators | RoleManagement.Read.All ou Directory.Read.All |
Policy.Read.All |
Inventário de Conditional Access | |
Application.Read.All |
Expiração de credenciais de aplicações | Directory.Read.All |
SecurityEvents.Read.All |
Microsoft Secure Score | |
IdentityRiskyUser.Read.All |
Utilizadores de risco atuais |
Conceda apenas aquilo com que o cliente se sinta confortável. Uma permissão em falta remove esse fluxo ou essa secção do relatório, e mais nada.
3. Criar o tenant no Identiguard
Seção intitulada “3. Criar o tenant no Identiguard”- Abra o workspace e vá a Tenants.
- Em Create a tenant, localize o cartão Entra ID (legenda Microsoft ecosystem) e escolha Connect. Abre-se a página Add New Entra ID Tenant.
- Preencha o formulário. Todos os campos estão descritos na tabela abaixo.
- Em Event Subscriptions, assinale os fluxos a recolher. Nada está assinalado quando a página abre, e tem de assinalar pelo menos um.
- Escolha Create Entra ID Tenant. O botão indica Creating… enquanto o Identiguard trabalha.
Os campos
Seção intitulada “Os campos”| Secção | Campo | Regras |
|---|---|---|
| Basic Details | Tenant Name | Obrigatório. 100 caracteres ou menos. Sem quebras de linha nem caracteres de controlo. |
| Basic Details | Customer Name | Opcional para o Entra ID. O campo sugere nomes de clientes já utilizados no workspace. |
| Basic Details | Azure AD Tenant ID | Obrigatório. O Directory (tenant) ID. Tem de ser um UUID, como xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. |
| Basic Details | Poll Interval (minutes) | Obrigatório. De 5 a 60 neste formulário. O valor predefinido é 5. |
| Basic Details | Client ID | Obrigatório. O Application (client) ID. Tem de ser um UUID. |
| Credentials | Client Secret | Obrigatório. O Value do segredo no registo da aplicação. |
| Event Subscriptions | Subscribed Event Types | Pelo menos um fluxo. |
Não existe campo Environment para o Entra ID.
Os fluxos
Seção intitulada “Os fluxos”O formulário lista cinco fluxos. Select All assinala os cinco e Clear All desmarca-os.
| Texto do fluxo no formulário | Requer |
|---|---|
| Risky users: accounts Entra has flagged as at risk (utilizadores de risco: contas que o Entra sinalizou como estando em risco) | IdentityRiskyUser.Read.All |
| Risk detections: password spray, leaked credentials, atypical travel and 19 more (deteções de risco: password spray, credenciais divulgadas, viagem atípica e mais 19) | IdentityRiskEvent.Read.All |
| Directory audits: role & PIM changes, consent grants, MFA tampering, CA policy changes (needs AuditLog.Read.All) (auditorias do diretório: alterações de funções e de PIM, concessões de consentimento, adulteração de MFA, alterações de políticas de CA) | AuditLog.Read.All |
| Sign-ins: risky sign-ins and Conditional Access failures (needs AuditLog.Read.All + P1) (inícios de sessão: inícios de sessão de risco e falhas de Conditional Access) | AuditLog.Read.All e Entra ID P1 |
| Workload identity risk: risky service principals and their risk detections (risco de identidades de workload: service principals de risco e as respetivas deteções de risco) | A licença Microsoft Entra Workload ID Premium, mais IdentityRiskyServicePrincipal.Read.All e IdentityRiskEvent.Read.All |
O que acontece quando cria o tenant
Seção intitulada “O que acontece quando cria o tenant”- O Identiguard pede um token à Microsoft com o tenant ID, o client ID e o segredo. Nada é guardado se a Microsoft não os aceitar.
- Num workspace em período de avaliação, esta verificação também reserva o diretório para esse período. Um diretório do Entra só pode ser utilizado num único período de avaliação.
- Regressa à página Tenants.
- Os primeiros eventos chegam depois da primeira consulta.
Verificar que permissões estão concedidas
Seção intitulada “Verificar que permissões estão concedidas”- Abra Tenants.
- Em Tenant overview, escolha o ícone do lápis (Edit) no tenant do Entra ID.
- Leia Reporting permissions (optional). Cada linha mostra Granted ou Not granted.
- Se uma linha mostrar Not granted, adicione essa permissão no centro de administração do Entra, em API permissions, e escolha Grant admin consent.
- Recarregue a página Edit. O Identiguard lê as permissões da Microsoft sempre que a página carrega. Não existe botão de atualizar.
A saber
Seção intitulada “A saber”- Os eventos do Entra ID chegam com o intervalo de consulta, não de imediato. Diga-o numa demonstração.
- Os client secrets expiram. Coloque a data de expiração no calendário do cliente e consulte Rodar credenciais.
- Não é possível alterar o diretório mais tarde. Para mudar para outro diretório, elimine o tenant e crie-o de novo.
- Eliminar o tenant não altera nada dentro do Entra ID. Revogue o segredo do registo da aplicação se já não precisar dele.
- Para alterar mais tarde os fluxos ou o intervalo de consulta, consulte Gerir tenants.
Resolução de problemas
Seção intitulada “Resolução de problemas”Os erros de campo aparecem a vermelho por baixo do campo. Os outros erros aparecem como um toast vermelho. Um toast que começa por Failed to create tenant: (falha ao criar o tenant) vem do servidor.
Validação do formulário
Seção intitulada “Validação do formulário”| O que vê | Porquê | O que fazer |
|---|---|---|
| “Only workspace admins can create tenants.” e um botão Admin Access Required desativado | A sua função é membro ou visualizador | Peça a um admin do workspace que crie o tenant. |
| “Tenant name cannot be empty”, “Tenant name must be 100 characters or fewer” ou “Tenant name cannot contain line breaks or control characters” (o nome do tenant não pode estar vazio, tem de ter 100 caracteres ou menos, ou não pode conter quebras de linha nem caracteres de controlo) | O nome do tenant não cumpre uma regra | Corrija o nome. |
| “Azure AD Tenant ID is required” ou “Must be a valid Azure AD Tenant ID (UUID format)” (o Azure AD Tenant ID é obrigatório, ou tem de ser um Azure AD Tenant ID válido em formato UUID) | O tenant ID está em branco ou não é um UUID | Copie o Directory (tenant) ID da vista geral do registo da aplicação. |
| “Application (Client) ID is required” ou “Must be a valid Application (Client) ID (UUID format)” (o Application (Client) ID é obrigatório, ou tem de ser válido em formato UUID) | O client ID está em branco ou não é um UUID | Copie o Application (client) ID da vista geral do registo da aplicação. |
| “Client Secret is required” (o client secret é obrigatório) | O segredo está em branco | Cole o Value do segredo, não o Secret ID. |
| “Poll interval must be at least 5 minutes” ou “Poll interval cannot exceed 60 minutes” (o intervalo de consulta tem de ser de pelo menos 5 minutos, ou não pode exceder 60 minutos) | O intervalo está fora dos limites do formulário de criação | Introduza um número de 5 a 60. Pode definir um intervalo mais longo na página Edit mais tarde. |
| “At least one event type must be selected” (tem de estar selecionado pelo menos um tipo de evento) | Nenhum fluxo está assinalado | Assinale pelo menos um fluxo. |
| “Invalid event type submitted” (foi enviado um tipo de evento inválido) | A página enviou um fluxo que não está na lista permitida | Recarregue a página e selecione de novo os fluxos. |
Erros de criação
Seção intitulada “Erros de criação”| O que vê | Porquê | O que fazer |
|---|---|---|
| “Failed to create tenant: Microsoft rejected these credentials. Check the directory (tenant) ID, client ID and client secret.” (a Microsoft rejeitou estas credenciais; verifique o directory (tenant) ID, o client ID e o client secret) | A Microsoft recusou o pedido de token | Verifique os três valores. O segredo pode ter expirado, ou colou o Secret ID em vez do Value. |
| “Failed to create tenant: Could not verify these credentials with Microsoft. Try again in a few minutes.” (não foi possível verificar estas credenciais junto da Microsoft; tente de novo dentro de alguns minutos) | A Microsoft não respondeu | Tente de novo dentro de alguns minutos. |
| “Failed to create tenant: Microsoft Entra did not accept this client ID and client secret for that tenant, so it cannot be added. Check them and try again.” (o Microsoft Entra não aceitou este client ID e client secret para esse tenant, por isso não pode ser adicionado; verifique-os e tente de novo) | Workspace em período de avaliação. A Microsoft recusou as credenciais durante a verificação do período de avaliação. | Verifique os três valores, como acima. |
| “Failed to create tenant: Identiguard could not reach Microsoft Entra to check these credentials. Try again in a few minutes.” (o Identiguard não conseguiu contactar o Microsoft Entra para verificar estas credenciais; tente de novo dentro de alguns minutos) | Workspace em período de avaliação. A Microsoft não respondeu. | Tente de novo dentro de alguns minutos. |
| “Failed to create tenant: This Microsoft Entra tenant has already been used in another Identiguard trial, so it cannot be added to a new one. Choose a plan on the Billing page to add it, or contact Identiguard support.” (este tenant do Microsoft Entra já foi utilizado noutro período de avaliação do Identiguard, por isso não pode ser adicionado a um novo; escolha um plano na página Billing para o adicionar, ou contacte o suporte do Identiguard) | Workspace em período de avaliação. Outro período de avaliação já utilizou este diretório. | Escolha um plano pago, ou contacte o suporte do Identiguard. |
| “Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” (o plano permite até N tenants por workspace, e este workspace já tem M; atualize o plano para adicionar mais) | O workspace atingiu o limite de tenants do plano | Elimine um tenant de que já não precise, ou atualize o plano. Consulte Planos e faturação. |
| “Forbidden: You do not have permission to create tenants.” (proibido: não tem permissão para criar tenants) | A sua função mudou enquanto a página estava aberta | Peça a um admin do workspace. |
| “Failed to create tenant: Bad Request” (pedido inválido) | O servidor rejeitou o formulário | Verifique de novo todos os campos. Escale se continuar. |
| “Failed to create tenant: API error” ou “An unexpected error occurred: …” (erro da API, ou ocorreu um erro inesperado) | Um erro inesperado | Tente de novo e depois escale para a equipa de produto. |
| “Failed to create tenant: Server configuration error…” (erro de configuração do servidor) | Um problema da plataforma | Escale para um operador da plataforma. |
Depois da criação
Seção intitulada “Depois da criação”| O que vê | Porquê | O que fazer |
|---|---|---|
| Nenhuma confirmação depois de escolher Create Entra ID Tenant | A página Tenants não mostra uma mensagem de sucesso | Procure a nova linha em Tenant overview. |
| Ainda sem eventos | O Entra ID é consultado periodicamente, não envia eventos por iniciativa própria | Aguarde um intervalo de consulta. |
| Um toast “<tenant name> connection unhealthy” (ligação com problemas) com “Microsoft Graph rejected one or more enabled streams while others polled fine. Re-check the app registration permissions/licence for the subscribed event types.” (o Microsoft Graph rejeitou um ou mais fluxos ativados, enquanto outros foram consultados sem problemas; verifique de novo as permissões e a licença do registo da aplicação para os tipos de evento subscritos) | Um fluxo subscrito não tem a permissão ou a licença necessária. Causas típicas: inícios de sessão sem P1, risco de identidades de workload sem Workload ID Premium, ou AuditLog.Read.All não concedida. |
Conceda a permissão e o consentimento de administrador, ou desmarque esse fluxo. Consulte Alterar os eventos que um tenant envia. |
| Um toast “<tenant name> connection unhealthy” com “Microsoft Graph credentials rejected. Re-check the client ID and secret.” (credenciais do Microsoft Graph rejeitadas; verifique de novo o client ID e o segredo) | A Microsoft recusou todos os fluxos. O segredo expirou ou foi revogado. | Rode as credenciais. |
| Not granted numa permissão de relatórios | A permissão não foi adicionada, ou o consentimento de administrador não foi concedido | Adicione a permissão de application, escolha Grant admin consent e recarregue a página Edit. |
| “Could not load reporting permissions.” (não foi possível carregar as permissões de relatórios) | A verificação das permissões não carregou | Recarregue a página. |
| “Could not read the app registration permissions. Check the tenant credentials.” (não foi possível ler as permissões do registo da aplicação; verifique as credenciais do tenant) | O Identiguard não conseguiu iniciar sessão para ler o registo da aplicação | Rode as credenciais e depois recarregue a página. |