Käyttöönottosi, valmiiksi täytettynä

Asenna moduuli ja kirjaudu sisään

Selainikkuna avautuu; kirjaudu järjestelmänvalvojan tilillä. Windowsissa PowerShell on valmiina; macOS:ssä aja `brew install --cask powershell` ja sitten `pwsh`.

Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
Connect-ExchangeOnline -UserPrincipalName {{admin}}

Luo ryhmä

Sen ainoa jäsen on jaettu postilaatikkosi. Merkitse muistiin PrimarySmtpAddress, jonka PowerShell tulostaa — se on yleensä tenantin sisäänrakennetulla verkkotunnuksella, ja juuri sitä seuraava komento tarvitsee.

New-DistributionGroup -Name "NoReply Apps" -Alias noreply-apps -Type Security -Members "{{sender}}"

Rajaa sovellus ryhmään

Yksi rivi. Tämä on vaihe, joka muuttaa ”sovelluksen joka voisi lähettää kenen tahansa nimissä” ”sovellukseksi joka voi lähettää täsmälleen yhdestä osoitteesta”.

New-ApplicationAccessPolicy -AppId "{{clientId}}" -PolicyScopeGroupId "{{group}}" -AccessRight RestrictAccess -Description "Missivus (Matomo) may only send as {{sender}}"

Varmista — odota ensin 5 minuuttia

Ensimmäisen rivin on näytettävä AccessCheckResult Granted, toisen on näytettävä Denied. Toisessa rivissä on paikanvaraaja — korvaa se millä tahansa muulla tenanttisi oikealla postilaatikolla, oma osoitteesi käy. Älä jatka ennen kuin se sanoo Denied.

Test-ApplicationAccessPolicy -Identity "{{sender}}" -AppId "{{clientId}}"
Test-ApplicationAccessPolicy -Identity "{{other}}" -AppId "{{clientId}}"

Esitarkastus, lähetä yksi oikea sähköposti PowerShellistä

Valinnainen mutta vahvasti suositeltu — se todistaa tenantin, sovelluksen, salaisuuden ja käytännön päästä päähän ennen kuin Matomo on lainkaan mukana. Jos ensimmäinen osa tulostaa 20 merkkiä, todennus toimii. StatusCode 202 ja sähköposti postilaatikossasi tarkoittavat, että Microsoftin puoli on valmis. Korvaa vastaanottajan paikanvaraaja omalla postilaatikollasi.

$TenantId = "{{tenantId}}"
$ClientId = "{{clientId}}"
$Secret   = "{{secret}}"

$tok = Invoke-RestMethod -Method Post -Uri "https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token" -Body @{ client_id=$ClientId; client_secret=$Secret; scope="https://graph.microsoft.com/.default"; grant_type="client_credentials" }
$tok.access_token.Substring(0,20)

$body = '{"message":{"subject":"Missivus pre-flight","body":{"contentType":"Text","content":"Graph app-only send OK"},"toRecipients":[{"emailAddress":{"address":"{{other}}"}}]},"saveToSentItems":false}'
Invoke-WebRequest -Method Post -Uri "https://graph.microsoft.com/v1.0/users/{{sender}}/sendMail" -Headers @{ Authorization = "Bearer $($tok.access_token)" } -ContentType "application/json" -Body $body | Select-Object StatusCode

Siivoa ja kirjaudu ulos

Salaisuus kirjoitettiin tähän ikkunaan, joten tyhjennä se ja sulje sitten PowerShell.

Remove-Variable Secret,tok,body
Disconnect-ExchangeOnline