Edellytykset
Varmista ennen Microsoft Teamsin määritystä, että sinulla on:- Microsoft Teamsin järjestelmänvalvoja, joka voi ladata ja hyväksyä organisaation sovelluksia. Sama henkilö voi toimia molemmissa järjestelmänvalvojan rooleissa.
- Microsoft Entran järjestelmänvalvoja vain, jos haluat ottaa käyttöön valinnaisen sähköposti-/UPN-hakuvaihtoehdon koko vuokraajan laajuisella
User.Read.All-sovellussuostumuksella - Living Securityn järjestelmänvalvojan oikeudet
- Aktiivinen Living Security -organisaatio
- Tiimien ja kanavien nimet, joihin tietoturvatiedotteet toimitetaan, jos kanavatiedotteet on otettu käyttöön
- Microsoft Entra -vuokraajan tunnus (tenant ID), joka löytyy kohdasta Microsoft Entra admin center → Identiteetti → Yleiskatsaus
Kuka tekee mitä
Määritys
Avaa Microsoft Teamsin määrityspaneeli
Yhdistä Microsoft-vuokraajasi
Lataa alueellinen Teams-paketti
Lataa ja asenna paketti Teams admin centerissä
- Teams app ID ja bot app ID vastaavat Living Securityssa näkyviä arvoja
- Sovelluksen nimi on alueellinen Living Security -nimi tai itse asettamasi nimi, jos brändäsit paketin omaksi
- Julkaisija on Living Security. Paketin brändääminen omaksi ei muuta julkaisijaa
- Sovelluksen esto on poistettu
- Sovellus on aiottujen käyttäjien tai ryhmien saatavilla
- Sovellus on asennettu sovellusten käyttöönottokäytäntöjen tai kohdennetun asennuksen kautta niille käyttäjille ja tiimeille/kanaville, joiden pitää saada ilmoituksia
Asenna tai avaa sovellus
Määritä asennusviestit
- Send install messages
- Send personal install messages
- Send channel install messages
- Default message
- Personal message
- Channel message
{{installerName}}, joka korvautuu sovelluksen asentaneen käyttäjän näyttönimellä. Jätä henkilökohtainen tai kanavaviesti tyhjäksi, jos haluat käyttää määritettyä oletusviestiä. Jos myös oletusviesti on tyhjä, Living Security käyttää kyseisen kohteen sisäänrakennettua viestiä.Validoi määritys
Lähetä testi-ilmoituksia
User.Read.All-suostumusta.Jos henkilökohtaista asennusta ei havaita, pyydä käyttäjää asentamaan tai avaamaan
Living Securityn henkilökohtainen sovellus, valitse Validate install uudelleen ja lähetä
testi sen jälkeen uudelleen. Käytä edistynyttä kohdennettua sähköposti-/UPN-testiä vain, kun
valinnainen hakuvaihtoehto on otettu käyttöön.Alueellisen paketin brändäys omaksi
Alueellinen paketti on ZIP-arkisto, jossa on kolme tiedostoa:manifest.json, color.png ja outline.png. Voit asettaa paketissa oman sovellusnimesi ja omat kuvakkeesi ennen paketin lataamista. Living Security tukee tätä tapaa alueellisissa paketeissa, jotka Teamsin järjestelmänvalvoja lataa suoraan.
Tee tämä sen jälkeen, kun olet ladannut ja tarkistanut paketin, ja ennen kuin lataat sen Teams admin centeriin.
Pura paketti
manifest.json, color.png ja outline.png.Korvaa kuvakkeet
color.png ja outline.png omilla kuvakkeillasi. Säilytä samat kaksi
tiedostonimeä.Aseta sovelluksen nimi
manifest.json näitä kahta kenttää:-
name.short– nimi, joka näkyy Teamsin sovellusotsikossa ja muissa tilaltaan rajallisissa paikoissa. Enintään 30 merkkiä. -
name.full– nimi, joka näkyy sovellusluettelossa ja sovelluksen tiedoissa. Enintään 100 merkkiä.Jos Living Security -sovellus on jo ladattu Teams admin centeriin, asetaversionsuuremmaksi kuin siellä asennettu versio. Microsoft Teams hylkää päivityksen, joka ei kasvata versiota, ja uusi lataus voi sisältää saman version kuin jo asentamasi paketti tai sitä pienemmän version.Katso asennettu versio Teams admin centerin kohdasta Teams apps → Manage apps sovelluksen tietosivulta. Vertaa sitä juuri lataamasimanifest.json-tiedostonversion-arvoon ja aseta arvo, joka on suurempi kuin molemmat. Säilytä kolmen numeronMAJOR.MINOR.PATCH-muoto.Jos esimerkiksi asennettu sovellus on1.1.1ja uusi lataamasi paketti on1.1.0, aseta1.1.2. Jos nostaisit ladatun1.1.0-version arvoon1.1.1, se toistaisi asennetun version, ja Teams hylkäisi latauksen.
Jätä identiteettikentät ennalleen
-
id -
botIdtiedostossabots -
webApplicationInfo -
validDomains -
contentUrljawebsiteUrltiedostossastaticTabs
Pakkaa kolme tiedostoa uudelleen ZIP-arkistoksi
manifest.json on kansion sisällä.Lataa ja tarkista
Julkaisija ja tarkistussumma
Brändäys omaksi muuttaa sovelluksen nimen ja kuvakkeet. Se ei muuta kahta asiaa:- Julkaisija pysyy Living Securityna. Manifestin
developer-kentissä mainitaan Living Security, ja ne linkittävät Living Securityn verkkosivustoon, tietosuojakäytäntöön ja käyttöehtoihin. Yhdessä ne yksilöivät palvelua ylläpitävän yrityksen, joten Teams näyttää julkaisijana edelleen Living Securityn sovelluksen tietosivulla, käyttöoikeuksien suostumusikkunoissa ja sovelluksen käyttöraporteissa. Oma nimesi ja kuvakkeesi näkyvät käyttäjille sovellusotsikossa, sovellusluettelossa ja ilmoituksissa. - SHA256-tarkistussumma ei enää täsmää. Living Securityssa näkyvä tarkistussumma kuvaa pakettia sellaisena kuin se ladattiin. Tarkista se ennen tiedostojen muokkaamista ja kirjaa sitten oman omaksi brändätyn pakettisi tarkistussumma käyttöönottotietoihisi.
Valinnainen: Ota käyttöön sähköposti-/UPN-hakuvaihtoehto
Tavallinen henkilökohtainen toimitus käyttää luotettua Microsoft Entra -objektitunnusta, joka on jo Living Securityn tiedossa, sekä botin keskusteluviittausta, joka tallennetaan, kun käyttäjä asentaa tai avaa sovelluksen. Kanavatoimitus käyttää tallennettua kanavan keskusteluviittausta. Kumpikaan reitti ei edellytä Microsoft Graphia. Jos vastaanottajalla ei ole luotettua Entra-objektitunnusta, Living Security voi valinnaisesti käyttää Microsoft Graphia vastaanottajan selvittämiseen sähköpostiosoitteen tai UPN:n perusteella. Ota tämä vaihtoehto käyttöön pyytämällä Microsoft Entran järjestelmänvalvojaa napsauttamaan Teams-määrityspaneelissa Grant optional User.Read.All consent ja hyväksymään Microsoft GraphinUser.Read.All-sovellusoikeus alueelliselle Living
Security Teams -sovellukselle.
Järjestelmänvalvojan suostumuksen kulku noudattaa tätä Microsoft Entran mallia:
- Teams app ID yksilöi asennettavan sovelluspaketin Microsoft Teams admin centerissä.
- Bot app ID yksilöi alueellisen botin Microsoft Entra -sovelluksen ja on asiakastunnus (client ID), jota käytetään valinnaisessa järjestelmänvalvojan suostumuksen kulussa.
User.Read.All-oikeutta olemassa olevista alueellisista
Living Security -sovellusrekisteröinneistä. Asiakkaat, jotka ovat jo antaneet
suostumuksen, voivat jatkaa sähköposti-/UPN-hakuvaihtoehdon käyttöä ilman uudelleenmääritystä.Ilmoitustyypit
Organisaatiosi käyttöoikeuksista ja määritetyistä toimintasuunnitelmista riippuen Living Security voi lähettää:Mukautus
Teams-ilmoitukset käyttävät Living Security -organisaatiosi määrityksiä. Tuettuja kenttiä ovat asiakkaan näyttönimi, tuetut logo- ja brändikentät, viestien sisältö, toimintakehotteet, kohdelinkit, käyttöönottoteksti sekä tuki- ja yhteystietoteksti. Asennusviestit ovat määritettävissä kohdassa Asetukset → Communications → Channels → Microsoft Teams → Install message controls. Voit poistaa asennusviestit kokonaan käytöstä, poistaa käytöstä vain henkilökohtaiset tai kanavakohtaiset asennusviestit sekä määrittää oletus-, henkilökohtaisen tai kanavakohtaisen viestisisällön. Teams-sovelluksen nimi ja kuvakkeet tulevat alueellisesta paketista. Jos haluat asettaa omat, katso Alueellisen paketin brändäys omaksi.Sovelluksen päivittäminen tai poistaminen
- Kun Living Security toimittaa päivitetyn alueellisen paketin, lataa se Microsoft Teams -kanavan paneelista ja lataa paketti Teams admin centerin kautta. Tarkista näytetty app ID, bot ID ja tarkistussumma ennen käyttöönottoa.
- Brändäysmuutokset eivät säily paketin päivityksen yhteydessä. Jokainen uusi alueellinen paketti sisältää jälleen Living Security -sovelluksen nimen ja kuvakkeet. Tee muokkaukset uudelleen ohjeella Alueellisen paketin brändäys omaksi, ennen kuin lataat uuden paketin. Säilytä kuvakkeesi, kaksi nimiarvoasi ja viimeksi lataamasi versio helposti löydettävissä, jotta jokainen päivitys on lyhyt toisto samoista vaiheista. Uusi paketti ei aina sisällä korkeampaa versiota kuin asentamasi, joten aseta versio sen perusteella, minkä Teams näyttää asennettuna.
- Suorita Validate install uudelleen ja lähetä uusi testi sovellus- tai käytäntöpäivityksen jälkeen.
- Sovelluksen poistaminen tai estäminen estää proaktiiviset ilmoitukset kyseiselle käyttäjälle tai kanavalle. Asenna sovellus uudelleen ja lähetä uusi testi, jotta Living Security saa ajantasaisen Teams-asennustapahtuman.
- Jos lopetat Teams-toimituksen, poista Teams asianomaisista toimintasuunnitelmista ennen sovelluksen poistamista Microsoft Teamsista.
Vianmääritys
Käyttäjä ei saa henkilökohtaista ilmoitusta
Käyttäjä ei saa henkilökohtaista ilmoitusta
- Varmista, että Living Securityn Teams-henkilökohtainen sovellus on asennettu ja käyttäjä on avannut sen, jotta Living Securityllä on ajantasainen keskusteluviittaus
- Varmista, että määritetty Microsoft-vuokraajan tunnus on vuokraaja, jossa käyttäjä sijaitsee
- Jos diagnostiikka osoittaa, että sähköposti-/UPN-hakuvaihtoehtoa yritettiin käyttää, varmista, että
User.Read.All-järjestelmänvalvojan suostumus annettiin näytetylle Bot app ID -tunnukselle oikeassa vuokraajassa - Kun sähköposti-/UPN-hakuvaihtoehtoa käytetään, varmista, että käyttäjän sähköpostiosoite tai UPN Living Securityssa vastaa Microsoft Entra ID:tä
- Pyydä käyttäjää poistamaan sovelluksen esto tai asentamaan se uudelleen, jos hän on aiemmin poistanut tai estänyt sen
Valinnainen sähköposti-/UPN-haku tai suostumus epäonnistuu
Valinnainen sähköposti-/UPN-haku tai suostumus epäonnistuu
- Varmista, että Microsoft Entran järjestelmänvalvoja on antanut koko vuokraajan laajuisen suostumuksen
Microsoft Graphin
User.Read.All-oikeudelle näytetylle Bot app ID -tunnukselle. - Varmista, että määritetty vuokraajan tunnus on vuokraaja, jossa käyttäjät ja Teams sijaitsevat.
- Varmista, että käyttäjä on olemassa Microsoft Entra ID:ssä eikä ole vieras toisesta vuokraajasta.
Viestintäloki näyttää, että Microsoftin järjestelmänvalvojan suostumus vaaditaan
Viestintäloki näyttää, että Microsoftin järjestelmänvalvojan suostumus vaaditaan
TEAMS_ADMIN_CONSENT_REQUIRED tai Microsoftin virhe AADSTS7000229 tarkoittaa, että sähköposti-/UPN-vastaanottajahaku yritti käyttää valinnaista Microsoft Graph -hakuvaihtoehtoa, mutta alueellisella Living Security Teams -sovelluksella ei ole palvelun pääkäyttäjää (yrityssovellusta) yhdistetyssä Microsoft Entra -vuokraajassa. Oletusarvoiset luotettuun tunnukseen ja tallennettuun keskusteluun perustuvat reitit eivät edellytä tätä suostumusta. Kyse ei ole vanhentuneesta Living Security -salaisuudesta.- Avaa Asetukset → Communications → Channels → Microsoft Teams. Voit käyttää myös viestintälokin virheen kohtaa Open Microsoft Teams setup.
- Varmista, että oikea Microsoft Entra -vuokraajan tunnus on yhdistetty.
- Jos sähköposti-/UPN-hakuvaihtoehto on tarpeen, pyydä Microsoft Entran järjestelmänvalvojaa napsauttamaan Grant optional User.Read.All consent ja hyväksymään
User.Read.Allnäytetylle Bot app ID -tunnukselle. Muussa tapauksessa varmista, että vastaanottaja on avannut henkilökohtaisen sovelluksen ja että Living Securityllä on hänen luotettu Entra-objektitunnuksensa. - Kun Microsoft on käsitellyt suostumuksen, lähetä Microsoft Teamsin määrityksestä edistynyt kohdennettu sähköposti-/UPN-testi. Viestintäloki näyttää toimitushistorian ja diagnostiikan; se ei toimita epäonnistunutta viestiä uudelleen.
Sovellus on asennettu, mutta ilmoitukset epäonnistuvat
Sovellus on asennettu, mutta ilmoitukset epäonnistuvat
- Tarkista, onko botti estetty, poistettu tai asennus poistettu
- Jos sovellus asennettiin ennen vuokraajan yhdistämistä Living Securityssa, tallenna vuokraaja ja valitse Validate install, jotta Living Security voi yhdistää olemassa olevan asennuksen
- Asenna uudelleen vain, jos validointi ei havaitse olemassa olevaa asennusta
- Varmista, että kohdekäyttäjä tai -kanava on vastaanottanut uusimman sovelluksen asennustapahtuman
- Lähetä uusi testi-ilmoitus sovelluksen uudelleenasennuksen jälkeen
Tietoturva
Living Security käyttää Microsoft GraphinUser.Read.All-oikeutta vain valinnaiseen sähköposti-/UPN-vastaanottajahakuun. Oletuksena henkilökohtaisten ilmoitusten reititys käyttää Living Securityn entiteettitiedoista saatavaa luotettua Entra-objektitunnusta ja Microsoft Teamsista tallennettua botin keskusteluviittausta. Kutsujan antamia objektitunnuksia ja keskusteluviittauksia ei pidetä luotettavina reititystietoina. Microsoft Teams -viestit toimitetaan Living Securityn vain ilmoituksiin tarkoitetun Teams-botin kautta käyttäen Microsoft Teamsin proaktiivista viestintää.
Living Security ei edellytä asiakkailta oman Microsoft Entra -sovellusrekisteröinnin luomista tai asiakkaan omistaman asiakassalaisuuden (client secret) jakamista tavallisessa Teams-sovelluksen määrityksessä.
Aluekohtaiset Teams-paketit pitävät app ID:n, bot ID:n ja viestien päätepisteen (messaging endpoint) yhdenmukaisina sen Living Security -alueen kanssa, jolla organisaatiosi on isännöity.

