Skip to main content
A integração com o Microsoft Teams envia notificações do Living Security a usuários e canais por meio do aplicativo Living Security para Teams. Utilize-a para atribuições de treinamento, alertas de risco humano, mensagens de implantação e comunicados da equipe de segurança. Esta integração é somente para notificações. Os usuários não enviam comandos ao bot no Microsoft Teams. Quando o aplicativo é instalado, o bot armazena a referência de conversa do Teams para futuras notificações proativas. As mensagens de instalação são unidirecionais e podem ser personalizadas ou desativadas de acordo com os requisitos de implantação da empresa.
Um administrador do Microsoft Teams ainda precisa carregar, aprovar e distribuir o aplicativo Living Security para Teams. O consentimento do administrador do Microsoft Entra User.Read.All é opcional e habilita apenas a busca alternativa por e-mail ou nome principal do usuário (UPN).
Para configurar o envio de Nudges e Playbooks, acesse Configurações → Comunicações → Canais e clique no cartão Microsoft Teams. Esta página aborda a configuração do aplicativo Teams em si.

Pré-requisitos

Antes de configurar o Microsoft Teams, verifique se você dispõe de:
  • Um administrador do Microsoft Teams que possa carregar e aprovar aplicativos da organização. A mesma pessoa pode ocupar ambas as funções de administrador.
  • Um administrador do Microsoft Entra, somente se você quiser habilitar a busca alternativa opcional por e-mail/UPN com consentimento de aplicativo User.Read.All em todo o tenant
  • Privilégios de administrador do Living Security
  • Uma organização ativa no Living Security
  • Os nomes da equipe e do canal onde os comunicados de segurança devem ser entregues, se os comunicados em canais estiverem habilitados
  • O ID do tenant do Microsoft Entra, disponível em Microsoft Entra admin center → Identidade → Visão geral

Quem faz o quê

Essas funções podem ser exercidas por pessoas diferentes. Compartilhe com o administrador do Microsoft Teams o checksum do pacote, o ID do aplicativo Teams, o ID do aplicativo do bot e o público previsto para a implantação. Compartilhe a URL de consentimento gerada com um administrador do Microsoft Entra somente ao habilitar a busca alternativa opcional por e-mail/UPN. Não compartilhe outras credenciais do Living Security que não estejam relacionadas.

Configuração

1

Abra o painel de configuração do Microsoft Teams

No Living Security, acesse Configurações → Comunicações → Canais e selecione Microsoft Teams.O painel exibe a região da sua organização, o nome do arquivo do pacote, o ID do aplicativo Teams, o ID do aplicativo do bot, o checksum SHA256, o status da configuração do tenant da Microsoft, as instruções de instalação, os controles de mensagens de instalação, a validação e as ferramentas de notificação de teste.
A região exibida no Living Security corresponde à região em que sua organização está hospedada.
2

Conecte o tenant da Microsoft

Em Connect your tenant, informe o ID do tenant do Microsoft Entra proprietário dos usuários e dos canais do Teams que receberão as notificações e clique em Save Microsoft tenant. Um tenant da Microsoft pode pertencer a apenas uma organização do Living Security.Se o controle do tenant não estiver disponível, entre em contato com o responsável pela implementação do Living Security ou com o suporte para conectar ou alterar o tenant antes de instalar o aplicativo.
O Living Security exibe Microsoft tenant connected antes de você prosseguir.
Sempre que possível, conecte o tenant antes de instalar o aplicativo Teams. Se o aplicativo já estiver instalado, salve o tenant e selecione Validate install primeiro. O Living Security tenta associar automaticamente a instalação existente; reinstale somente se a validação não conseguir detectá-la.
3

Baixe o pacote regional do Teams

Clique em Download Teams package. O Living Security fornece um pacote ZIP específico da região para a sua organização.Verifique o arquivo baixado comparando-o com o checksum SHA256 exibido no Living Security antes de alterar qualquer coisa. Para dar ao aplicativo o seu próprio nome e ícones, siga Personalizar a marca do pacote regional após essa verificação e antes de carregar o pacote.
O checksum do arquivo baixado corresponde ao checksum SHA256 exibido no Living Security.
4

Carregue e instale o pacote no centro de administração do Teams

No centro de administração do Microsoft Teams, acesse Teams apps → Manage apps → Actions → Upload new app e carregue o arquivo ZIP baixado do Living Security.Confirme:
  • O ID do aplicativo Teams e o ID do aplicativo do bot correspondem aos valores exibidos no Living Security
  • O nome do aplicativo é o nome regional do Living Security ou o nome que você definiu, caso tenha personalizado a marca do pacote
  • O editor é Living Security. A personalização da marca do pacote não altera o editor
  • O aplicativo está desbloqueado
  • O aplicativo está disponível para os usuários ou grupos previstos
  • O aplicativo está instalado por meio de políticas de configuração de aplicativos ou de instalação direcionada para os usuários e as equipes/canais que devem receber as notificações
A Microsoft pode levar algum tempo para propagar a disponibilidade do aplicativo e as alterações nas políticas de configuração.
Se a validação ou um teste falhar imediatamente após uma alteração na política de aplicativos, confirme a atribuição da política no centro de administração do Microsoft Teams e tente novamente depois que a Microsoft concluir a propagação.
5

Instale ou abra o aplicativo

Distribua o aplicativo pessoal aos usuários previstos. Para que o Living Security possa enviar um teste pessoal a uma instalação detectada, pelo menos um usuário deve instalar ou abrir o aplicativo pessoal do Living Security no Microsoft Teams. Isso permite que o bot capture a identidade confiável do usuário e a referência da conversa pessoal. Uma instalação em canal, por si só, não pode ser usada para um teste pessoal em instalação detectada.Para o envio por canal, instale o aplicativo na equipe e no canal previstos para que o bot possa capturar a referência de conversa desse canal.
Um usuário de destino instalou ou abriu o aplicativo pessoal, ou o aplicativo está instalado no canal previsto.
6

Configure as mensagens de instalação

Na seção Install message controls, escolha se as mensagens de instalação do Teams serão enviadas e personalize o texto unidirecional para a sua organização.Controles disponíveis:
  • Send install messages
  • Send personal install messages
  • Send channel install messages
  • Default message
  • Personal message
  • Channel message
Os campos de mensagem oferecem suporte a {{installerName}}, que é resolvido para o nome de exibição do usuário que instalou o aplicativo. Deixe uma mensagem pessoal ou de canal em branco para usar a mensagem padrão configurada. Se a mensagem padrão também estiver em branco, o Living Security usa a mensagem integrada para esse escopo.
7

Valide a configuração

Clique em Validate install no Living Security. A validação verifica se o pacote regional está disponível, se a configuração do tenant da Microsoft está presente e é exclusiva desta organização do Living Security, se as credenciais do bot regional estão configuradas e se uma instalação ativa do aplicativo foi detectada para o tenant conectado.
A validação exibe Validation passed antes de você enviar notificações reais.
8

Envie notificações de teste

Para o teste pessoal padrão, clique em Send test to detected installation. O Living Security seleciona uma instalação pessoal ativa detectada e usa a identidade confiável e a referência de conversa armazenadas. Esse teste não chama o Microsoft Graph e não exige o consentimento User.Read.All.Se nenhuma instalação pessoal for detectada, peça a um usuário que instale ou abra o aplicativo pessoal do Living Security, selecione Validate install novamente e, em seguida, reenvie o teste. Use o teste avançado direcionado por e-mail/UPN somente quando a busca alternativa opcional estiver habilitada.
A notificação de teste unidirecional aparece no Microsoft Teams.
Consulte a tentativa correspondente no Log de comunicações quando forem necessários diagnósticos de entrega.

Personalizar a marca do pacote regional

O pacote regional é um arquivo ZIP com três arquivos: manifest.json, color.png e outline.png. Você pode definir o nome e os ícones do seu aplicativo nesse pacote antes de carregá-lo. O Living Security oferece suporte a esse procedimento para pacotes regionais carregados diretamente por um administrador do Teams. Faça isso depois de baixar e verificar o pacote e antes de carregá-lo no centro de administração do Teams.
1

Descompacte o pacote

Extraia o arquivo ZIP. Ele contém exatamente três arquivos na raiz do arquivo compactado: manifest.json, color.png e outline.png.
2

Substitua os ícones

Substitua color.png e outline.png por seus próprios ícones. Mantenha os mesmos dois nomes de arquivo.
3

Defina o nome do aplicativo

Em manifest.json, edite estes dois campos:
  • name.short — o nome exibido no cabeçalho do aplicativo no Teams e em outras áreas com espaço limitado. Máximo de 30 caracteres.
  • name.full — o nome exibido no catálogo de aplicativos e nos detalhes do aplicativo. Máximo de 100 caracteres.
    Se um aplicativo do Living Security já tiver sido carregado no centro de administração do Teams, defina version com um valor superior à versão instalada ali. O Microsoft Teams recusa uma atualização que não aumente a versão, e um novo download pode ter a mesma versão do pacote já instalado ou uma versão inferior.Consulte a versão instalada no centro de administração do Teams, em Teams apps → Manage apps, na página de detalhes do aplicativo. Compare-a com o valor de version no manifest.json que você acabou de baixar e defina um valor superior a ambos. Mantenha o formato MAJOR.MINOR.PATCH de três números.Por exemplo, se o aplicativo instalado for 1.1.1 e o novo download for 1.1.0, defina 1.1.2. Aumentar o 1.1.0 baixado para 1.1.1 repetiria a versão instalada, e o Teams recusaria o upload.
4

Deixe os campos de identidade inalterados

Não altere estes campos. Cada um deles carrega a identidade do aplicativo, do bot ou do logon único:
  • id
  • botId em bots
  • webApplicationInfo
  • validDomains
  • contentUrl e websiteUrl em staticTabs
    Uma alteração em um campo de identidade pode deixar o aplicativo instalável, mas incapaz de entregar notificações ou concluir o logon único. Validate install verifica o tenant, as credenciais do bot e a instalação detectada. Ele não compara o seu manifesto com o pacote criado pelo Living Security.
5

Compacte novamente os três arquivos

Crie um novo arquivo ZIP com os três arquivos. Coloque-os na raiz do arquivo compactado, sem pasta envolvente. O Microsoft Teams recusa um pacote cujo manifest.json esteja dentro de uma pasta.
6

Carregue e verifique

Carregue o arquivo ZIP com a marca personalizada no centro de administração do Teams, volte ao Living Security e clique em Validate install. Envie uma notificação de teste.
A validação exibe Validation passed, e a notificação de teste chega ao Microsoft Teams com o nome e os ícones do seu aplicativo.

Editor e checksum

A personalização da marca define o nome e os ícones do aplicativo. Ela não altera duas coisas:
  • O editor continua sendo o Living Security. Os campos developer do manifesto citam o Living Security e apontam para o site, a política de privacidade e os termos de serviço do Living Security. Em conjunto, eles identificam a empresa que opera o serviço; por isso, o Teams continua exibindo Living Security como editor na página de detalhes do aplicativo, nas caixas de diálogo de consentimento de permissões e nos relatórios de uso do aplicativo. O seu nome e os seus ícones são o que os usuários veem no cabeçalho do aplicativo, no catálogo de aplicativos e nas notificações.
  • O checksum SHA256 deixa de corresponder. O checksum exibido no Living Security descreve o pacote conforme baixado. Verifique-o antes de editar os arquivos e, em seguida, registre o checksum do seu próprio pacote personalizado para os seus registros de implantação.

Opcional: habilitar a busca alternativa por e-mail/UPN

A entrega pessoal normal usa um ID de objeto confiável do Microsoft Entra já conhecido pelo Living Security, junto com a referência de conversa do bot capturada quando o usuário instala ou abre o aplicativo. A entrega em canal usa a referência de conversa do canal armazenada. Nenhuma das rotas exige o Microsoft Graph. Se um destinatário não tiver um ID de objeto do Entra confiável, o Living Security pode, opcionalmente, usar o Microsoft Graph para resolver o destinatário por endereço de e-mail ou UPN. Para habilitar essa alternativa, peça a um administrador do Microsoft Entra que clique em Grant optional User.Read.All consent no painel de configuração do Teams e aprove a permissão de aplicativo User.Read.All do Microsoft Graph para o aplicativo regional Living Security para Teams. O fluxo de consentimento do administrador segue este padrão do Microsoft Entra:
O Living Security gera essa URL a partir do ID do tenant conectado e do ID do aplicativo do bot exibido no painel de configuração. Os IDs têm finalidades diferentes:
  • O ID do aplicativo Teams identifica o pacote de aplicativo instalável no centro de administração do Microsoft Teams.
  • O ID do aplicativo do bot identifica o aplicativo do Microsoft Entra do bot regional e é o ID do cliente usado no fluxo opcional de consentimento do administrador.
Não use o ID do aplicativo Teams na URL de consentimento. A integração Microsoft Entra ID (Client Credentials) em Integrações conectadas é uma integração genérica e separada. Suas credenciais ou seu consentimento não podem ser reutilizados pelo bot regional do Teams, e o consentimento concedido a um aplicativo do Entra não relacionado não habilita essa alternativa.
Tornar o consentimento opcional não remove User.Read.All dos registros de aplicativo regionais existentes do Living Security. Os clientes que já concederam consentimento podem continuar usando a alternativa por e-mail/UPN sem reconfiguração.

Tipos de notificação

Dependendo dos direitos de uso da sua organização e dos Playbooks configurados, o Living Security pode enviar:

Personalização

As notificações do Teams usam a configuração da sua organização no Living Security. Os campos compatíveis incluem o nome de exibição do cliente, campos compatíveis de logotipo e marca, texto das mensagens, chamadas para ação, links de destino, texto de implantação e texto de suporte/contato. As mensagens de instalação são configuráveis em Configurações → Comunicações → Canais → Microsoft Teams → Install message controls. Você pode desativar totalmente as mensagens de instalação, desativar apenas as mensagens de instalação pessoais ou de canal e configurar textos padrão, pessoais ou específicos de canal. O nome e os ícones do aplicativo Teams vêm do pacote regional. Para definir os seus próprios, consulte Personalizar a marca do pacote regional.

Atualização ou remoção do aplicativo

  • Quando o Living Security fornecer um pacote regional atualizado, baixe-o no painel do canal Microsoft Teams e carregue esse pacote por meio do centro de administração do Teams. Verifique o ID do aplicativo, o ID do bot e o checksum exibidos antes da implantação.
  • As edições de marca não são mantidas em uma atualização do pacote. Todo novo pacote regional traz novamente o nome e os ícones do aplicativo Living Security. Reaplique suas edições com Personalizar a marca do pacote regional antes de carregar o novo pacote. Guarde em um local de fácil acesso os seus ícones, os seus dois valores de nome e a última versão carregada, de modo que cada atualização seja uma repetição rápida dos mesmos passos. Um novo pacote nem sempre traz uma versão superior à que você instalou; por isso, defina a versão com base no que o Teams mostra como instalado.
  • Execute Validate install novamente e envie outro teste após uma atualização do aplicativo ou de políticas.
  • Remover ou bloquear o aplicativo impede as notificações proativas para esse usuário ou canal. Reinstale o aplicativo e envie um novo teste para que o Living Security receba um evento de instalação atual do Teams.
  • Se você for descontinuar o envio pelo Teams, remova o Teams dos Playbooks relevantes antes de remover o aplicativo do Microsoft Teams.

Solução de problemas

  • Confirme se o aplicativo pessoal Living Security para Teams está instalado e se o usuário o abriu, de modo que o Living Security tenha uma referência de conversa atual
  • Confirme se o ID do tenant da Microsoft configurado é o tenant em que o usuário está localizado
  • Se os diagnósticos mostrarem que a alternativa por e-mail/UPN foi tentada, confirme se o consentimento do administrador User.Read.All foi concedido ao ID do aplicativo do bot exibido para o tenant correto
  • Quando a alternativa por e-mail/UPN é usada, verifique se o e-mail ou UPN do usuário no Living Security corresponde ao do Microsoft Entra ID
  • Peça ao usuário que desbloqueie ou reinstale o aplicativo, caso o tenha removido ou bloqueado anteriormente
  • Confirme se o aplicativo Living Security para Teams está instalado na equipe ou no canal de destino.
  • Confirme se o mapeamento de canal no Living Security usa a equipe e o canal corretos.
  • Verifique se o canal foi removido, renomeado, arquivado ou restringido.
  • Reinstale o aplicativo na equipe ou no canal de destino e envie outra notificação de teste.
  • Confirme se um administrador do Microsoft Entra concedeu consentimento em todo o tenant para User.Read.All do Microsoft Graph ao ID do aplicativo do bot exibido.
  • Confirme se o ID do tenant configurado é o tenant em que os usuários e o Teams estão localizados.
  • Verifique se o usuário existe no Microsoft Entra ID e não é um convidado de outro tenant.
A categoria de erro TEAMS_ADMIN_CONSENT_REQUIRED, ou o erro da Microsoft AADSTS7000229, significa que uma busca de destinatário por e-mail/UPN tentou usar a alternativa opcional do Microsoft Graph, mas o aplicativo regional Living Security para Teams não tem entidade de serviço (aplicativo empresarial) no tenant do Microsoft Entra conectado. As rotas padrão de ID confiável e de conversa armazenada não exigem esse consentimento. Não se trata de um segredo expirado do Living Security.
  1. Abra Configurações → Comunicações → Canais → Microsoft Teams. Você também pode usar Open Microsoft Teams setup a partir do erro no Log de comunicações.
  2. Confirme se o ID do tenant correto do Microsoft Entra está conectado.
  3. Se a alternativa por e-mail/UPN for necessária, peça a um administrador do Microsoft Entra que clique em Grant optional User.Read.All consent e aprove User.Read.All para o ID do aplicativo do bot exibido. Caso contrário, verifique se o destinatário abriu o aplicativo pessoal e se o Living Security tem o ID de objeto do Entra confiável dele.
  4. Depois que a Microsoft concluir o processamento do consentimento, envie um teste avançado direcionado por e-mail/UPN a partir da configuração do Microsoft Teams. O Log de comunicações mostra o histórico de entrega e os diagnósticos; ele não reenvia a mensagem que falhou.
Reconfigurar Microsoft Entra ID (Client Credentials) não resolve esse erro, pois essa integração não é usada na entrega de notificações do Teams.
  • Verifique se o bot foi bloqueado, removido ou desinstalado
  • Se o aplicativo foi instalado antes de o tenant ser conectado no Living Security, salve o tenant e selecione Validate install para que o Living Security possa associar a instalação existente
  • Reinstale somente se a validação não conseguir detectar a instalação existente
  • Confirme se o usuário ou canal de destino recebeu o evento de instalação mais recente do aplicativo
  • Envie uma nova notificação de teste após reinstalar o aplicativo
Exemplo de campos de evento de instalação usados na solução de problemas:

Segurança

O Living Security usa o Microsoft Graph User.Read.All somente para a busca alternativa opcional de destinatários por e-mail/UPN. Por padrão, o roteamento de notificações pessoais usa um ID de objeto do Entra confiável, proveniente dos dados de entidade do Living Security, e a referência de conversa do bot capturada do Microsoft Teams. IDs de objeto e referências de conversa fornecidos pelo solicitante não são considerados dados de roteamento confiáveis. As mensagens do Microsoft Teams são entregues por meio do bot do Teams do Living Security, somente para notificações, utilizando as mensagens proativas do Microsoft Teams. O Living Security não exige que os clientes criem o próprio registro de aplicativo no Microsoft Entra nem compartilhem um segredo de cliente de propriedade do cliente na configuração padrão do aplicativo Teams. Os pacotes do Teams específicos de cada região mantêm o ID do aplicativo, o ID do bot e o endpoint de mensagens alinhados com a região do Living Security em que a sua organização está hospedada.

Relacionados

Integração com e-mail

Configure o e-mail como canal de entrega.

Integração com o Slack

Configure o Slack como canal de entrega.

Log de comunicações

Acompanhe o status e o histórico de entrega do Teams.

Autenticação

Configuração do Microsoft Entra ID e do SSO.