> ## 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 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 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. 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. 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](#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. 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. 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. 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. 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. 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](/pt/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`. É 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. 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` 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 | 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. 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. 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 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: ```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 **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](#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](#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 * 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 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. 1. 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. 2. Confirme que 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 **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. 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çã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. * 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: ```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 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 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.