Gerir jornadas
Este guia cobre as tarefas do dia a dia relativas a jornadas sintéticas depois de gravadas.
O que é necessário
Seção intitulada “O que é necessário”- A função de admin para todas as tarefas que alteram alguma coisa. Os membros e os visualizadores só podem ler o histórico de execuções e os incidentes de jornada.
- Journeys na barra lateral. Está incluído a partir do plano Max, e é um operador da plataforma que o liga para o workspace.
- Acesso ao dashboard do Auth0 para as tarefas que alteram o utilizador de sonda.
Este guia utiliza dois menus:
- O menu do tenant está no cartão do tenant. A sua etiqueta é “More options for (tenant)”.
- O menu da linha está na linha de uma jornada. A sua etiqueta é “More actions for (journey)”.
Para gravar uma nova jornada, consulte Gravar uma jornada. Para saber o que significa cada estado e cada etiqueta, consulte Jornadas sintéticas.
Editar passos e verificar de novo
Seção intitulada “Editar passos e verificar de novo”Utilize este procedimento quando o cliente altera a página de início de sessão, quando uma verificação está errada, ou para concluir uma jornada que ficou em Awaiting first pass (a aguardar a primeira aprovação).
- Abra Journeys.
- Se a jornada estiver a falhar, clique na linha respetiva e abra a execução falhada. Tome nota do passo marcado como Stopped here (parou aqui) e escolha View screenshot.
- Abra o menu da linha e escolha Edit steps. Abre-se a página Edit steps: (name), com os distintivos “Tenant: (name)”, o tipo e Running ou Off.
- Altere os passos. Pode eliminar ou mover um passo, fornecer um valor, Add a check, Add Enter key press, Add MFA step, ou alterar Allowed hosts. O editor é o mesmo do assistente de gravação. Consulte o editor de passos.
- Escolha Save changes.
- Escolha Run a test e aguarde por The test run passed (A execução de teste passou).
- Escolha Start running.
O que a gravação faz:
| O que alterou | Resultado |
|---|---|
| Um passo, um valor ou um anfitrião permitido | O aviso Saving turns this journey off (Guardar desliga esta jornada) aparece antes de guardar. Depois de guardar, vê “Journey saved. It is off until a test run passes.” (Jornada guardada. Fica desligada até uma execução de teste passar.) A jornada passa para Awaiting first pass até um teste passar e escolher Start running. |
| Apenas o agendamento ou Run from | Vê “Journey saved.” (Jornada guardada.) A jornada fica como estava. |
Se não houver nada por guardar, Go to the test leva-o diretamente ao passo de teste. Utilize-o para concluir uma jornada em Awaiting first pass: escolha Edit steps, Go to the test, Run a test e, depois, Start running.
Não é possível mudar o nome de uma jornada, alterar o seu tipo ou alterar o seu URL inicial. Se a página mudou muito, elimine a jornada e grave-a de novo.
O que deve ver: a jornada de volta a Running e, depois, Passing.
Alterar o agendamento
Seção intitulada “Alterar o agendamento”Com que frequência é executada
- Na linha da jornada, abra o seletor de agendamento.
- Escolha o novo intervalo. Fica guardado de imediato, e vê “Schedule updated” (Agendamento atualizado).
As jornadas de registo (Registration) oferecem apenas Hourly, Daily e Weekly. Os outros tipos podem ser executados com uma frequência máxima de 5 em 5 minutos.
De onde é executada
- Abra o menu da linha e escolha Edit steps.
- Em Journey settings, Run from, assinale EU, US ou ambos. Pelo menos um tem de ficar assinalado.
- Escolha Save changes. A jornada continua ligada, porque nenhum passo foi alterado.
A página Edit steps é o único local onde se alteram as regiões depois de a jornada ter sido criada.
Pausar e retomar
Seção intitulada “Pausar e retomar”- Abra o menu da linha.
- Escolha Pause. Vê “Journey paused” (Jornada em pausa), e a jornada passa para Paused.
- Para a iniciar de novo, abra o menu da linha e escolha Resume. Vê “Journey resumed” (Jornada retomada).
Pause e Resume só aparecem depois de a jornada ter passado uma vez. Uma jornada em Awaiting first pass não tem nenhum dos dois.
Uma jornada em pausa não tem faixa no Live journey map e não é contada em Failing nem em Couldn’t finish.
Executar agora
Seção intitulada “Executar agora”- Na linha da jornada, escolha Run now. Vê “Run queued” (Execução em fila).
- A linha mostra Queued, depois Running now e, depois, o resultado. O cartão é atualizado de 5 em 5 segundos enquanto uma execução está em curso.
Run now fica desativado enquanto uma execução está em fila ou em curso. Não há outro tempo de espera entre execuções.
Eliminar
Seção intitulada “Eliminar”- Abra o menu da linha e escolha Delete.
- A confirmação indica “Delete (name)?” com “It stops running immediately. Past results are kept, but it would have to be recorded again.” (Deixa de ser executada de imediato. Os resultados anteriores são mantidos, mas teria de ser gravada de novo.)
- Escolha Delete journey. Vê “Journey deleted” (Jornada eliminada).
Um incidente de jornada aberto para essa jornada é fechado sem qualquer mensagem.
Emitir de novo as credenciais da sonda
Seção intitulada “Emitir de novo as credenciais da sonda”Utilize este procedimento quando a palavra-passe da sonda se perdeu, quando o utilizador de sonda foi eliminado no Auth0, ou quando as execuções mostram Probe credentials rejected (credenciais da sonda rejeitadas).
- Abra Journeys.
- Abra o menu do tenant e escolha Reissue probe credentials.
- Abre-se a caixa de diálogo New probe credentials, com o aviso “Copy the password now. It cannot be shown again.” (Copie a palavra-passe agora. Não pode ser mostrada de novo.) Escolha Copy ao lado da palavra-passe. O endereço de email é o mesmo de antes.
- No dashboard do Auth0, defina essa palavra-passe no utilizador de sonda. Se o utilizador foi eliminado, crie-o de novo com o mesmo endereço de email e a mesma connection.
- De volta ao Identiguard, escolha Done.
- Numa jornada, escolha Run now.
O que deve ver: a jornada mostra Passing.
Reset MFA
Seção intitulada “Reset MFA”Utilize este procedimento quando as execuções mostram um problema de MFA, como No stored secret for the multi-factor challenge (Não há um segredo guardado para o desafio multifator), ou quando o utilizador de sonda foi inscrito com um dispositivo que o Identiguard não detém.
A reposição tem duas metades, e ambas são necessárias. O Identiguard não consegue repor o MFA no Auth0 por si.
- No dashboard do Auth0, reponha o MFA do utilizador de sonda.
- Em Journeys, abra o menu do tenant e escolha Reset MFA.
- A confirmação indica “Reset MFA for the probe on (tenant)?” (Repor o MFA da sonda no tenant?). Escolha Reset MFA.
- Vê “MFA reset. Now reset MFA for the probe user in the Auth0 dashboard.” (MFA reposto. Reponha agora o MFA do utilizador de sonda no dashboard do Auth0.) Se ainda não fez o passo 1, faça-o agora.
- Numa jornada com um passo de MFA, escolha Run now. Espera-se que a sonda inscreva o seu próprio fator nessa execução. Isto não está confirmado para todos os métodos de MFA. Se a execução continuar a parar no MFA, grave a jornada de novo e faça a inscrição com Fill code ou com a passkey do gravador.
A palavra-passe da sonda não é alterada.
O que deve ver: a jornada mostra Passing, e o cartão do tenant mostra de novo o distintivo do fator depois de “MFA”.
Remover a monitorização de jornadas
Seção intitulada “Remover a monitorização de jornadas”- Abra o menu do tenant e escolha Remove journey monitoring.
- A confirmação indica “Remove journey monitoring from (tenant)?” com “Recorded journeys are deleted too. The Auth0 accounts are not; you will be told which to remove.” (As jornadas gravadas também são eliminadas. As contas do Auth0 não. Ser-lhe-á indicado quais deve remover.)
- Escolha Remove monitoring.
- Tome nota dos endereços na mensagem “Monitoring removed. Delete these in Auth0: (addresses)” (Monitorização removida. Elimine estes no Auth0). A lista contém o endereço da sonda e os endereços utilizados por execuções de registo anteriores. Se não houver nada para eliminar, a mensagem indica “Monitoring removed”.
- No dashboard do Auth0, elimine esses utilizadores.
O que deve ver: o tenant volta para Not set up yet (ainda não configurado), no fundo da página Journeys. Os incidentes de jornada abertos para o tenant são fechados sem qualquer mensagem.
Ler o histórico de execuções e os incidentes de jornada
Seção intitulada “Ler o histórico de execuções e os incidentes de jornada”Qualquer member ou viewer o pode fazer.
- Comece pela faixa no topo de Journeys. Em “N journeys failing: (journey) on (tenant)” (N jornadas a falhar), escolha o nome da jornada, que é uma ligação, para saltar para a linha respetiva.
- Na linha, leia o estado. Vermelho com Failing ou com uma etiqueta de falha é uma falha real. Cinzento ou âmbar com Couldn’t finish: (reason) é um problema do script de monitorização: “Our script, not your outage” (O nosso script, não uma falha do seu serviço).
- Tome nota de Down since (date and time) se houver uma indisponibilidade aberta, ou de Slow se houver uma lentidão aberta.
- Passe o cursor sobre as barras da faixa de histórico para ver a região, a duração e o motivo de cada execução. Escolha View run para abrir essa execução.
- Ou clique na linha para abrir as execuções recentes: as últimas 50, 5 por página. As execuções falhadas vêm abertas por predefinição.
- Numa execução falhada, leia a lista de passos. Stopped here marca o passo em que a execução terminou. Escolha View screenshot para ver a página em que a sonda estava.
- Abra Incidents (N) no fundo do cartão do tenant. Para uma indisponibilidade, leia o tempo de indisponibilidade (“at least N min”, pelo menos N min), o número de verificações falhadas e o motivo. Para uma lentidão, leia durante quanto tempo esteve lenta e o pico em comparação com o tempo habitual.
Os incidentes de jornada cobrem os últimos 30 dias. São independentes da página Incidentes. Para as regras que os abrem e fecham, consulte Incidentes de jornada.
Se não funcionar
Seção intitulada “Se não funcionar”| O que vê | Porquê | O que fazer |
|---|---|---|
| Não há Run now, seletor de agendamento nem menu da linha | Não é admin | Peça a um admin do workspace |
| Não há Pause nem Resume no menu da linha | A jornada nunca passou | Execute primeiro um teste que passe. Consulte Editar passos e verificar de novo. |
| Uma jornada em Awaiting first pass passou com Run now mas não está em execução | Uma aprovação não inicia o agendamento | Procure a jornada em Paused e escolha Resume. Se ainda estiver em Awaiting first pass, utilize Edit steps, Go to the test, Run a test, Start running. |
| “The change did not save” (A alteração não foi guardada) | Uma pausa, uma retoma, uma alteração de agendamento, uma execução ou uma eliminação falhou, por exemplo um agendamento que o tipo de jornada não permite | Tente de novo e leia o pormenor na mensagem |
| “This journey already has a run in flight.” (Esta jornada já tem uma execução em curso.) | Já há uma execução em fila ou em curso | Aguarde até terminar |
| “Journey monitoring is switched off for this tenant.” (A monitorização de jornadas está desligada para este tenant.) | A monitorização do tenant está desligada | A equipa de documentação não conseguiu confirmar como ligá-la de novo a partir desta página. Escale para a equipa de produto. |
| “Journey monitoring was disabled automatically after repeated failures. Resolve that first.” (A monitorização de jornadas foi desativada automaticamente depois de falhas repetidas. Resolva isso primeiro.) | 5 resultados Probe credentials rejected consecutivos | Reissue probe credentials e defina a palavra-passe no Auth0. Se as execuções continuarem a ser recusadas, escale para a equipa de produto. |
| “This tenant is backing off after recent failures. Try again shortly.” (Este tenant está em espera depois de falhas recentes. Tente de novo dentro de momentos.) | O Identiguard está a aguardar depois de falhas repetidas | Aguarde e, depois, tente de novo |
| “Saving turns this journey off” | Alterou um passo, um valor ou um anfitrião | É o esperado. Guarde, Run a test e, depois, Start running. |
| “Leave without saving your changes?” (Sair sem guardar as alterações?) com “The journey stays as it was saved.” (A jornada fica como foi guardada.) | Está a sair de Edit steps com alterações por guardar | Fique e guarde, ou saia para descartar as alterações |
| “Could not switch the journey on” (Não foi possível ligar a jornada) | A jornada não passou num teste | Execute primeiro um teste que passe |
| “Could not reissue the credentials”, “Could not reset MFA” ou “Could not remove monitoring” (Não foi possível emitir de novo as credenciais, repor o MFA ou remover a monitorização) | Um erro do servidor | Tente de novo |
| “The journey settings changed while this was being removed. Try again.” (As definições da jornada mudaram enquanto isto estava a ser removido. Tente de novo.) | Alguém alterou as jornadas no mesmo momento | Tente de novo |
| “Could not load the runs” (Não foi possível carregar as execuções) com “The request did not come back.” (O pedido não obteve resposta.) | O histórico de execuções não foi carregado | Escolha Retry |
| “No screenshot was taken for this step.” (Não foi tirada nenhuma captura de ecrã neste passo.) | Não foi captada nenhuma captura de ecrã para essa falha | Utilize a lista de passos |
Para o significado de cada resultado de execução, consulte a Resolução de problemas em Jornadas sintéticas.