Integração com o Microsoft Teams

A integração com o Microsoft Teams envia notificações do Living Security a usuários e canais por meio do aplicativo Teams do Living Security. 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 serve apenas 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 da conversa do Teams para notificações proativas futuras. As mensagens de instalação são unidirecionais e podem ser personalizadas ou desativadas conforme os requisitos de implantação da empresa.

Um administrador do Microsoft Teams ainda precisa carregar, aprovar e distribuir o aplicativo Teams do Living Security. O consentimento do administrador do Microsoft Entra User.Read.All é opcional e habilita apenas a alternativa de busca por e-mail ou nome principal do usuário (UPN).

Para configurar a entrega de Incentivos e Playbooks, comece em Configurações → Comunicações → Canais e clique no cartão Microsoft Teams. Esta página aborda a configuração subjacente do aplicativo Teams.

Pré-requisitos

Antes de configurar o Microsoft Teams, certifique-se de ter:

Um administrador do Microsoft Teams que possa carregar e aprovar aplicativos da organização. A mesma pessoa pode ter as duas funções de administrador.
Um administrador do Microsoft Entra somente se desejar habilitar a alternativa opcional de busca 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 em que os comunicados de segurança devem ser entregues, caso os comunicados em canais estejam habilitados
O ID do tenant do Microsoft Entra, disponível em Microsoft Entra admin center → Identidade → Visão geral

Quem faz o quê

Função	Responsabilidade
Administrador do Living Security	Conecta o tenant da Microsoft, baixa o pacote regional, configura as mensagens de instalação, valida a configuração e envia testes
Administrador do Microsoft Teams	Carrega e permite o aplicativo, distribui-o aos usuários ou grupos pretendidos e atribui políticas de configuração de aplicativos
Administrador do Microsoft Entra, opcional	Concede o consentimento de aplicativo `User.Read.All` ao ID do aplicativo do bot regional quando a alternativa de busca por e-mail/UPN é necessária
Proprietário do Teams, quando a entrega em canais é utilizada	Instala ou aprova o aplicativo para a equipe e o canal pretendidos

Essas funções podem ser exercidas por pessoas diferentes. Compartilhe a soma de verificação do pacote, o ID do aplicativo Teams, o Bot app ID e a população pretendida para a implantação com o administrador do Microsoft Teams. Compartilhe a URL de consentimento gerada com um administrador do Microsoft Entra somente ao habilitar a alternativa opcional de busca por e-mail/UPN. Não compartilhe outras credenciais do Living Security que não sejam pertinentes.

Configuração

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, a soma de verificação SHA256, o status da configuração do tenant da Microsoft, as instruções de instalação, os controles das 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 a sua organização está hospedada.

Conecte o seu tenant da Microsoft

Em Connect your tenant, informe o ID do tenant do Microsoft Entra que detém os usuários e os canais do Teams que receberão as notificações e, em seguida, clique em Save Microsoft tenant. Um tenant da Microsoft pode pertencer a apenas uma organização do Living Security.Se o controle do tenant estiver indisponí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ê continuar.

Sempre que possível, conecte o tenant antes de instalar o aplicativo Teams. Se o aplicativo já estiver instalado, salve o tenant e selecione primeiro Validate install. O Living Security tenta associar automaticamente a instalação existente; reinstale somente se a validação não conseguir detectá-la.

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 com base na soma de verificação SHA256 exibida no Living Security antes de alterar qualquer coisa. Para atribuir 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.

A soma de verificação do arquivo baixado corresponde à soma de verificação SHA256 exibida no Living Security.

Carregue e instale o pacote no Teams admin center

No Microsoft Teams admin center, 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 publicador é Living Security. A personalização da marca do pacote não altera o publicador
O aplicativo está desbloqueado
O aplicativo está disponível para os usuários ou grupos pretendidos
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 de política de aplicativo, confirme a atribuição da política no Microsoft Teams admin center e tente novamente depois que a Microsoft concluir a propagação.

Instale ou abra o aplicativo

Distribua o aplicativo pessoal aos usuários pretendidos. Antes 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 em um teste de instalação pessoal detectada.Para a entrega em canais, instale o aplicativo na equipe e no canal pretendidos para que o bot possa capturar a referência da conversa desse canal.

Um usuário de destino instalou ou abriu o aplicativo pessoal, ou o aplicativo está instalado no canal pretendido.

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 é substituído pelo 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 o respectivo escopo.

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 regionais do bot 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.

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. Este 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. Utilize o teste avançado direcionado por e-mail/UPN somente quando a alternativa opcional de busca estiver habilitada.

A notificação de teste unidirecional aparece no Microsoft Teams.

Consulte a tentativa correspondente no Log de comunicação 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. É possível definir o seu próprio nome de aplicativo e ícones nesse pacote antes de carregá-lo. O Living Security oferece suporte a esse procedimento para pacotes regionais que um administrador do Teams carrega diretamente. Faça isso depois de baixar e verificar o pacote e antes de carregá-lo no Teams admin center.

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.

Substitua os ícones

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

Arquivo	Requisito
`color.png`	PNG colorido, 192 × 192 pixels, sem transparência
`outline.png`	PNG transparente, 32 × 32 pixels

Defina o nome do aplicativo

Em manifest.json, edite estes dois campos:

name.short — o nome exibido no cabeçalho do aplicativo 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 Teams admin center, 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 Teams admin center, 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 carregamento.

Deixe os campos de identidade inalterados

Não altere estes campos. Cada um deles contém 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.

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.

Carregue e verifique

Carregue o arquivo ZIP com a marca personalizada no Teams admin center, retorne 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.

Publicador e soma de verificação

A personalização da marca define o nome e os ícones do aplicativo. Ela não altera duas coisas:

O publicador continua sendo o Living Security. Os campos developer do manifesto indicam o Living Security e apontam para o site, a política de privacidade e os termos de serviço do Living Security. Juntos, eles identificam a empresa que opera o serviço, de modo que o Teams continua a exibir Living Security como publicador 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.
A soma de verificação SHA256 deixa de corresponder. A soma de verificação exibida no Living Security descreve o pacote conforme baixado. Verifique-a antes de editar os arquivos e, em seguida, registre a soma de verificação do seu próprio pacote com marca personalizada para os seus registros de implantação.

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

A entrega pessoal normal usa um ID de objeto confiável do Microsoft Entra já conhecido pelo Living Security, juntamente com a referência de conversa do bot capturada quando o usuário instala ou abre o aplicativo. A entrega em canais usa a referência de conversa do canal armazenada. Nenhuma das duas 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 identificar 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 Teams regional do Living Security. O fluxo de consentimento do administrador segue este padrão do Microsoft Entra:

https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}

O Living Security gera essa URL a partir do ID do tenant conectado e do Bot app ID exibido no painel de configuração. Os IDs têm finalidades diferentes:

O Teams app ID identifica o pacote de aplicativo instalável no Microsoft Teams admin center.
O Bot app ID identifica o aplicativo do Microsoft Entra do bot regional e é o ID do cliente usado no fluxo opcional de consentimento do administrador.

Não substitua o ID do aplicativo Teams na URL de consentimento. A integração Microsoft Entra ID (Client Credentials) em Connected Integrations é 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 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 o 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:

Notificação	Descrição
Atribuições de treinamento	Notifica os usuários quando um treinamento é atribuído, está no prazo ou está pronto para ser concluído
Lembretes de treinamento	Lembra os usuários sobre prazos próximos
Alertas de risco humano	Envia atualizações personalizadas do Índice de Risco Humano e próximas etapas recomendadas
Mensagens de implantação	Envia notificações unidirecionais de integração ou implantação durante o lançamento
Comunicados em canais	Publica comunicações do programa de segurança em canais do Teams configurados

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, logotipo e campos de marca compatíveis, texto das mensagens, chamadas para ação, links de destino, texto de implantação e texto de suporte/contato. As mensagens de instalação podem ser configuradas em Configurações → Comunicações → Canais → Microsoft Teams → Install message controls. É possível desativar completamente 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 Teams admin center. Verifique o ID do aplicativo, o ID do bot e a soma de verificação exibidos antes da implantação.
As alterações de marca não persistem após uma atualização do pacote. Todo novo pacote regional traz novamente o nome e os ícones do aplicativo Living Security. Reaplique as suas alterações com Personalizar a marca do pacote regional antes de carregar o novo pacote. Mantenha em local acessível os seus ícones, os seus dois valores de nome e a última versão carregada, para que cada atualização seja uma repetição breve das mesmas etapas. Um novo pacote nem sempre traz uma versão superior à que você instalou; portanto, defina a versão com base no que o Teams mostra como instalado.
Execute novamente Validate install e envie outro teste após uma atualização do aplicativo ou de política.
Remover ou bloquear o aplicativo impede 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 a entrega pelo Teams, remova o Teams dos Playbooks pertinentes antes de remover o aplicativo do Microsoft Teams.

Solução de problemas

Um usuário não recebe uma notificação pessoal

Confirme que o aplicativo pessoal do Teams do Living Security está instalado e que o usuário o abriu, de modo que o Living Security tenha uma referência de conversa atual
Confirme que 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 que o consentimento do administrador User.Read.All foi concedido ao Bot app ID exibido para o tenant correto
Quando a alternativa por e-mail/UPN for utilizada, 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

Um comunicado em canal não aparece

Confirme que o aplicativo Teams do Living Security está instalado na equipe ou no canal de destino.
Confirme que 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.

A busca opcional por e-mail/UPN ou o consentimento falha

Confirme que um administrador do Microsoft Entra concedeu consentimento em todo o tenant para o Microsoft Graph User.Read.All ao Bot app ID exibido.
Confirme que 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.

O Log de comunicação mostra que o consentimento do administrador da Microsoft é necessário

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 a alternativa opcional do Microsoft Graph, mas o aplicativo Teams regional do Living Security não possui 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. Isso não indica um segredo expirado do Living Security.

Abra Configurações → Comunicações → Canais → Microsoft Teams. Também é possível usar Open Microsoft Teams setup a partir do erro no Log de comunicação.
Confirme que o ID do tenant correto do Microsoft Entra está conectado.
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 Bot app ID exibido. Caso contrário, verifique se o destinatário abriu o aplicativo pessoal e se o Living Security possui o ID de objeto do Entra confiável dele.
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ção mostra o histórico de entrega e os diagnósticos; ele não reenvia a mensagem que falhou.

Reconfigurar o Microsoft Entra ID (Client Credentials) não resolve este erro, pois essa integração não é usada na entrega de notificações do Teams.

O aplicativo está instalado, mas as notificações falham

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 que 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:

{
  "type": "installationUpdate",
  "action": "add",
  "channelData": {
    "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
    "team": { "id": "19:team-id@thread.tacv2" },
    "channel": { "id": "19:channel-id@thread.tacv2" }
  },
  "conversation": {
    "id": "19:channel-id@thread.tacv2",
    "conversationType": "channel",
    "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
  }
}

Segurança

O Living Security usa o Microsoft Graph User.Read.All somente para a alternativa opcional de busca de destinatário 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, exclusivo para notificações, usando mensagens proativas do Microsoft Teams. O Living Security não exige que os clientes criem o próprio registro de aplicativo do 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 por 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ção

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

Autenticação

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

Integrações

Configuração de integração

Catálogo

Canais de saída

Pré-requisitos

Quem faz o quê

Configuração

Personalizar a marca do pacote regional

Publicador e soma de verificação

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

Tipos de notificação

Personalização

Atualização ou remoção do aplicativo

Solução de problemas

Segurança

Relacionados

Integração com e-mail

Integração com o Slack

Log de comunicação

Autenticação

Integrações

Configuração de integração

Catálogo

Canais de saída

​Pré-requisitos

​Quem faz o quê

​Configuração

​Personalizar a marca do pacote regional

​Publicador e soma de verificação

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

​Tipos de notificação

​Personalização

​Atualização ou remoção do aplicativo

​Solução de problemas

​Segurança

​Relacionados

Integração com e-mail

Integração com o Slack

Log de comunicação

Autenticação

Pré-requisitos

Quem faz o quê

Configuração

Personalizar a marca do pacote regional

Publicador e soma de verificação

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

Tipos de notificação

Personalização

Atualização ou remoção do aplicativo

Solução de problemas

Segurança

Relacionados