Microsoft 365 / Outlook kapcsolat

A Microsoft integrációval a webhelyed a Microsoft API-ján (Microsoft Graph) át küldi a kimenő leveleket. A hitelesítés API-n megy, ezért nem kell érzékeny bejelentkezési adatot beírnod a WordPress adminfelületére, ami biztonságosabb a hagyományos SMTP-nél.

Mikor ne ezt használd

Az Outlook.com fiókok nem ajánlottak a webhely működéséhez nélkülözhetetlen levelekhez. Az ingyenes levelezők kimenő korlátai előzetes értesítés nélkül változhatnak, és a Microsoft használati és spamvédelmi szabályai is befolyásolják őket. Kis forgalmú webhelyhez, kipróbáláshoz vagy a webhelygazda saját értesítéseihez megfelelhet. Időkritikus vagy nagy mennyiségű levélhez használj tranzakciós levélküldő szolgáltatót (lásd az Integrációk fejezetet).

A kapcsolat lépései

1. Legyen Microsoft-fiókod. Ha még nincs, hozz létre egyet.
2. Hozz létre egy alkalmazást az Azure Portalon, és szerezd meg az Application (client) ID-t és a kliens titkos kulcsát (lásd lent).
3. A WordPressben nyisd meg az SMTP → Beállítások → Integrációk oldalt, kattints a + gombra, és válaszd a Microsoft kártyát.
4. Töltsd ki a Konfiguráció részt (Application ID, Kliens titkos kulcsa).
5. Add hozzá a megfelelő Redirect URI-t az Azure alkalmazáshoz (személyes vagy iskolai/munkahelyi fiókhoz tartozót).
6. Kattints a Bejelentkezés Microsoft-fiókkal gombra, és jelentkezz be egy olyan fiókkal, amely jogosult használni az alkalmazást.
7. Visszatérsz a beállítóoldalra, ahol a kapcsolt állapot látszik. Töltsd ki a további általános beállításokat.
8. Kattints a Mentés és bekapcsolás gombra.
9. Próbáld ki az Eszközök oldal teszt-küldésével.

https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations

A képen a két csak olvasható átirányítási URI, a Másolás gombok és a Bejelentkezés Microsoft-fiókkal gomb látszik.

Beállítások

Konfiguráció

Beállítás	Mit csinál	Alapérték
Application ID	Az Azure által adott alkalmazásazonosító. Kötelező.	üres
Kliens titkos kulcsa	Az Azure-ban létrehozott titkos kulcs értéke (nem a titkos kulcs azonosítója). Kötelező.	üres
Redirect URI (személyes fiókok)	Ezt add meg átirányítási URI-ként, ha az alkalmazás személyes fiókokat támogat. Csak olvasható.	a webhelyed címe alapján kitöltve
Redirect URI (iskolai vagy munkahelyi fiókok)	Ezt add meg, ha az alkalmazás iskolai és munkahelyi fiókokat támogat. Csak olvasható.	a webhelyed címe alapján kitöltve

Az átirányítási URI az a webhelyen lévő cím, ahová a Microsoft a bejelentkezés után visszaküldi a felhasználót.

Általános beállítások

Beállítás	Mit csinál	Alapérték
Visszaküldési útvonal	A kézbesíthetetlenségi értesítések címét az e-mail fejlécébe írja. Nélküle a visszapattanó üzenetek elveszhetnek.	kikapcsolva
Alapértelmezett feladói e-mail-cím	A kimenő levelek feladója. A csatlakoztatott fiók címe vagy ahhoz tartozó álnév lehet. Csak akkor érvényesül, ha a levél nem ad meg saját feladót.	üres
Feladó e-mail-címének kényszerítése	Minden kimenő levélnél ezt a címet használja, felülírva a bővítmények beállításait.	kikapcsolva
Alapértelmezett feladó neve	A feladó neve, ugyanazzal a szabállyal.	üres
Feladó nevének kényszerítése	Minden levélnél ezt a nevet használja.	kikapcsolva
Alapértelmezett válaszcím	A válaszcím, ha a levél nem ad meg sajátot.	üres
Válaszcím kényszerítése	Minden levélnél ezt a válaszcímet használja.	kikapcsolva

Alkalmazás létrehozása az Azure Portalon

A Gravity SMTP-hez egy saját alkalmazás kell az Azure Portalon. Ezt az integráció beállítása előtt végezd el. Szükséged van egy Microsoft Azure-fiókra érvényes előfizetéssel, és egy Microsoft-alapú e-mail-címre, amely küldhet leveleket (Hotmail, Live, Outlook vagy Microsoft 365).

1. Azure-fiók

1. Nyisd meg az Azure Portalt.
2. Jelentkezz be a meglévő Microsoft-fiókoddal, vagy regisztrálj egy új (ingyenes) Azure-fiókot.

2. Alkalmazás létrehozása a Microsoft Entra ID-ban

1. A portálon a felső keresőbe írd be: „Entra”, és válaszd a Microsoft Entra ID találatot.
2. Kattints a Manage → App registrations → + New registration gombra.
3. Töltsd ki az űrlapot a fiók típusa szerint:
   • Name: az alkalmazás neve, például „Gravity SMTP”.
   • Supported account types: személyes fióknál az „Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)” lehetőség, iskolai vagy munkahelyi fióknál az „Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)”.
   • Redirect URI: az első legördülőben válaszd a Web értéket, a másodikba másold be a Gravity SMTP Microsoft-beállításaiban látható átirányítási URI-t. Mindig a fiók típusának megfelelőt használd.
4. Kattints a Register gombra.
5. Az Authentication fülön ellenőrizd a Supported account types és a Redirect URI értékét.

3. Az Application (client) ID másolása

A regisztráció után az Overview oldalra kerülsz. Másold ki az Application (client) ID értékét: ezt a Gravity SMTP Application ID mezőjébe kell beírnod.

4. Kliens titkos kulcs létrehozása

1. A bal oldali menüben nyisd meg a Certificates & secrets részt.
2. Kattints a + New client secret gombra.
3. A Description mezőbe írj nevet (például „gravity_smtp_password”), az Expires értéke legyen 180 days (6 months).
4. Másold ki a Value oszlop értékét (nem a Secret ID-t). Tárold biztonságosan, mert az oldal elhagyása után nem érhető el újra. Ezt kell a Gravity SMTP Kliens titkos kulcsa mezőjébe beírnod.

A titkos kulcs lejár (a példában 180 nap után). Lejárat után a küldés leáll, ezért időben hozz létre újat, és írd át a Gravity SMTP-ben.

5. API-jogosultságok megadása

Az Azure-nak tudnia kell, mit tehet az alkalmazás.

1. Az alkalmazás bal oldali menüjében, a Manage alatt kattints az API permissions pontra.
2. Kattints az Add a permission gombra: jobb oldalon kinyílik egy panel.
3. A Microsoft APIs alatt válaszd a Microsoft Graph lehetőséget.
4. Válaszd a Delegated permissions lehetőséget (nem az Application permissions-t): a Gravity SMTP a te nevedben jelentkezik be.
5. Keresd meg és jelöld be ezeket: Mail.Send (a Mail csoportban), User.Read (a User csoportban, gyakran magától hozzáadódik), valamint az openid, email és profile (az OpenId permissions alatt).
6. Kattints az Add permissions gombra. A Configured permissions listában látnod kell mindet.

Támogatott fióktípusok

Egy alkalmazás vagy személyes, vagy iskolai/munkahelyi fiókokhoz állítható be, a Gravity SMTP a kettőt egyszerre nem kezeli. Ha az alkalmazást iskolai/munkahelyi fiókhoz kell átállítanod:

1. Az alkalmazásban nyisd meg a Manage → Manifest részt.
2. Keresd meg a signInAudience tulajdonságot, és írd át AzureADMultipleOrgs értékre.
3. Mentsd a manifestet.
4. Az Authentication részen ellenőrizd, hogy a Supported account types értéke „Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)”.
5. Add hozzá újra a Gravity SMTP-ben látható megfelelő átirányítási URI-t (a lekérdezési paraméterekkel együtt).