Pular para o conteúdo

Gerir tenants

A página Tenants é onde se criam, reveem, editam e removem os tenants de identidade de um workspace. Abra-a em Tenants na barra lateral.

Todos os membros do workspace podem abrir a página. Só os admins podem criar, editar ou eliminar um tenant.

O título da página é Tenants, com a descrição “Create, monitor, and manage identity tenants for this workspace.” (crie, monitorize e faça a gestão dos tenants de identidade deste workspace) É uma única página com secções empilhadas, de cima para baixo:

  1. Uma faixa de período de avaliação, apenas quando se aplica. Consulte Estado de saúde dos tenants.
  2. Create a tenant: três cartões.
  3. Tenant topology: uma imagem em tempo real dos tenants.
  4. Manage existing tenants: a tabela Tenant overview.
Cartão Legenda Guia
Okta Workforce identity Ligar o Okta
Auth0 Customer identity Ligar o Auth0
Entra ID Microsoft ecosystem Ligar o Microsoft Entra ID

Os admins escolhem Connect num cartão. 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 em cada cartão.

Cada plano permite um número de tenants por workspace.

Plano Tenants por workspace
Pro 3
Max 10
Super 25

A página Tenants não avisa quando o workspace está no limite, e os botões Connect continuam ativos. Fica a saber do limite quando submete o formulário de criação: “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.” (falha ao criar o tenant: o plano permite até N tenants por workspace, e este workspace já tem M; atualize o plano para adicionar mais) Elimine um tenant ou atualize o plano. Consulte Planos e faturação.

O cartão Manage existing tenants (“Review configured tenants, update integrations, and remove tenants when decommissioning access.”, ou seja, reveja os tenants configurados, atualize as integrações e remova tenants quando o acesso for desativado) contém a tabela Tenant overview.

Controlo O que faz
Search tenants… Filtra por nome ou tipo de tenant. A tabela volta à página 1.
Cabeçalhos de coluna Name, Type, Created Selecione um cabeçalho para ordenar. Selecione-o de novo para inverter a ordem.
Distintivo Type Mostra okta, auth0 ou microsoft. Um tenant do Entra ID aparece como microsoft.
Coluna Actions Botões de ícone, descritos abaixo.
Botões de página, Previous page, Next page A tabela mostra 5 tenants por página. O rodapé indica Showing X to Y of N tenants.

As ações são botões de ícone com tooltips. Não há botão de texto nem menu.

Ícone Tooltip Mostrado em Quem pode utilizar
Lápis Edit Todas as linhas Admins. Os restantes veem o tooltip “Admin access required to edit tenant” (é necessário acesso de admin para editar o tenant) e um botão desativado.
Gráfico de linhas API Metrics Apenas linhas do Auth0 Todos. Consulte Métricas de API do Auth0.
Caixote do lixo Delete tenant Todas as linhas Admins. Os restantes veem o tooltip “Admin access required to delete tenant” (é necessário acesso de admin para eliminar o tenant) e um botão desativado.
O que vê Significado
No tenants added yet com “Add a tenant using the options above to get started.” (ainda não foram adicionados tenants; adicione um tenant com as opções acima para começar) O workspace não tem tenants.
No tenants match your search com “Try a different name or tenant type.” (nenhum tenant corresponde à pesquisa; experimente outro nome ou tipo de tenant) A caixa de pesquisa exclui todos os tenants.

O cartão Tenant topology (“Animated view of tenant integrations connected to the Identiguard control plane.”, ou seja, vista animada das integrações de tenants ligadas ao plano de controlo do Identiguard) é uma imagem, não um controlo. Nada nele pode ser selecionado, e não tem legenda nem tooltips.

Elemento Significado
Cabeçalho “Avg requests per minute per tenant (last 24h)” (média de pedidos por minuto por tenant, últimas 24 horas) O que medem as etiquetas dos tenants
Distintivo Live view (verde) ou Refreshing… Se os valores estão carregados ou a carregar
Nó central Identiguard, “N connected tenant(s)”, “control plane” O workspace, com o número de tenants
Um nó colorido por tenant, com o nome e “X req/min” O tenant e o respetivo tráfego
Nó Alex AI no canto superior direito O estado do serviço Ask Alex: “AI service · Online” (verde), “AI service · Offline” (vermelho) ou “AI service · Checking…” (âmbar). Mostra “Last seen <time>” (visto pela última vez) quando é conhecido.
“+N more tenants not shown in this preview.” (mais N tenants não mostrados nesta pré-visualização) A imagem desenha no máximo 12 tenants
“No connected tenants to display yet.” (ainda não há tenants ligados para mostrar) O workspace não tem tenants

A topologia não é uma vista de estado de saúde. Um tenant com credenciais inválidas tem o mesmo aspeto que um tenant saudável, exceto que pode mostrar “0 req/min”. Consulte Estado de saúde dos tenants.

Escolha o ícone do lápis (Edit) numa linha para abrir Edit Tenant. Só os admins a podem abrir.

A página tem um ou dois cartões:

  • Tenant Configuration (“Update tenant details, subscriptions, and monitoring preferences.”, ou seja, atualize os detalhes do tenant, as subscrições e as preferências de monitorização), com os botões Save Changes e Cancel. Todos os fornecedores o têm.
  • Credentials, com o seu próprio botão Validate & save credentials. Apenas Okta e Entra ID.

Save Changes guarda tudo o que está em Tenant Configuration. O botão indica Saving… enquanto trabalha. Em caso de sucesso, regressa à página Tenants. Em caso de falha, aparece uma faixa com o título Error no topo da página Edit. Back to Tenants e Cancel saem sem guardar.

Secções por fornecedor:

Secção Okta Auth0 Entra ID
Basic Details Sim Sim Sim
Event Subscriptions Sim Sim Sim
Reporting permissions (optional) Não Não Sim
Agent Monitoring Sim Não Não
Cartão Credentials Sim Não Sim

Todos os fornecedores têm Tenant Name e Customer Name (texto de exemplo “Select or type a customer”, com sugestões do workspace). O nome do tenant segue as mesmas regras que na criação: obrigatório, 100 caracteres ou menos, sem quebras de linha.

Não é possível alterar o domínio ou o diretório de um tenant, em nenhum fornecedor. Elimine o tenant e crie-o de novo.

O Okta acrescenta:

  • Environment: Production ou Development.

O Entra ID acrescenta:

  • Poll Interval (Minutes): de 5 a 1440 (24 horas). O formulário de criação para nos 60, por isso é aqui que se define um intervalo mais longo.

O Auth0 mostra valores só de leitura:

Item O que mostra
Auth0 Domain O domínio do tenant
Provisioning Manual ou Deployed via Terraform
Log stream endpoint Apenas o URL do endpoint. O token nunca volta a ser mostrado.
Texto “Identiguard stores no Auth0 API credentials for this tenant.” (o Identiguard não guarda credenciais da API do Auth0 para este tenant) O log stream é gerido no dashboard do Auth0 ou na sua configuração Terraform. Para alterar o domínio, elimine e recrie o tenant.
Tenants manuais “Connection details are read-only. To change the domain or credentials, delete and recreate the tenant.” (os detalhes da ligação são só de leitura; para alterar o domínio ou as credenciais, elimine e recrie o tenant)
Tenants Terraform Uma caixa identiguard.tf com View Terraform configuration e Hide Terraform configuration, e um botão Copy (toast “Terraform configuration copied to clipboard”, ou seja, configuração Terraform copiada para a área de transferência). Uma nota diz que o token de ingestão não está neste ficheiro. Foi mostrado uma única vez na criação. Se se perder, elimine e recrie o tenant.
Jornadas sintéticas Um resumo das jornadas do tenant, ou “Synthetic journey monitoring is available on Max and Super plans.” (a monitorização de jornadas sintéticas está disponível nos planos Max e Super) quando as jornadas não estão ligadas para o workspace. Consulte Jornadas.

A página Edit do Auth0 não tem nada para o metric stream nem para os Action logs. Consulte Ligar o Auth0.

É nesta secção que se alteram os eventos que um tenant envia depois da criação. Tem o mesmo seletor que o formulário de criação, sob o título Subscribed Event Types.

Controlo O que faz
Search event types… Filtra a lista. Mostrado quando a lista tem mais de 10 tipos.
Select Recommended Apenas Auth0. Substitui toda a seleção pelo conjunto recomendado.
Select All Assinala todos os tipos. Enquanto pesquisa, passa a Select All Visible.
Clear All Desmarca tudo.
N of M selected A contagem atual. Tem de estar assinalado pelo menos um tipo.

O efeito de guardar é diferente para cada fornecedor:

Fornecedor Texto no ecrã Efeito de Save Changes
Okta “Updating this list changes the Okta event hook immediately.” (atualizar esta lista altera de imediato o event hook do Okta) O Identiguard reescreve de imediato o event hook na org do Okta.
Entra ID “Updating this list changes the Microsoft subscription immediately.” (atualizar esta lista altera de imediato a subscrição da Microsoft) O Identiguard consulta o novo conjunto de fluxos a partir da consulta seguinte.
Auth0 “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 e não é feita nenhuma alteração no Auth0) Só muda o que o Identiguard guarda. O stream do Auth0 continua a enviar tudo o que está configurado para enviar.

Para os passos da tarefa, consulte Alterar os eventos que um tenant envia.

Reporting permissions (optional) verifica o registo da aplicação em tempo real sempre que a página carrega. A instrução no ecrã indica “Add these as application permissions on the app registration in the Entra admin centre, then select Grant admin consent.” (adicione estas permissões como permissões de aplicação no registo da aplicação, no centro de administração do Entra, e depois selecione Grant admin consent)

Cada uma das seis linhas mostra Granted (concedida) ou Not granted (não concedida):

Permissão Utilizada para 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

Para corrigir uma linha Not granted:

  1. No centro de administração do Entra, abra o registo da aplicação e vá a API permissions.
  2. Adicione a permissão de application do Microsoft Graph em falta.
  3. Escolha Grant admin consent.
  4. Recarregue a página Edit. Não existe botão de atualizar.

Agent Monitoring (“Track AD and LDAP agent health on a recurring schedule.”, ou seja, acompanhe o estado de saúde dos agentes AD e LDAP de forma periódica) tem dois painéis: Monitor AD Agents e Monitor LDAP Agents. Requer o scope do Okta okta.agentPools.read.

Para ligar ou desligar um monitor, ou para alterar o respetivo intervalo:

  1. Abra Tenants e escolha o ícone do lápis (Edit) no tenant do Okta.
  2. Em Agent Monitoring, assinale ou desmarque Monitor AD Agents e Monitor LDAP Agents.
  3. Para cada monitor assinalado, escolha Check Interval (minutes): 5, 10, 15, 30, 60 ou 120. Enquanto um monitor está desmarcado, o texto de ajuda indica “Enable monitoring to configure the check interval.” (ative a monitorização para configurar o intervalo de verificação)
  4. Escolha Save Changes.
  5. Abra de novo a página Edit, ou veja o cartão do tenant no Dashboard, e leia Status: e Last check:.

Abrir a página Edit executa uma nova verificação de cada monitor que esteja ligado. Para o significado de cada estado, consulte Estado de saúde dos tenants.

O cartão Credentials (“Rotate the client secret (and optionally the client ID) used to connect to Okta.” ou “…to Microsoft.”, ou seja, rode o client secret, e opcionalmente o client ID, utilizado para ligar ao Okta ou à Microsoft) é um formulário separado. Save Changes não o submete.

Item Detalhe
Título Rotate credentials “New credentials are verified against Okta before being saved.” (ou Microsoft) (as novas credenciais são verificadas junto do Okta antes de serem guardadas)
Client ID (optional) Texto de exemplo “Enter new client ID (leave blank to keep current)” (introduza o novo client ID; deixe em branco para manter o atual)
Client Secret Texto de exemplo “Enter new client secret” (introduza o novo client secret)
Botão Validate & save credentials Indica Validating… enquanto verifica
Alerta Verified “Credentials updated and verified against Okta.” ou “…against Microsoft.” (credenciais atualizadas e verificadas junto do Okta ou da Microsoft)
Alerta Credentials rejected O motivo. Nada foi guardado.
Alerta Monitoring paused Mostrado quando um monitor se colocou em pausa. Consulte Estado de saúde dos tenants.

Para os passos, consulte Rodar credenciais.

  1. Abra Tenants e escolha o ícone do lápis (Edit).
  2. Em Basic Details, altere Tenant Name ou Customer Name. No Okta também pode alterar Environment.
  3. Escolha Save Changes.
  1. Abra Tenants e escolha o ícone do lápis (Edit) no tenant do Entra ID.
  2. Em Basic Details, defina Poll Interval (Minutes) de 5 a 1440.
  3. Escolha Save Changes.

Um intervalo mais longo significa que os eventos chegam mais tarde.

Só os admins podem eliminar um tenant. A eliminação não pode ser anulada. Remove do Identiguard os dados guardados do tenant: o histórico de eventos, os relatórios e o estado dos monitores. Também revoga os tokens de ingestão do tenant.

  1. Abra Tenants.
  2. Em Tenant overview, escolha o ícone do caixote do lixo (Delete tenant) na linha.
  3. Leia o diálogo Delete tenant: <name>. Indica o que o Identiguard remove e não remove do lado do fornecedor.
  4. Escolha o botão vermelho Delete tenant, ou Cancel.
  5. Aceite o pedido de confirmação do browser.

O diálogo fecha-se e a tabela é atualizada.

Fornecedor O que o Identiguard faz O que tem de fazer a seguir
Okta Desativa e remove o event hook do Okta e depois elimina o tenant. O diálogo mostra o Event Hook ID para que possa verificar a limpeza no Okta. Pode indicar “Loading…” ou “Event Hook ID not available” (Event Hook ID não disponível). Remova a integração Identiguard no Okta se o cliente estiver de saída.
Auth0, manual Nada no Auth0. O Identiguard não guarda credenciais do Auth0 e não pode remover os streams. Elimine o log stream, e o metric stream se existir, no dashboard do Auth0.
Auth0, Terraform Nada no Auth0. Execute terraform destroy, ou elimine o log stream no Auth0.
Entra ID Deixa de consultar o Microsoft Graph. Nada é alterado dentro do tenant do Entra ID. Revogue o segredo do registo da aplicação se já não precisar dele.

Force delete tenant não é uma opção permanente. Aparece apenas dentro do diálogo, e apenas depois de uma eliminação normal falhar porque o Identiguard não conseguiu remover o event hook do Okta. Na prática, aplica-se apenas a tenants do Okta.

  1. Uma eliminação normal falha com “Failed to delete tenant: Failed to remove Okta event hook.” (falha ao eliminar o tenant: falha ao remover o event hook do Okta)
  2. O diálogo mostra uma caixa vermelha Could not remove the Okta event hook: “Looks like the event hook has already been deleted on Okta, or Okta is not responding. You can force delete this tenant instead - its stored data (including event history) will be removed from Identiguard without making any further changes in Okta.” (parece que o event hook já foi eliminado no Okta, ou que o Okta não está a responder; em alternativa, pode forçar a eliminação deste tenant: os dados guardados, incluindo o histórico de eventos, são removidos do Identiguard sem mais alterações no Okta)
  3. O botão muda para Force delete tenant. Escolha-o.
  4. Aceite o pedido de confirmação do browser.
  5. No Okta, vá a Workflows → Event Hooks. Se o hook IG_Tenant_ deste tenant ainda existir, desative-o e elimine-o por si.
O que vê Porquê O que fazer
“Could not load tenants.” (não foi possível carregar os tenants) A lista de tenants não carregou Recarregue a página. Verifique que ainda tem acesso ao workspace.
“Only workspace admins can create tenants.” e Admin Access Required A sua função é membro ou visualizador Peça a um admin do workspace.
Lápis ou caixote do lixo desativado com “Admin access required to edit tenant” ou “Admin access required to delete tenant” A sua função é membro ou visualizador Peça a um admin do workspace.
Nenhum ícone de gráfico de linhas numa linha API Metrics existe apenas para tenants do Auth0 Nada.
Um tenant do Entra ID mostra microsoft O distintivo Type mostra o tipo guardado Nada. Pesquise microsoft para encontrar os tenants do Entra ID.
Nenhuma mensagem depois de criar ou editar um tenant A página Tenants não mostra uma confirmação Verifique a linha em Tenant overview.
“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 limite de tenants do plano Elimine um tenant ou atualize o plano.
“0 req/min” em todos os tenants da topologia Nenhum evento em 24 horas, ou os valores de tráfego não carregaram Recarregue a página e depois verifique o Dashboard.
“AI service · Offline” na topologia O serviço Ask Alex não está a responder Consulte Ask Alex.

Estas mensagens aparecem na faixa Error no topo da página Edit.

O que vê Porquê O que fazer
“At least one event type must be selected” (tem de estar selecionado pelo menos um tipo de evento) Nada está assinalado em Subscribed Event Types Assinale pelo menos um.
“Invalid Microsoft event type submitted” ou “Invalid Auth0 event type submitted” (foi enviado um tipo de evento inválido da Microsoft ou do Auth0) A página enviou um tipo que não está na lista permitida Recarregue a página e selecione de novo.
“Customer name cannot be empty” (o nome do cliente não pode estar vazio) Customer Name foi apagado Introduza o cliente.
“At least one field (…) must be provided for update.” (tem de ser indicado pelo menos um campo para a atualização) O formulário foi enviado sem nada para alterar Altere um valor e depois guarde.
“Failed to update Okta event hook: <Okta message>” (falha ao atualizar o event hook do Okta) O Okta rejeitou a atualização do hook. Causas comuns: o segredo expirou, ou falta um scope. Rode primeiro as credenciais e depois guarde 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. Não existe ecrã para recriar apenas o hook.
“Okta tenant configuration missing encrypted secrets; recreate the event hook before updating.”, “Failed to decrypt Okta credentials. Please recreate the event hook and try again.” ou “Okta configuration is missing client details; please recreate the tenant.” (faltam segredos encriptados na configuração do tenant do Okta, falha ao desencriptar as credenciais do Okta, ou faltam os detalhes do cliente na configuração do Okta) 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: <message>”, “Failed to update Microsoft tenant: <message>” ou “An unexpected error occurred: …” (falha ao atualizar o tenant do Auth0 ou da Microsoft, ou ocorreu um erro inesperado) 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 de admin para atualizar o tenant) Não é admin Peça a um admin do workspace.
“Editing is not supported for this tenant type.”, “Tenant not found” ou “Internal Server Error” (a edição não é suportada para este tipo de tenant, tenant não encontrado, ou erro interno do servidor) Um erro inesperado Escale para a equipa de produto.
“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.
Not granted numa permissão de relatórios A permissão está em falta, ou o consentimento de administrador não foi concedido Adicione a permissão, escolha Grant admin consent e recarregue a página.
“Synthetic journey monitoring is available on Max and Super plans.” As jornadas não estão ligadas para o workspace Requer o plano Max ou Super, e um operador da plataforma liga as jornadas para o workspace.
Uma caixa de seleção de agentes bloqueada com “Monitoring paused after repeated failures - rotate the credentials below to resume.” (monitorização em pausa após falhas repetidas; rode as credenciais abaixo para retomar) O monitor colocou-se em pausa Rode as credenciais.
Alerta Credentials rejected As novas credenciais falharam a verificação Consulte Rodar credenciais.
O que vê Porquê O que fazer
“Failed to delete tenant: Failed to remove Okta event hook.” e a caixa Could not remove the Okta event hook O Okta recusou ou não respondeu. O hook pode já ter sido eliminado, as credenciais podem estar revogadas, ou o Okta pode estar indisponível. Escolha Force delete tenant. Depois remova o hook no Okta manualmente, se ainda existir.
“Failed to delete tenant: Failed to cleanup tenant event history.”, “Failed to delete tenant: Failed to cleanup tenant monitor state.” ou “Failed to delete tenant: Failed to delete tenant report artifacts.” (falha ao limpar o histórico de eventos do tenant, o estado dos monitores do tenant, ou os artefactos de relatórios do tenant) Um passo interno de limpeza falhou. A eliminação forçada não é oferecida nestes casos. Tente de novo. Se se repetir, escale para a equipa de produto.
“Failed to delete tenant: API Error”, “An unexpected error occurred.” ou “Failed to delete tenant.” (erro da API, ocorreu um erro inesperado, ou falha ao eliminar o tenant) Um erro inesperado do servidor Tente de novo e depois escale.
“Forbidden: Insufficient permissions. Admin role required.” (proibido: permissões insuficientes; é necessária a função de admin) Não é admin Peça a um admin do workspace.
“Event Hook ID not available” no diálogo O tenant não tem um ID de hook guardado Apenas para informação. Pode eliminar na mesma.
O Auth0 mostra falhas de entrega no stream depois da eliminação O stream ainda aponta para o endpoint revogado Elimine o stream no Auth0, ou execute terraform destroy.