Renovar credenciais
Substitua o client secret que o Identiguard utiliza para se ligar ao Okta ou ao Entra ID. Os mesmos passos retomam um monitor que entrou em pausa por si.
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.
- Acesso de administrador à plataforma de identidade, para criar o novo segredo.
- Qualquer plano.
Renovar um segredo do Okta ou do Entra ID
Seção intitulada “Renovar um segredo do Okta ou do Entra ID”- Crie o novo segredo na plataforma de identidade. Não elimine ainda o antigo.
- Okta: abra a integração do Identiguard na Okta Admin Console e gere um novo client secret.
- Entra ID: abra o registo da aplicação, vá para Certificates & secrets e crie um novo client secret. Copie o Value, e não o Secret ID. Tome nota da data de expiração.
- No Identiguard, abra Tenants.
- Em Tenant overview, escolha o ícone do lápis (Edit) na linha do tenant.
- Desça até ao cartão Credentials. Rotate credentials é o título do formulário que está dentro dele.
- Cole o novo segredo em Client Secret.
- Deixe Client ID (optional) em branco para manter o client ID atual. Preencha-o apenas se o client ID mudou, por exemplo com um novo registo de aplicação.
- Escolha Validate & save credentials. O botão indica Validating… enquanto o Identiguard verifica o segredo junto do Okta ou da Microsoft.
- Confirme o alerta Verified com “Credentials updated and verified against Okta.” (Credenciais atualizadas e verificadas junto do Okta.) ou “Credentials updated and verified against Microsoft.” (Credenciais atualizadas e verificadas junto da Microsoft.)
- Elimine o segredo antigo na plataforma de identidade.
O Identiguard verifica as novas credenciais junto da plataforma antes de as guardar. Se a verificação falhar, vê o alerta Credentials rejected (credenciais rejeitadas) com o motivo, o segredo antigo mantém-se e a monitorização continua como antes.
Retomar um monitor em pausa
Seção intitulada “Retomar um monitor em pausa”O Identiguard coloca em pausa um monitor de agentes do Okta ou a consulta do Entra ID depois de 5 verificações falhadas seguidas. Consulte Estado dos tenants. Uma renovação bem-sucedida é a única forma de retomar. Não há um botão de retoma separado.
Sabe que um monitor está em pausa quando vê um destes sinais:
- A notificação <nome do tenant> connection unhealthy (ligação não saudável).
- O alerta Monitoring paused (monitorização em pausa) no cartão Credentials.
- Para os agentes do Okta, Status: Paused after repeated failures (em pausa depois de falhas repetidas) e uma caixa de verificação bloqueada em Agent Monitoring.
- Um email com o assunto Monitoring disabled for <nome do tenant> (Monitorização desativada para o tenant).
Passos:
- Escolha Review settings na notificação. Ou abra Tenants e escolha o ícone do lápis (Edit) no tenant.
- Desça até ao cartão Credentials e confirme o alerta Monitoring paused.
- Crie um novo segredo no Okta ou no Entra ID. Se o segredo ainda for válido e a falha tiver sido noutro ponto, tenha à mão o segredo atual.
- Introduza o Client Secret. Introduza o Client ID (optional) apenas se tiver mudado.
- Escolha Validate & save credentials.
- Aguarde pelo alerta Verified.
A monitorização recomeça de imediato. O alerta Monitoring paused desaparece, as caixas de verificação dos agentes são desbloqueadas e o estado do monitor indica “Credentials updated. Awaiting next check.” (Credenciais atualizadas. A aguardar a verificação seguinte.) até a verificação seguinte ser executada.
O Identiguard não guarda credenciais do Auth0. A página Edit de um tenant Auth0 não tem o cartão Credentials, e não há nada para renovar do lado do Auth0.
O que existe são até três tokens que o Auth0 utiliza para enviar dados para o Identiguard. Cada um é mostrado uma só vez, quando é criado.
| Token | Pode substituí-lo o próprio? |
|---|---|
| Token do log stream | Não. Não pode ser emitido de novo. Elimine o tenant e crie-o de novo. |
| Token do metric stream | Não existe um ecrã para isto. Contacte a equipa de produto. |
| Token dos Action logs | Não existe um ecrã para isto. Contacte a equipa de produto. |
Substituir um token de log stream perdido ou exposto
Seção intitulada “Substituir um token de log stream perdido ou exposto”- Abra Tenants e escolha o ícone do lápis (Edit) no tenant Auth0. Tome nota do nome do tenant, do nome do cliente e dos tipos assinalados em Event Subscriptions.
- Volte a Tenants e elimine o tenant com o ícone do caixote do lixo (Delete tenant). Consulte Gerir tenants.
- Em Create a tenant, escolha Connect no cartão Auth0 e crie o tenant de novo. Consulte Ligar o Auth0.
- Copie o novo Endpoint URL e o novo Authorization token (shown once).
- No Auth0, edite o log stream existente. Substitua o payload URL e o valor do cabeçalho
Authorization. Com Terraform, aplique de novo com os novos valores deidentiguard.tfeterraform.tfvars. - Se o tenant antigo tinha um metric stream ou Action logs, configure-os de novo. Os respetivos endpoints e tokens também são novos.
O que deve ver
Seção intitulada “O que deve ver”- O alerta Verified imediatamente depois de guardar.
- Nenhuma notificação <nome do tenant> connection unhealthy depois de recarregar a aplicação.
- Para o Okta, em Agent Monitoring, um Status: diferente de Paused after repeated failures depois da verificação seguinte.
- Para o Entra ID, novos eventos depois da consulta seguinte.
Evitar a surpresa
Seção intitulada “Evitar a surpresa”Os segredos do Entra ID têm uma data de expiração. Coloque um lembrete no calendário do serviço um mês antes.
Se não funcionar
Seção intitulada “Se não funcionar”Todas estas mensagens aparecem no alerta Credentials rejected, salvo indicação em contrário. Quando o vê, nada foi guardado e o segredo antigo continua guardado.
| O que vê | Porquê | O que fazer |
|---|---|---|
| “Client secret is required.” (O client secret é obrigatório.) | Client Secret está em branco | Cole o segredo. |
| “Client ID is required.” (O client ID é obrigatório.) | O tenant Okta não tem um client ID guardado | Introduza também o client ID em Client ID (optional). |
| “Okta rejected these credentials: authentication failed. Check the client ID and secret.” (O Okta rejeitou estas credenciais: a autenticação falhou. Verifique o client ID e o segredo.) | O Okta recusou o início de sessão, ou a integração não consegue ler os agent pools | Verifique o segredo e o client ID. Verifique se a integração concede okta.agentPools.read. |
| “Could not verify these credentials with Okta. Try again shortly.” (Não foi possível verificar estas credenciais junto do Okta. Tente de novo dentro de momentos.) | O Okta não respondeu | Tente de novo dentro de alguns minutos. |
| “Microsoft rejected these credentials: <descrição>” ou “Microsoft rejected these credentials: Credentials rejected” (A Microsoft rejeitou estas credenciais) | A Microsoft recusou o início de sessão | Verifique se colou o Value do segredo e se este não expirou. Se o registo da aplicação mudou, introduza também o novo client ID. |
| “Microsoft tenant configuration is missing the stored client ID; provide a new client ID.” (Falta o client ID guardado na configuração do tenant Microsoft. Forneça um novo client ID.) ou “Failed to read the stored Microsoft client ID; provide a new client ID.” (Falha ao ler o client ID Microsoft guardado. Forneça um novo client ID.) | O Identiguard não consegue ler o client ID guardado | Introduza também o client ID em Client ID (optional). |
| “Microsoft tenant configuration is missing the directory tenant ID; recreate the tenant.” (Falta o ID do tenant do diretório na configuração do tenant Microsoft. Recrie o tenant.) | A configuração guardada está danificada | Elimine o tenant e crie-o de novo. Escale para a equipa de produto. |
| “Okta tenant configuration is missing the domain; recreate the tenant.” (Falta o domínio na configuração do tenant Okta. Recrie o tenant.), “Okta tenant configuration is missing its encryption key; recreate the tenant.” (Falta a chave de encriptação na configuração do tenant Okta. Recrie o tenant.) ou “Failed to access the Okta tenant encryption key; recreate the tenant.” (Falha ao aceder à chave de encriptação do tenant Okta. Recrie o tenant.) | A configuração guardada está danificada | Elimine o tenant e crie-o de novo. Escale para a equipa de produto. |
| “Identiguard stores no Auth0 credentials. Manage the log stream in the Auth0 dashboard or in your Terraform configuration.” (O Identiguard não guarda credenciais do Auth0. Faça a gestão do log stream no dashboard do Auth0 ou na sua configuração Terraform.) | Foi enviada uma renovação para um tenant Auth0 | Não há nada para renovar. Consulte Auth0. |
| “Forbidden: Insufficient permissions. Admin role required to rotate credentials.” (Proibido: permissões insuficientes. É necessária a função Admin para renovar credenciais.) | Não é admin | Peça a um admin do workspace. |
| A caixa de verificação em Agent Monitoring continua bloqueada | A renovação não teve sucesso, ou a página está desatualizada | Procure o alerta Verified e, depois, recarregue a página. |
| A notificação volta depois de uma renovação bem-sucedida | Uma falha diferente, como uma permissão ou uma licença em falta num stream do Entra ID | Leia o texto da notificação e consulte Estado dos tenants. |