> ## 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.

# Microsoft Teams -integraatio

> Yhdistä Living Security Microsoft Teamsiin lähettääksesi koulutusilmoituksia, tietoturvahälytyksiä ja kanavatiedotteita.

Microsoft Teams -integraatio lähettää Living Securityn ilmoituksia käyttäjille ja kanaville Living Security Teams -sovelluksen kautta. Käytä sitä koulutustehtäviin, ihmisriskihälytyksiin, käyttöönottoviesteihin ja tietoturvatiimin tiedotteisiin.

Tämä integraatio on tarkoitettu vain ilmoituksille. Käyttäjät eivät lähetä komentoja botille Microsoft Teamsissa. Kun sovellus on asennettu, botti tallentaa Teams-keskustelun viittauksen tulevia proaktiivisia ilmoituksia varten. Asennusviestit ovat yksisuuntaisia, ja niitä voidaan mukauttaa tai poistaa käytöstä yrityksen käyttöönottovaatimusten mukaan.

<Warning>
  Microsoft Teamsin järjestelmänvalvojan on edelleen ladattava, hyväksyttävä ja jaettava
  Living Security Teams -sovellus. Microsoft Entra `User.Read.All` -järjestelmänvalvojan suostumus on
  valinnainen, ja se mahdollistaa vain sähköpostiosoitteeseen tai käyttäjän päänimeen (UPN) perustuvan hakuvaihtoehdon.
</Warning>

<Note>
  Muistutusten ja toimintasuunnitelmien toimituksen määritystä varten aloita kohdasta **Asetukset → Communications →
  Channels** ja napsauta **Microsoft Teams** -korttia. Tällä sivulla käsitellään
  taustalla olevan Teams-sovelluksen määritystä.
</Note>

## 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ä

| Rooli | Vastuu |
| - | - |
| **Living Securityn järjestelmänvalvoja** | Yhdistää Microsoft-vuokraajan, lataa alueellisen paketin, määrittää asennusviestit, validoi määrityksen ja lähettää testit |
| **Microsoft Teamsin järjestelmänvalvoja** | Lataa sovelluksen ja sallii sen, jakaa sen aiotuille käyttäjille tai ryhmille sekä määrittää sovellusten käyttöönottokäytännöt |
| **Microsoft Entran järjestelmänvalvoja**, valinnainen | Myöntää `User.Read.All`-sovellussuostumuksen alueelliselle Bot app ID -tunnukselle, kun sähköposti-/UPN-hakuvaihtoehto on tarpeen |
| **Teams-omistaja**, kun käytetään kanavatoimitusta | Asentaa sovelluksen tai hyväksyy sen aiotulle tiimille ja kanavalle |

Nämä voivat olla eri henkilöitä. Jaa paketin tarkistussumma, Teams app ID, **Bot app ID** ja aiottu käyttöönoton kohdejoukko Microsoft Teamsin järjestelmänvalvojalle. Jaa luotu suostumus-URL Microsoft Entran järjestelmänvalvojalle vain, kun otat käyttöön valinnaisen sähköposti-/UPN-hakuvaihtoehdon. Älä jaa muita Living Securityyn liittyviä tunnistetietoja.

## Määritys

<Steps>
  <Step title="Avaa Microsoft Teamsin määrityspaneeli">
    Siirry Living Securityssa kohtaan **Asetukset → Communications → Channels** ja valitse **Microsoft Teams**.

    Paneelissa näkyvät organisaatiosi alue, paketin tiedostonimi, Teams app ID, bot app ID, SHA256-tarkistussumma, Microsoft-vuokraajan määrityksen tila, asennusohjeet, asennusviestien asetukset sekä validointi- ja testi-ilmoitustyökalut.

    <Check>
      Living Securityssa näkyvä alue vastaa aluetta, jolla organisaatiosi on isännöity.
    </Check>
  </Step>

  <Step title="Yhdistä Microsoft-vuokraajasi">
    Kirjoita kohtaan **Connect your tenant** sen Microsoft Entra -vuokraajan tunnus, joka omistaa ilmoituksia vastaanottavat käyttäjät ja Teams-kanavat, ja napsauta sitten **Save Microsoft tenant**. Yksi Microsoft-vuokraaja voi kuulua vain yhteen Living Security -organisaatioon.

    Jos vuokraajan hallinta ei ole käytettävissä, ota yhteyttä Living Securityn käyttöönotosta vastaavaan henkilöön tai tukeen vuokraajan yhdistämiseksi tai vaihtamiseksi ennen sovelluksen asennusta.

    <Check>
      Living Security näyttää tekstin **Microsoft tenant connected**, ennen kuin jatkat.
    </Check>

    <Note>
      Yhdistä vuokraaja ennen Teams-sovelluksen asennusta, kun se on mahdollista. Jos sovellus on jo asennettu, tallenna vuokraaja ja valitse ensin **Validate install**. Living Security yrittää yhdistää olemassa olevan asennuksen automaattisesti; asenna uudelleen vain, jos validointi ei havaitse sitä.
    </Note>
  </Step>

  <Step title="Lataa alueellinen Teams-paketti">
    Napsauta **Download Teams package**. Living Security tarjoaa organisaatiollesi aluekohtaisen ZIP-paketin.

    Tarkista ladattu tiedosto Living Securityssa näkyvää SHA256-tarkistussummaa vasten, ennen kuin muutat mitään. Jos haluat antaa sovellukselle oman nimen ja omat kuvakkeet, noudata tämän tarkistuksen jälkeen ja ennen paketin lataamista ohjeita kohdassa [Alueellisen paketin brändäys omaksi](#alueellisen-paketin-br%C3%A4nd%C3%A4ys-omaksi).

    <Check>
      Ladatun tiedoston tarkistussumma vastaa Living Securityssa näkyvää SHA256-tarkistussummaa.
    </Check>
  </Step>

  <Step title="Lataa ja asenna paketti Teams admin centerissä">
    Siirry Microsoft Teams admin centerissä kohtaan **Teams apps → Manage apps → Actions → Upload new app** ja lataa Living Securitystä ladattu ZIP-tiedosto.

    Varmista seuraavat:

    * 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

    Microsoftilta voi kestää hetki sovellusten saatavuuden ja käyttöönottokäytäntöjen muutosten välittymiseen.

    <Note>
      Jos validointi tai testi epäonnistuu heti sovelluskäytännön muutoksen jälkeen, varmista käytännön määritys Microsoft Teams admin centerissä ja yritä uudelleen, kun Microsoft on saanut muutoksen välitettyä.
    </Note>
  </Step>

  <Step title="Asenna tai avaa sovellus">
    Jaa henkilökohtainen sovellus aiotuille käyttäjille. Ennen kuin Living Security voi
    lähettää henkilökohtaisen testin havaittuun asennukseen, vähintään yhden käyttäjän on
    asennettava tai avattava Living Securityn henkilökohtainen sovellus Microsoft Teamsissa. Näin
    botti saa tallennettua käyttäjän luotetun identiteetin ja henkilökohtaisen
    keskusteluviittauksen. Pelkkää kanava-asennusta ei voi käyttää
    henkilökohtaisessa havaitun asennuksen testissä.

    Kanavatoimitusta varten asenna sovellus aiottuun tiimiin ja kanavalle, jotta
    botti voi tallentaa kyseisen kanavan keskusteluviittauksen.

    <Check>
      Kohdekäyttäjä on asentanut tai avannut henkilökohtaisen sovelluksen, tai sovellus on
      asennettu aiottuun kanavaan.
    </Check>
  </Step>

  <Step title="Määritä asennusviestit">
    Valitse osiossa **Install message controls**, lähetetäänkö Teams-asennusviestejä, ja mukauta yksisuuntainen viestisisältö organisaatiollesi.

    Käytettävissä olevat asetukset:

    * Send install messages
    * Send personal install messages
    * Send channel install messages
    * Default message
    * Personal message
    * Channel message

    Viestikentät tukevat muuttujaa `{{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ä.
  </Step>

  <Step title="Validoi määritys">
    Napsauta Living Securityssa **Validate install**. Validointi tarkistaa, että alueellinen paketti on saatavilla, Microsoft-vuokraajan määritys on olemassa ja yksilöllinen tälle Living Security -organisaatiolle, alueelliset bot-tunnistetiedot on määritetty ja yhdistetyssä vuokraajassa on havaittu aktiivinen sovellusasennus.

    <Check>
      Validointi näyttää tekstin **Validation passed**, ennen kuin lähetät tuotantoilmoituksia.
    </Check>
  </Step>

  <Step title="Lähetä testi-ilmoituksia">
    Oletusarvoista henkilökohtaista testiä varten napsauta **Send test to detected installation**.
    Living Security valitsee havaitun aktiivisen henkilökohtaisen asennuksen ja käyttää sen
    tallennettua luotettua identiteettiä ja keskusteluviittausta. Tämä testi ei kutsu
    Microsoft Graphia eikä edellytä `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.

    <Check>Yksisuuntainen testi-ilmoitus näkyy Microsoft Teamsissa.</Check>

    Tarkista vastaava yritys [viestintälokista](/fi/features/communications/log), kun tarvitset toimituksen diagnostiikkatietoja.
  </Step>
</Steps>

## 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.

<Steps>
  <Step title="Pura paketti">
    Pura ZIP-tiedosto. Se sisältää täsmälleen kolme tiedostoa arkiston juuressa:
    `manifest.json`, `color.png` ja `outline.png`.
  </Step>

  <Step title="Korvaa kuvakkeet">
    Korvaa `color.png` ja `outline.png` omilla kuvakkeillasi. Säilytä samat kaksi
    tiedostonimeä.

    | Tiedosto | Vaatimus |
    | - | - |
    | `color.png` | Täysvärinen PNG, 192 × 192 pikseliä, ei läpinäkyvyyttä |
    | `outline.png` | Läpinäkyvä PNG, 32 × 32 pikseliä |
  </Step>

  <Step title="Aseta sovelluksen nimi">
    Muokkaa tiedostossa `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ä.

          <Note>
            Jos Living Security -sovellus on jo ladattu Teams admin centeriin, aseta
            `version` suuremmaksi 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 lataamasi `manifest.json`-tiedoston
            `version`-arvoon ja aseta arvo, joka on suurempi kuin molemmat. Säilytä
            kolmen numeron `MAJOR.MINOR.PATCH`-muoto.

            Jos esimerkiksi asennettu sovellus on `1.1.1` ja uusi lataamasi paketti on `1.1.0`,
            aseta `1.1.2`. Jos nostaisit ladatun `1.1.0`-version arvoon `1.1.1`, se toistaisi
            asennetun version, ja Teams hylkäisi latauksen.
          </Note>
  </Step>

  <Step title="Jätä identiteettikentät ennalleen">
    Älä muuta näitä kenttiä. Jokainen niistä sisältää sovelluksen, botin tai
    kertakirjautumisen (single sign-on) identiteetin:

    * `id`
    * `botId` tiedostossa `bots`
    * `webApplicationInfo`
    * `validDomains`
    * `contentUrl` ja `websiteUrl` tiedostossa `staticTabs`

          <Warning>
            Identiteettikentän muutos voi jättää sovelluksen asennettavaksi mutta estää sitä
            toimittamasta ilmoituksia tai suorittamasta kertakirjautumista. **Validate install** tarkistaa
            vuokraajan, botin tunnistetiedot ja havaitun asennuksen. Se ei vertaa manifestiasi
            Living Securityn rakentamaan pakettiin.
          </Warning>
  </Step>

  <Step title="Pakkaa kolme tiedostoa uudelleen ZIP-arkistoksi">
    Luo uusi ZIP-arkisto kolmesta tiedostosta. Aseta ne arkiston juureen ilman
    ympäröivää kansiota. Microsoft Teams hylkää paketin, jonka
    `manifest.json` on kansion sisällä.
  </Step>

  <Step title="Lataa ja tarkista">
    Lataa omaksi brändätty ZIP-tiedosto Teams admin centeriin, palaa sitten Living
    Securityyn ja napsauta **Validate install**. Lähetä testi-ilmoitus.

    <Check>
      Validointi näyttää tekstin **Validation passed**, ja testi-ilmoitus saapuu
      Microsoft Teamsiin sovelluksesi nimellä ja kuvakkeilla.
    </Check>
  </Step>
</Steps>

### 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 Graphin `User.Read.All`-sovellusoikeus alueelliselle Living
Security Teams -sovellukselle.

Järjestelmänvalvojan suostumuksen kulku noudattaa tätä Microsoft Entran mallia:

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

Living Security luo tämän URL-osoitteen yhdistetyn vuokraajan tunnuksen ja määrityspaneelissa näkyvän **Bot
app ID** -tunnuksen perusteella. Tunnuksilla on eri tarkoitukset:

* **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.

Älä korvaa suostumus-URL-osoitteessa Teams app ID -tunnusta toisella tunnuksella. Kohdassa Connected Integrations oleva **Microsoft Entra ID
(Client Credentials)** -integraatio on erillinen, yleiskäyttöinen integraatio.
Alueellinen Teams-botti ei voi käyttää sen tunnistetietoja tai suostumusta, eikä
asiaan liittymättömälle Entra-sovellukselle annettu suostumus mahdollista
tätä hakuvaihtoehtoa.

<Note>
  Suostumuksen tekeminen valinnaiseksi ei poista `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ä.
</Note>

## Ilmoitustyypit

Organisaatiosi käyttöoikeuksista ja määritetyistä toimintasuunnitelmista riippuen Living Security voi lähettää:

| Ilmoitus | Kuvaus |
| - | - |
| Koulutustehtävät | Ilmoittaa käyttäjille, kun koulutus on määrätty, erääntyy tai on valmis suoritettavaksi |
| Koulutusmuistutukset | Muistuttaa käyttäjiä lähestyvistä määräajoista |
| Ihmisriskihälytykset | Lähettää henkilökohtaisia Ihmisriskiindeksi-päivityksiä ja suositeltuja seuraavia toimia |
| Käyttöönottoviestit | Lähettää yksisuuntaisia perehdytys- tai käyttöönotto-ilmoituksia käyttöönoton aikana |
| Kanavatiedotteet | Julkaisee tietoturvaohjelman viestintää määritetyille Teams-kanaville |

## 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](#alueellisen-paketin-br%C3%A4nd%C3%A4ys-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](#alueellisen-paketin-br%C3%A4nd%C3%A4ys-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

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="Kanavatiedote ei näy">
    <ul>
      <li>
        Varmista, että Living Securityn Teams-sovellus on asennettu kohdetiimiin tai
        -kanavalle.
      </li>

      <li>
        Varmista, että Living Securityn kanavamääritys käyttää oikeaa tiimiä ja
        kanavaa.
      </li>

      <li>
        Tarkista, onko kanava poistettu, nimetty uudelleen, arkistoitu tai rajoitettu.
      </li>

      <li>
        Asenna sovellus uudelleen kohdetiimiin tai -kanavalle ja lähetä uusi testi-ilmoitus.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Valinnainen sähköposti-/UPN-haku tai suostumus epäonnistuu">
    <ul>
      <li>
        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.
      </li>

      <li>
        Varmista, että määritetty vuokraajan tunnus on vuokraaja, jossa käyttäjät ja Teams
        sijaitsevat.
      </li>

      <li>
        Varmista, että käyttäjä on olemassa Microsoft Entra ID:ssä eikä ole vieras
        toisesta vuokraajasta.
      </li>
    </ul>
  </Accordion>

  <Accordion title="Viestintäloki näyttää, että Microsoftin järjestelmänvalvojan suostumus vaaditaan">
    Virhekategoria `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.

    1. Avaa **Asetukset → Communications → Channels → Microsoft Teams**. Voit käyttää myös viestintälokin virheen kohtaa **Open Microsoft Teams setup**.
    2. Varmista, että oikea Microsoft Entra -vuokraajan tunnus on yhdistetty.
    3. 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.All` nä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.
    4. 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.

    **Microsoft Entra ID (Client Credentials)** -integraation uudelleenmääritys ei korjaa tätä virhettä, koska Teams-ilmoitusten toimitus ei käytä kyseistä integraatiota.
  </Accordion>

  <Accordion title="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

    Esimerkki vianmäärityksessä käytettävistä asennustapahtuman kentistä:

    ```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"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Tietoturva

Living Security käyttää Microsoft Graphin `User.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.

## Liittyvää

<CardGroup cols={2}>
  <Card title="Sähköpostiintegraatio" icon="envelope" href="/fi/integrations/outbound/email">
    Määritä sähköposti toimituskanavaksi.
  </Card>

  <Card title="Slack-integraatio" icon="slack" href="/fi/integrations/outbound/slack">
    Määritä Slack toimituskanavaksi.
  </Card>

  <Card title="Viestintäloki" icon="clock-rotate-left" href="/fi/features/communications/log">
    Seuraa Teams-toimituksen tilaa ja historiaa.
  </Card>

  <Card title="Todennus" icon="shield-halved" href="/fi/features/settings/sso">
    Microsoft Entra ID:n ja kertakirjautumisen (SSO) määritys.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.