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.Allem 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ê
Configuração
Abra o painel de configuração do Microsoft Teams
Conecte o tenant da Microsoft
Baixe o pacote regional do Teams
Carregue e instale o pacote no centro de administração do Teams
- 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
Instale ou abra o aplicativo
Configure as mensagens de instalação
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{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.Valide a configuração
Envie notificações de teste
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.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.
Descompacte o pacote
manifest.json, color.png e outline.png.Substitua os ícones
color.png e outline.png por seus próprios ícones. Mantenha os mesmos dois
nomes de arquivo.Defina o nome do aplicativo
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, definaversioncom 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 deversionnomanifest.jsonque você acabou de baixar e defina um valor superior a ambos. Mantenha o formatoMAJOR.MINOR.PATCHde três números.Por exemplo, se o aplicativo instalado for1.1.1e o novo download for1.1.0, defina1.1.2. Aumentar o1.1.0baixado para1.1.1repetiria a versão instalada, e o Teams recusaria o upload.
Deixe os campos de identidade inalterados
-
id -
botIdembots -
webApplicationInfo -
validDomains -
contentUrlewebsiteUrlemstaticTabs
Compacte novamente os três arquivos
manifest.json esteja dentro de uma pasta.Carregue e verifique
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
developerdo 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 aplicativoUser.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 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.
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
Um usuário não recebe uma notificação pessoal
Um usuário não recebe uma notificação pessoal
- 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.Allfoi 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
Um comunicado em canal não aparece
Um comunicado em canal não aparece
- 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.
A busca opcional por e-mail/UPN ou o consentimento falha
A busca opcional por e-mail/UPN ou o consentimento falha
- Confirme se um administrador do Microsoft Entra concedeu consentimento em todo o tenant para
User.Read.Alldo 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.
O Log de comunicações mostra que o consentimento do administrador da Microsoft é necessário
O Log de comunicações mostra que o consentimento do administrador da Microsoft é necessário
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.- 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.
- Confirme se 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.Allpara 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. - 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.
O aplicativo está instalado, mas as notificações falham
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 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
Segurança
O Living Security usa o Microsoft GraphUser.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.

