Pular para o conteúdo

Ligar o Okta

O Okta envia eventos para o Identiguard através de um event hook. O Identiguard cria o hook por si, depois de lhe indicar os detalhes da integração Identiguard na sua org do Okta.

O que é necessário:

  • Acesso de administrador à org do Okta, com permissão para gerir integrações de serviço de API.
  • API Access Management ativado em Security → API.
  • 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. Inicie sessão na Okta Admin Console.
  2. Vá a Applications → Applications e escolha Browse App Catalog.
  3. Procure Identiguard e escolha Add Integration.
  4. Reveja o acesso que é pedido e escolha Install & Authorize.
  5. Copie o client secret. O Okta mostra-o uma única vez.
  6. Deixe a página aberta. No passo seguinte precisa do domínio do Okta e do client ID que lá estão.
  1. Abra o workspace e vá a Tenants.
  2. Em Create a tenant, localize o cartão Okta (legenda Workforce identity) e escolha Connect. Abre-se a página Add New Okta Tenant.
  3. Preencha o formulário. Todos os campos estão descritos na tabela abaixo.
  4. Em Event Subscriptions, assinale os tipos de evento a recolher. Nada está assinalado quando a página abre, e tem de assinalar pelo menos um. Select All assinala todos os tipos.
  5. Opcionalmente, em Agent Monitoring, assinale Monitor AD Agents ou Monitor LDAP Agents e escolha um Check Interval (minutes).
  6. Escolha Create Okta Tenant. O botão indica Creating… enquanto o Identiguard trabalha.
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 Obrigatório. O campo sugere nomes de clientes já utilizados no workspace.
Basic Details Okta Domain Obrigatório. O URL base da org, como https://login.example.com.
Basic Details Environment Obrigatório. Production ou Development.
Basic Details Client ID Obrigatório. Vem da integração Identiguard no Okta.
Credentials Client Secret Obrigatório. O segredo que o Okta mostrou uma única vez.
Event Subscriptions Subscribed Event Types Pelo menos um. O contador mostra N of M selected.
Agent Monitoring Monitor AD Agents, Monitor LDAP Agents Opcional. Ambos estão desligados por predefinição.
Agent Monitoring Check Interval (minutes) Aparece quando o monitor está assinalado. Uma lista fixa: 5, 10, 15, 30, 60 ou 120 minutos. O valor predefinido é 15.

Os distintivos no topo da página mostram o workspace, Okta tenant e N event types selected. Back to Tenants e Cancel saem sem guardar.

  • Search event types… filtra a lista.
  • Select All assinala todos os tipos. Enquanto pesquisa, passa a Select All Visible e assinala apenas os tipos visíveis no ecrã.
  • Clear All desmarca tudo.
  • O rodapé mostra Showing N event types.

O Identiguard só apresenta os tipos de evento que o Okta aceita num event hook. Se não tiver a certeza do que recolher, Select All é um bom ponto de partida, e pode remover mais tarde os tipos com demasiado ruído. Consulte Alterar os eventos que um tenant envia.

  1. Num workspace em período de avaliação, o Identiguard começa por iniciar sessão na org do Okta com o client ID e o segredo, para provar que a controla. Uma org do Okta só pode ser utilizada num único período de avaliação.
  2. O Identiguard cria um event hook na org do Okta, verifica-o e ativa-o. O nome do hook é IG_Tenant_<tenant name>_<environment>_WS_<first 8 characters of the workspace ID>.
  3. Regressa à página Tenants.
  1. No Okta, vá a Workflows → Event Hooks.
  2. Abra o hook que o Identiguard criou e vá a Preview.
  3. Escolha um tipo de evento qualquer e escolha Deliver Request.
  4. No Identiguard, abra Dashboard. O evento aparece em Real-time events.
Scope do Okta Utilizado para
okta.eventHooks.manage, okta.eventHooks.read Criar e verificar o event hook
okta.logs.read Ler o system log para os relatórios
okta.users.read, okta.factors.read As secções de utilizadores e de MFA dos relatórios
okta.features.read A lista de funcionalidades ativadas nos detalhes do tenant
okta.agentPools.read A monitorização dos agentes AD e LDAP

O Identiguard não altera nada no Okta além do seu próprio event hook.

  • O Okta rejeita um hook inteiro se este incluir um tipo de evento que os hooks não suportam. O Identiguard só apresenta os tipos que o Okta aceita.
  • Não é possível alterar o domínio do Okta mais tarde. Para mudar para outra org, elimine o tenant e crie-o de novo.
  • Eliminar o tenant no Identiguard também desativa e remove o event hook no Okta. Remova também a integração no Okta se o cliente estiver de saída. Consulte Gerir tenants.
  • Para alterar mais tarde os tipos de evento, a monitorização de agentes ou o nome, consulte Gerir tenants.
  • Para alterar o segredo mais tarde, consulte Rodar credenciais.

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.

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.
Abre a página de criação e volta a Tenants Só os admins podem abrir a página de criação Peça a um admin do workspace.
“Tenant name cannot be empty” (o nome do tenant não pode estar vazio) Tenant Name está em branco Introduza um nome.
“Tenant name must be 100 characters or fewer” (o nome do tenant tem de ter 100 caracteres ou menos) O nome é demasiado longo Encurte-o.
“Tenant name cannot contain line breaks or control characters” (o nome do tenant não pode conter quebras de linha nem caracteres de controlo) O nome foi colado com caracteres ocultos Escreva o nome manualmente.
“Customer name is required” (o nome do cliente é obrigatório) Customer Name está em branco Introduza o cliente.
“Okta domain is required” (o domínio do Okta é obrigatório) Okta Domain está em branco Introduza o URL da org.
“Enter Okta base URL (e.g., https://login.example.com)” (introduza o URL base do Okta) O domínio não é um URL base válido Introduza o URL da org com https:// e sem caminho.
“Environment is required” (o ambiente é obrigatório) Nenhum ambiente está escolhido Escolha Production ou Development.
“Client ID is required” ou “Client secret is required” (o client ID é obrigatório, ou o client secret é obrigatório) O campo está em branco Copie o valor da integração no Okta.
“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 tipo.
“Invalid event type submitted” (foi enviado um tipo de evento inválido) A página enviou um tipo que não está na lista permitida Recarregue a página e selecione de novo os tipos.
O que vê Porquê O que fazer
“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.
“Failed to create tenant: This Okta org 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.” (esta org do Okta já foi utilizada noutro período de avaliação do Identiguard, por isso não pode ser adicionada a um novo; escolha um plano na página Billing para a adicionar, ou contacte o suporte do Identiguard) Workspace em período de avaliação. Outro período de avaliação já utilizou esta org. Escolha um plano pago, ou contacte o suporte do Identiguard.
“Failed to create tenant: Identiguard could not sign in to this Okta org with the client ID and client secret provided, so it cannot be added. Check them and try again.” (o Identiguard não conseguiu iniciar sessão nesta org do Okta com o client ID e o client secret indicados, por isso não pode ser adicionada; verifique-os e tente de novo) Workspace em período de avaliação. O Okta recusou o client ID e o segredo. Verifique os dois valores. Verifique que a integração está instalada e autorizada no Okta.
“Failed to create tenant: Identiguard could not reach this Okta org to check the client ID and client secret. Try again in a few minutes.” (o Identiguard não conseguiu contactar esta org do Okta para verificar o client ID e o client secret; tente de novo dentro de alguns minutos) Workspace em período de avaliação. O Okta não respondeu. Verifique o domínio e tente de novo dentro de alguns minutos.
“Failed to create tenant: Failed to create Okta Event Hook: <Okta message>” (falha ao criar o event hook do Okta) O Okta rejeitou o hook. Causas comuns: credenciais erradas, falta o scope okta.eventHooks.manage, ou a org atingiu o seu limite de event hooks. Leia a mensagem do Okta. Corrija as credenciais ou o scope e tente de novo.
“Failed to create tenant: Failed to verify Okta Event Hook: <Okta message>” (falha ao verificar o event hook do Okta) A chamada única de verificação do Okta ao Identiguard falhou Tente de novo. Se se repetir, escale para a equipa de produto.
“Failed to create tenant: Failed to activate Okta Event Hook: <Okta message>” (falha ao ativar o event hook do Okta) O Okta recusou ativar o hook No Okta, abra Workflows → Event Hooks e remova qualquer hook IG_Tenant_ que tenha ficado deste tenant. Depois tente de novo.
“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.
O que vê Porquê O que fazer
Nenhuma confirmação depois de escolher Create Okta Tenant A página Tenants não mostra uma mensagem de sucesso Procure a nova linha em Tenant overview.
Nenhum evento no Dashboard Ainda não aconteceu nada na org, ou o hook não está ativo Envie um evento de teste (passo 3). No Okta, verifique que o hook IG_Tenant_ está Active.
Um toast “<tenant name> connection unhealthy” (ligação com problemas) Uma verificação de agentes foi recusada Consulte Estado de saúde dos tenants.