Alterar os eventos que um tenant envia
Altere os tipos de evento que um tenant recolhe, sem ter de criar o tenant de novo.
O que é necessário
Seção intitulada “O que é necessário”- A função de admin no workspace. Os membros e os visualizadores não conseguem abrir a página Edit.
- Qualquer plano.
- Para o Okta: credenciais válidas no tenant. O Identiguard atualiza o event hook no Okta quando guarda.
Abrir a lista de eventos
Seção intitulada “Abrir a lista de eventos”Estes passos são iguais para todos os fornecedores.
- Abra Tenants na barra lateral.
- Em Tenant overview, escolha o ícone do lápis (dica Edit) na linha do tenant. Abre-se a página Edit Tenant.
- Desça até Event Subscriptions. A lista está em Subscribed Event Types, com um contador N of M selected (N de M selecionados).
Os controlos:
| Controlo | O que faz |
|---|---|
| Search event types… | Filtra a lista. Aparece quando a lista tem mais de 10 tipos. |
| Select All | Assinala todos os tipos. Durante uma pesquisa, passa a Select All Visible e assinala apenas os tipos que estão no ecrã. |
| Clear All | Desmarca tudo. Tem de assinalar pelo menos um tipo antes de guardar. |
| Select Recommended | Apenas Auth0. Substitui toda a sua seleção pelo conjunto recomendado. |
- Abra a lista de eventos como indicado acima.
- Assinale os tipos a adicionar e desmarque os tipos a remover.
- Escolha Save Changes.
O Identiguard reescreve de imediato o event hook na organização Okta. A página indica: “Updating this list changes the Okta event hook immediately.” (Atualizar esta lista altera de imediato o event hook do Okta.) O Okta deixa de enviar os tipos que removeu e começa a enviar os tipos que adicionou.
O Identiguard só apresenta tipos que o Okta aceita num event hook.
- Abra a lista de eventos como indicado acima. Cada código aparece como uma descrição seguida do código entre parênteses.
- Assinale ou desmarque códigos. Para voltar à predefinição, escolha Select Recommended.
- Escolha Save Changes.
A página indica: “Updating this list changes which Auth0 log events are ingested. Takes effect immediately; no changes are made in Auth0.” (Atualizar esta lista altera os eventos de log do Auth0 que são ingeridos. Tem efeito imediato. Nada é alterado no Auth0.)
Select Recommended não acrescenta à sua seleção. Substitui-a. O Auth0 publica 185 códigos de evento de log. O conjunto recomendado exclui as trocas de tokens por sessão e os envios por canal, os códigos substituídos por outro e os códigos que o Auth0 não documenta. Se assinalou códigos adicionais à mão, assinale-os de novo depois.
Entra ID
Seção intitulada “Entra ID”No caso do Entra ID, a lista contém cinco streams, e não tipos de evento individuais.
- Abra a lista de eventos como indicado acima.
- Assinale ou desmarque streams.
- Escolha Save Changes.
O Identiguard consulta o novo conjunto de streams a partir da consulta seguinte. A página indica: “Updating this list changes the Microsoft subscription immediately.” (Atualizar esta lista altera de imediato a subscrição da Microsoft.)
Antes de adicionar um stream, verifique se o registo da aplicação tem a permissão e a licença de que o stream precisa:
| Stream | Precisa de |
|---|---|
| Risky users | IdentityRiskyUser.Read.All |
| Risk detections | IdentityRiskEvent.Read.All |
| Directory audits | AuditLog.Read.All |
| Sign-ins | AuditLog.Read.All e Entra ID P1 |
| Workload identity risk | A licença Workload ID Premium, IdentityRiskyServicePrincipal.Read.All e IdentityRiskEvent.Read.All |
Um stream sem a respetiva permissão ou licença falha em todas as consultas, e o tenant aparece como não saudável. Consulte Ligar o Microsoft Entra ID.
O que deve ver
Seção intitulada “O que deve ver”- Regressa à página Tenants depois de Save Changes. Não há mensagem de confirmação.
- Quando abre de novo a página Edit, o contador N of M selected mostra o novo número.
- Okta: na Okta Admin Console, em Workflows → Event Hooks, o hook
IG_Tenant_lista o novo conjunto de eventos. - Os novos eventos dos tipos adicionados aparecem no Dashboard. No caso do Entra ID, aguarde pela consulta seguinte.
Se não funcionar
Seção intitulada “Se não funcionar”Os erros aparecem numa faixa com o título Error no topo da página Edit.
| O que vê | Porquê | O que fazer |
|---|---|---|
| Um ícone do lápis desativado com “Admin access required to edit tenant” (É necessário acesso de admin para editar o tenant) | A sua função é member ou viewer | Peça a um admin do workspace. |
| “At least one event type must be selected” (Tem de estar selecionado pelo menos um tipo de evento) | Nada está assinalado | Assinale pelo menos um tipo. |
| “Invalid Microsoft event type submitted” ou “Invalid Auth0 event type submitted” (Foi enviado um tipo de evento Microsoft ou Auth0 inválido) | A página enviou um tipo que não está na lista permitida | Recarregue a página e selecione de novo. |
| “Failed to update Okta event hook: <mensagem do Okta>” (Falha ao atualizar o event hook do Okta) | O Okta rejeitou a atualização. Causas comuns: o client secret expirou ou a integração perdeu um scope. | Renove as credenciais e guarde a lista de novo. |
| “Okta event hook ID missing from configuration; recreate the event hook before updating.” (Falta o ID do event hook do Okta na configuração. Recrie o event hook antes de atualizar.) | O tenant não tem um ID de hook guardado | Elimine o tenant e crie-o de novo. Consulte Gerir tenants. |
| “Okta tenant configuration missing encrypted secrets; recreate the event hook before updating.” (Faltam os segredos encriptados na configuração do tenant Okta. Recrie o event hook antes de atualizar.) ou “Failed to decrypt Okta credentials. Please recreate the event hook and try again.” (Falha ao desencriptar as credenciais do Okta. Recrie o event hook e tente de novo.) | As credenciais guardadas não podem ser utilizadas | Elimine o tenant e crie-o de novo. Escale para a equipa de produto. |
| “Failed to update Auth0 tenant: <mensagem>” ou “Failed to update Microsoft tenant: <mensagem>” (Falha ao atualizar o tenant Auth0 ou Microsoft) | Um erro do servidor | Tente de novo e, depois, escale. |
| “Forbidden: Insufficient permissions. Admin role required to update tenant.” (Proibido: permissões insuficientes. É necessária a função Admin para atualizar o tenant.) | Não é admin | Peça a um admin do workspace. |
| O Auth0 continua a enviar os códigos que desmarcou | A lista é um filtro apenas no Identiguard | Não há nada de errado. Altere o stream no Auth0 se quiser que o Auth0 deixe de os enviar. |
| Depois de adicionar um stream do Entra ID, uma notificação “<nome do tenant> connection unhealthy” (ligação não saudável) com “Microsoft Graph rejected one or more enabled streams while others polled fine…” (O Microsoft Graph rejeitou um ou mais streams ativos, enquanto os outros foram consultados sem problemas…) | O novo stream não tem a respetiva permissão ou licença | Conceda a permissão e o consentimento de administrador no Entra ID, ou desmarque de novo o stream. |
| Um detetor deixou de disparar depois de remover um tipo | O detetor precisa desse tipo de evento | Assinale de novo o tipo. Consulte a referência de detetores. |