Canais de alerta
Os canais de alerta enviam eventos do Identiguard para os locais onde a equipa já trabalha. Existem três: Slack, Microsoft Teams e email.
Quem pode utilizar
Seção intitulada “Quem pode utilizar”| Requisito | Detalhe |
|---|---|
| Plano | Max ou Super |
| Ligado para o workspace | Um operador da plataforma liga os canais de alerta para cada workspace. Até lá, Alerts não aparece na barra lateral. |
| Função | Só os admins podem alterar as definições. Os membros e os visualizadores podem abrir a página. Veem a faixa Read-only: only workspace admins can change alert settings. (só de leitura: apenas os admins do workspace podem alterar as definições de alertas) e todos os controlos ficam desativados. |
Abra Alerts em Workspace na barra lateral.
O que é enviado
Seção intitulada “O que é enviado”- Eventos com severidade igual ou superior à severidade mínima do canal, dos tenants incluídos no âmbito do canal.
- Resultados das jornadas sintéticas, conforme a tabela abaixo.
| Resultado da jornada | Severidade | Slack | Teams | |
|---|---|---|---|---|
| Falha confirmada: duas falhas reais seguidas a partir de uma região | ERROR |
Sim | Sim | Sim |
| Recuperação | ERROR |
Sim | Sim | Não |
| Lentidão | WARN |
Sim | Sim | Não |
A severidade mínima do canal aplica-se também aos resultados das jornadas. Um canal do Teams deixado no valor predefinido ERROR nunca recebe lentidões. Defina-o como WARN se as quiser receber.
Atualmente os incidentes não são enviados para os canais. Trate-os na página Incidents.
Os três canais
Seção intitulada “Os três canais”| Canal | Como se liga | Severidade mínima predefinida | Opções de severidade |
|---|---|---|---|
| Slack | Um URL de incoming webhook do Slack | WARN |
DEBUG, INFO, WARN, ERROR, CRITICAL |
| Microsoft Teams | O URL HTTP de um fluxo do Power Automate | ERROR |
DEBUG, INFO, WARN, ERROR, CRITICAL |
| Uma lista de destinatários | ERROR |
WARN, ERROR, CRITICAL |
Cada canal tem o seu próprio cartão e, ao lado, o seu próprio cartão Tenant forwarding scope (âmbito de encaminhamento por tenant).
Os cartões Slack e Microsoft Teams
Seção intitulada “Os cartões Slack e Microsoft Teams”Os dois cartões têm os mesmos controlos.
| Controlo | O que faz |
|---|---|
| Chip de estado Live ou Off | Mostra o estado guardado. Não muda enquanto não guardar. |
| Enable Slack forwarding ou Enable Microsoft Teams forwarding | Uma caixa de seleção. Quando está assinalada e guardada, os eventos são enviados para os tenants selecionados. |
| Minimum severity | Só são encaminhados os eventos deste nível ou superior. DEBUG encaminha tudo. |
| Slack webhook URL ou Microsoft Teams webhook URL | Onde se cola o URL. Depois de um URL estar guardado, o cartão mostra-o mascarado, com Replace. |
| Destination e Set by | O anfitrião do webhook guardado, uma impressão digital do URL, quem o guardou e quando, em UTC |
| Save changes | Guarda o cartão. O botão mostra Saving… |
| Send test message | Publica uma mensagem de teste. Fica disponível depois de um URL ter sido guardado. O botão mostra Sending… |
| Disconnect | Para o encaminhamento e elimina o URL de webhook guardado |
Save changes fica desativado quando o encaminhamento está assinalado e não há nenhum tenant selecionado, e quando é necessário um URL e o campo está vazio.
As mensagens são Alert settings saved. (definições de alertas guardadas), Test message sent. (mensagem de teste enviada) e Channel disconnected. (canal desligado).
Endereços de webhook permitidos
Seção intitulada “Endereços de webhook permitidos”| Canal | O URL tem de |
|---|---|
| Slack | Utilizar HTTPS e estar em hooks.slack.com ou hooks.slack-gov.com |
| Microsoft Teams | Utilizar HTTPS, estar num anfitrião terminado em .logic.azure.com ou .logic.azure.us, e ter /workflows/ no caminho |
Os redirecionamentos não são seguidos. Cole o URL final.
No Teams, o URL vem de um fluxo do Power Automate que utiliza o acionador When a Teams webhook request is received. Os eventos chegam como um Adaptive Card. Os conectores antigos do Office 365 no Teams foram descontinuados pela Microsoft e não são suportados. Consulte Enviar alertas para o Teams.
Substituir um webhook
Seção intitulada “Substituir um webhook”- No cartão, escolha Replace ao lado do URL mascarado.
- Cole o novo URL e escolha Save changes.
- Escolha Send test message.
Verificar quem definiu o destino
Seção intitulada “Verificar quem definiu o destino”O bloco Destination e Set by permite verificar que os alertas continuam a ir para um local que controla.
- Se a pessoa que guardou o webhook saiu do workspace, o cartão avisa que o endereço dela “is not a member of this workspace. Check that this destination still belongs to you, or replace it.” (não é membro deste workspace; verifique que este destino ainda lhe pertence, ou substitua-o)
- Um webhook mais antigo mostra “Not recorded: stored before Identiguard recorded this. Replace the webhook to record it.” (não registado: guardado antes de o Identiguard registar esta informação; substitua o webhook para a registar)
Desligar
Seção intitulada “Desligar”Disconnect abre o diálogo Disconnect this channel? com este texto: “Event forwarding stops immediately and the stored webhook URL is deleted. You can reconnect later by pasting a new webhook URL.” (o encaminhamento de eventos para de imediato e o URL de webhook guardado é eliminado; pode voltar a ligar mais tarde colando um novo URL de webhook) Escolha Disconnect para confirmar.
Só o Slack e o Teams têm Disconnect.
O cartão Email
Seção intitulada “O cartão Email”| Controlo | O que faz |
|---|---|
| Chip de estado Live ou Off | Mostra o estado guardado |
| Enable email forwarding | Uma caixa de seleção. Fica desativada até que um destinatário esteja confirmado. Até lá, o cartão indica Add and confirm at least one recipient first. (primeiro adicione e confirme pelo menos um destinatário) |
| Minimum severity | WARN, ERROR ou CRITICAL |
| Email recipients | A lista de endereços, cada um com um distintivo e um botão de remover. Vazia, indica No recipients yet. (ainda sem destinatários) |
| O campo de endereço e Add recipient | Adiciona um endereço. O botão mostra Adding… |
| Save changes | Guarda a caixa de seleção, a severidade e o âmbito de tenants |
| Send test email | Envia um teste a todos os destinatários confirmados |
Não existe Disconnect no cartão Email. Para parar os alertas por email, desmarque Enable email forwarding e escolha Save changes, ou remova os destinatários.
Destinatários
Seção intitulada “Destinatários”| Distintivo | Significado |
|---|---|
| Confirmed | O endereço recebe alertas |
| Awaiting confirmation | Um endereço exterior ao workspace que ainda não confirmou. Não recebe nada. |
| No longer a member, not mailed | O endereço foi adicionado como membro do workspace, e essa pessoa entretanto saiu. Não recebe nada. |
Enquanto escreve um endereço, uma indicação diz-lhe o que vai acontecer:
- “This address is a workspace member, so it starts receiving alerts immediately.” (este endereço é de um membro do workspace, por isso começa a receber alertas de imediato)
- “An address outside this workspace receives a confirmation email first and gets nothing until someone with access to that inbox clicks the link.” (um endereço exterior a este workspace recebe primeiro um email de confirmação e não recebe mais nada até que alguém com acesso a essa caixa de correio clique na ligação)
As mensagens são Recipient added. (destinatário adicionado) para um membro e Confirmation email sent. The address receives alerts once confirmed. (email de confirmação enviado; o endereço recebe alertas depois de confirmado) para um endereço exterior.
Um canal pode ter no máximo 25 destinatários. Para mais pessoas, utilize o endereço de uma lista de distribuição.
Para remover um destinatário, escolha o botão de remover na linha. O diálogo Remove this recipient? explica que o endereço deixa de receber emails de alerta e que um endereço exterior tem de confirmar de novo se o voltar a adicionar. Escolha Remove. Vê Recipient removed. (destinatário removido).
O que vê um destinatário exterior
Seção intitulada “O que vê um destinatário exterior”O email de confirmação tem uma ligação. Não é necessário iniciar sessão.
- A ligação abre Confirm alert emails. A página diz que um admin do workspace pediu para enviar alertas de segurança do Identiguard para o endereço, e que nada é enviado até a pessoa confirmar.
- A pessoa escolhe Confirm this address.
- A página mostra Address confirmed.
A ligação é válida durante 72 horas. Uma ligação expirada, já utilizada ou substituída mostra This link is not valid (esta ligação não é válida).
Não existe botão de reenvio. Para enviar um novo email de confirmação, remova o endereço e adicione-o de novo.
O limite por hora
Seção intitulada “O limite por hora”O email está limitado a 50 emails de alerta por hora para o workspace.
- Quando o limite é atingido, os destinatários recebem um único email de aviso. Diz que o workspace atingiu o limite de 50 emails de alerta nesta hora e que os emails de alerta seguintes ficam em pausa até começar a hora seguinte.
- Os outros alertas dessa hora não são enviados por email. Todos os eventos continuam no feed de eventos.
- Um email de teste conta para os mesmos 50.
Tenant forwarding scope
Seção intitulada “Tenant forwarding scope”Ao lado de cada cartão de canal está um cartão Tenant forwarding scope. Decide que tenants esse canal recebe.
- Cada canal tem o seu próprio âmbito.
- Os novos tenants são de adesão manual. Um novo tenant não é adicionado a nenhum canal até que o assinale.
- O cartão mostra uma contagem Selected tenants e uma caixa de seleção para cada tenant, com o nome e o tipo. Há 8 tenants por página.
- Sem tenants, indica No tenants in this workspace yet. (ainda não há tenants neste workspace)
- Uma alteração só tem efeito depois de Save changes no cartão do canal.
Escolher o que cada canal recebe
Seção intitulada “Escolher o que cada canal recebe”Um padrão comum é um canal do Slack movimentado em WARN para a equipa de IAM, e o email em CRITICAL para o responsável de segurança.
Limites
Seção intitulada “Limites”| Limite | Valor |
|---|---|
| Publicações no Slack e no Teams | 20 por minuto para cada destino |
| Emails de alerta | 50 por hora para cada workspace |
| Destinatários de email | 25 para cada canal |
| Validade da ligação de confirmação | 72 horas |
Durante uma avalanche de eventos, os eventos ERROR e CRITICAL são enviados primeiro para o Slack e o Teams. Os restantes são resumidos na mensagem seguinte. A entrega de alertas nunca atrasa o feed de eventos.
A faixa de problemas de entrega
Seção intitulada “A faixa de problemas de entrega”Quando alertas para o Slack ou o Teams ficaram retidos ou não puderam ser entregues, o cartão mostra uma faixa. Indica o número de alertas, desde quando, e a hora mais recente. Termina assim: “This workspace’s alerts to this channel are limited to a steady rate, and the rest are summarised on the next message. Every event is still in the event feed.” (os alertas deste workspace para este canal estão limitados a um ritmo constante, e os restantes são resumidos na mensagem seguinte; todos os eventos continuam no feed de eventos)
Se a vir com frequência, aumente a Minimum severity ou selecione menos tenants.
Resolução de problemas
Seção intitulada “Resolução de problemas”A página
Seção intitulada “A página”| O que vê | Porquê | O que fazer |
|---|---|---|
| Alerts não está na barra lateral, ou a página mostra Alert integrations are disabled for this workspace. (as integrações de alertas estão desativadas para este workspace) | Os canais de alerta não estão ligados para o workspace, ou o plano é inferior a Max. | Peça a um operador da plataforma que ligue os canais de alerta. Verifique o plano. |
| Read-only: only workspace admins can change alert settings. | É membro ou visualizador. | Peça a um admin. |
| Failed to save alert settings. (falha ao guardar as definições de alertas) ou Test message failed. (a mensagem de teste falhou) | O servidor não devolveu uma mensagem utilizável. | Tente de novo. Se continuar, indique ao suporte a hora e a página. |
Slack e Teams
Seção intitulada “Slack e Teams”| O que vê | Porquê | O que fazer |
|---|---|---|
| Slack webhook URL is required., …is invalid., …must use HTTPS., …host is not allowed. ou …path is invalid. (o URL de webhook do Slack é obrigatório, é inválido, tem de utilizar HTTPS, o anfitrião não é permitido, ou o caminho é inválido) | O URL está vazio, não é HTTPS, não está num anfitrião do Slack permitido, ou não tem caminho. | Cole o URL completo do incoming webhook do Slack. |
| Teams webhook URL is required., …is invalid. ou …must use HTTPS. (o URL de webhook do Teams é obrigatório, é inválido, ou tem de utilizar HTTPS) | O URL está vazio ou mal formado. | Cole o URL HTTP do fluxo do Power Automate. |
| Teams webhook URL host is not allowed. Use a Power Automate Workflows URL (logic.azure.com). (o anfitrião do URL de webhook do Teams não é permitido; utilize um URL de Workflows do Power Automate) | O URL é de um conector antigo do Office 365, ou está noutro anfitrião. | Crie um fluxo de Workflows e utilize o URL dele. |
| Teams webhook URL does not look like a Workflows trigger. Classic Office 365 connectors are retired and are not supported. (o URL de webhook do Teams não parece ser de um acionador de Workflows; os conectores clássicos do Office 365 foram descontinuados e não são suportados) | O caminho não tem /workflows/. |
Utilize o URL do acionador When a Teams webhook request is received. |
| webhookUrl is required when configuring this channel for the first time. (o webhookUrl é obrigatório ao configurar este canal pela primeira vez) ou A webhook URL is not configured for this channel. (não há um URL de webhook configurado para este canal) | Guardou, ativou ou testou sem um URL guardado. | Cole o URL e guarde primeiro. |
| At least one tenant must be selected when forwarding is enabled. (tem de estar selecionado pelo menos um tenant quando o encaminhamento está ativado), ou Save changes está desativado | Nenhum tenant está assinalado. | Assinale tenants em Tenant forwarding scope. |
| selectedTenantIds contains tenant IDs outside this workspace. (selectedTenantIds contém IDs de tenants exteriores a este workspace) | A página está desatualizada. Um tenant foi eliminado. | Recarregue a página. |
| This channel is not configured. (este canal não está configurado) | Testou antes de guardar pela primeira vez. | Guarde primeiro. |
| Slack test message failed: webhook returned um código de estado, ou Microsoft Teams test message failed: webhook returned um código de estado (a mensagem de teste falhou: o webhook devolveu esse código) | O Slack ou o Power Automate recusou a publicação. Causas habituais: o webhook foi revogado, ou o fluxo foi eliminado ou desligado. | Crie de novo o webhook ou o fluxo, depois escolha Replace e cole o novo URL. |
| Uma mensagem de teste falhou com webhook redirected e redirects are not followed (o webhook foi redirecionado; os redirecionamentos não são seguidos) | O URL redireciona para outro endereço. | Utilize o URL final. |
| A faixa de problemas de entrega | Mais de 20 publicações por minuto, ou o destino falhou. | Aumente a severidade mínima ou selecione menos tenants. Os eventos continuam no feed. |
| Um endereço “is not a member of this workspace. Check that this destination still belongs to you, or replace it.” | O admin que guardou o webhook saiu do workspace. | Verifique o destino. Se não tiver a certeza, escolha Replace. |
| O que vê | Porquê | O que fazer |
|---|---|---|
| Add and confirm at least one recipient first. ou Add at least one confirmed recipient before enabling email alerts. (adicione pelo menos um destinatário confirmado antes de ativar os alertas por email) | Nenhum destinatário está confirmado. | Adicione o endereço de um membro do workspace, ou aguarde que um endereço exterior confirme. |
| A valid email address is required. (é necessário um endereço de email válido) | O endereço está mal formado. | Corrija-o. |
| That address is already a recipient. (esse endereço já é destinatário) | O endereço já está na lista. | Nada a fazer. |
| A channel can have at most 25 recipients. (um canal pode ter no máximo 25 destinatários) | O limite foi atingido. | Remova um, ou utilize uma lista de distribuição. |
| Too many confirmation emails have gone to that address recently. Try again later. (foram enviados demasiados emails de confirmação para esse endereço recentemente; tente mais tarde), This workspace has reached its limit of N alert confirmation emails in 24 hours. Try again tomorrow. (este workspace atingiu o limite de N emails de confirmação em 24 horas; tente amanhã) ou Confirmation emails cannot be sent right now. Try again in a few minutes. (não é possível enviar emails de confirmação neste momento; tente dentro de alguns minutos) | Um limite de emails de confirmação, ou uma falha temporária. | Aguarde e tente de novo. |
| O distintivo Awaiting confirmation não muda | A pessoa não escolheu a ligação, ou a ligação de 72 horas expirou. | Remova o endereço e adicione-o de novo para enviar um novo email. |
| O distintivo No longer a member, not mailed | A pessoa foi adicionada como membro e saiu do workspace. | Remova o endereço. Adicione-o de novo se a pessoa ainda dever receber alertas. Nesse caso confirma como endereço exterior. |
| This link is not valid na página de confirmação | A ligação expirou ao fim de 72 horas, já foi utilizada, foi substituída por uma mais recente, ou o destinatário foi removido. | Um admin remove o endereço e adiciona-o de novo. |
| No confirmed recipients yet. Add one and confirm it first. (ainda não há destinatários confirmados; adicione um e confirme-o primeiro) | Enviou um teste sem nenhum destinatário confirmado. | Confirme primeiro um destinatário. |
| This workspace has used its 50 alert emails for this hour. Try the test again after the hour rolls over. (este workspace já utilizou os 50 emails de alerta desta hora; repita o teste depois de a hora mudar) | O limite por hora está esgotado. | Aguarde pela hora seguinte. Considere uma severidade mínima mais alta para o email. |
| The test email could not be sent to any recipient. (não foi possível enviar o email de teste a nenhum destinatário) | O envio falhou para todos os endereços. | Tente de novo. Verifique os endereços. |
Não chega nada, embora o chip indique Live
Seção intitulada “Não chega nada, embora o chip indique Live”| Verificação | O que fazer |
|---|---|
| O evento está abaixo da Minimum severity do canal? | Baixe o nível, ou teste com um evento mais grave. |
| O tenant está assinalado em Tenant forwarding scope? | Os novos tenants não são adicionados automaticamente. Assinale-o e guarde. |
| Escolheu Save changes? | O chip mostra apenas o estado guardado. Guarde e depois verifique o chip. |
É uma lentidão de jornada num canal em ERROR? |
As lentidões são enviadas em WARN, apenas para o Slack e o Teams. Baixe o canal para WARN. |
| Foi atingido um limite? | Procure a faixa de problemas de entrega, ou o email de aviso do limite por hora. |
| O destino ainda funciona? | Escolha Send test message ou Send test email. |
Para outros problemas, consulte Resolução de problemas.