> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Integração com o Microsoft Teams > Conecte o Living Security ao Microsoft Teams para enviar notificações de treinamento, alertas de segurança e comunicados em canais. 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ê | 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 previstos 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 busca alternativa por e-mail/UPN é necessária | | **Proprietário do Teams**, quando o envio por canal é utilizado | Instala ou aprova o aplicativo para a equipe e o canal previstos | 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 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. 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. 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](#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. 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. 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. 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. 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. 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](/pt-BR/features/communications/log) 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. Extraia o arquivo ZIP. Ele contém exatamente três arquivos na raiz do arquivo compactado: `manifest.json`, `color.png` e `outline.png`. Substitua `color.png` e `outline.png` por seus próprios ícones. Mantenha os mesmos dois nomes de arquivo. | Arquivo | Requisito | | - | - | | `color.png` | PNG em cores, 192 × 192 pixels, sem transparência | | `outline.png` | PNG transparente, 32 × 32 pixels | 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. 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. 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 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: ```text theme={null} 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 **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: | Notificação | Descrição | | - | - | | Atribuições de treinamento | Notificam os usuários quando um treinamento é atribuído, está vencendo ou está pronto para ser concluído | | Lembretes de treinamento | Lembram os usuários sobre prazos próximos | | Alertas de risco humano | Enviam atualizações personalizadas do Índice de Risco Humano e os próximos passos recomendados | | Mensagens de implantação | Enviam notificações unidirecionais de integração ou implantação durante o lançamento | | Comunicados em canais | Publicam 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, 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](#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](#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 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: ```json theme={null} { "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 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 Configure o e-mail como canal de entrega. Configure o Slack como canal de entrega. Acompanhe o status e o histórico de entrega do Teams. Configuração do Microsoft Entra ID e do SSO. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.