Microsoft 365 üzerinden e-posta gönderme (Graph API)

Neden SMTP değil de Graph API? Microsoft, Exchange Online'da SMTP, IMAP ve POP için Temel Kimlik Doğrulamayı kademeli olarak devre dışı bırakmaktadır. Microsoft Graph API, bir Microsoft 365 posta kutusundan posta göndermek için desteklenen uzun vadeli yöntemdir.

İhtiyacınız olacaklar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Exchange Online içeren bir Microsoft 365 (veya Office 365) aboneliği — örneğin Business Basic, Business Standard, E1, E3, F3 veya posta kutusu sağlayan herhangi bir plan.
• Microsoft Entra ID'ye (eski adıyla Azure Active Directory) yönetici erişimi. Yalnızca bir yönetici, uygulama kaydı oluşturabilir ve posta göndermek için gerekli izni verebilir.
• Gönderim yapılacak bir posta kutusu — genellikle noreply@yourcompany.com gibi paylaşılan bir posta kutusu veya normal bir kullanıcı posta kutusu. Posta kutusunun parolaya ihtiyacı yoktur — Microsoft Graph, kullanıcı girişi değil uygulama kimlik bilgilerini kullanır.
• ExchangeOnlineManagement modülüne sahip Windows PowerShell — yalnızca kurulum sırasında bir kez kullanılır; uygulamanın hangi posta kutularından gönderim yapabileceğini kısıtlamak için gereklidir. (Kurulum talimatları aşağıda verilmiştir.)
• Yaklaşık 20 dakika baştan sona.

Bölüm 1 — Microsoft Entra ID'de uygulama kaydetme

Uygulama kaydı, Microsoft 365'in ParkFlow'u tanıyıp posta göndermesi için yetkilendirme yöntemidir.

1.1 Uygulama kaydını oluşturma

1. https://portal.azure.com adresine gidin ve yönetici olarak oturum açın.
2. Microsoft Entra ID'yi açın (göremiyorsanız üstteki arama çubuğunu kullanın).
3. Sol menüde Uygulama kayıtları'nı seçin, ardından + Yeni kayıt'a tıklayın.
4. Formu doldurun:
   • Ad: ParkFlow Mail (veya başka bir şey — yalnızca siz göreceksiniz).
   • Desteklenen hesap türleri: Yalnızca bu kuruluş dizinindeki hesaplar (tek kiracı).
   • Yeniden yönlendirme URI'si: boş bırakın — ParkFlow bu akış için buna ihtiyaç duymaz.
5. Kaydet'e tıklayın.

Uygulama genel bakış sayfasına yönlendirileceksiniz.

1.2 Kimlikleri kopyalama

Genel bakış sayfasında şu iki değeri kopyalayıp kaydedin — bunları daha sonra ParkFlow'a yapıştıracaksınız:

• Uygulama (istemci) kimliği
• Dizin (kiracı) kimliği

1.3 Mail.Send iznini verme

1. Uygulamanın sol menüsünde API izinleri'ne tıklayın.
2. + İzin ekle'ye tıklayın.
3. Microsoft Graph'ı seçin.
4. Uygulama izinleri'ni seçin (Devredilen değil).
5. Mail.Send'i arayın, kutuyu işaretleyin ve İzin ekle'ye tıklayın.
6. API izinleri sayfasına döndükten sonra <kuruluşunuz> için yönetici onayı ver'e tıklayın ve onaylayın.

Mail.Send için Durum sütunu artık yeşil bir onay işareti göstermelidir.

İsteğe bağlı temizlik: Liste, Azure tarafından otomatik olarak eklenen varsayılan bir User.Read izni içeriyorsa bunu kaldırabilirsiniz — Mail.Send, ParkFlow'un ihtiyaç duyduğu tek izindir.

1.4 İstemci gizli anahtarı oluşturma

1. Sol menüde Sertifikalar ve gizli anahtarlar'a tıklayın.
2. İstemci gizli anahtarları altında + Yeni istemci gizli anahtarı'na tıklayın.
3. Bir açıklama girin (örn. ParkFlow Mail) ve bir son kullanma tarihi seçin (12–24 ay genellikle uygundur).
4. Ekle'ye tıklayın.
5. Gizli anahtarın Değeri'ni hemen kopyalayın. Bu sayfadan ayrıldığınızda değer sonsuza kadar gizlenir.

Artık not ettiğiniz üç değeriniz olmalıdır:

• Dizin (kiracı) kimliği
• Uygulama (istemci) kimliği
• İstemci gizli anahtarı değeri

Bu bilgileri gizli tutun — üçüne birden sahip olan biri kiracınız adına posta gönderebilir.

Bölüm 2 — Uygulamanın kullanabileceği posta kutularını kısıtlama

Bu bölümü dikkatlice okuyun. Mail.Send izni, varsayılan olarak uygulamanın kuruluşunuzdaki herhangi bir kullanıcı adına posta göndermesine izin verir. Bunu yalnızca ParkFlow'un kullanmasını istediğiniz posta kutusu/kutuları ile sınırlandırmalısınız. Microsoft bu adımı açıkça önermektedir — atlanırsa sızdırılan bir istemci gizli anahtarı, herhangi bir kullanıcının adresinden posta göndermek için kullanılabilir.

Erişimi yaklaşık bir dakika süren Uygulama Erişim İlkesi PowerShell cmdlet'iyle kısıtlarsınız.

2.1 Exchange Online PowerShell modülünü yükleme (bir kez)

Windows PowerShell'i Yönetici olarak açın ve şunu çalıştırın:

Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser

PSGallery deposuyla ilgili istemleri kabul edin.

2.2 Exchange Online'da oturum açma

Connect-ExchangeOnline -UserPrincipalName admin@yourcompany.com

Adresi kendi Microsoft 365 yönetici hesabınızla değiştirin. Oturum açmak için bir tarayıcı penceresi açılacaktır.

2.3 Erişim ilkesini oluşturma

Vurgulanan iki değeri kendi değerlerinizle değiştirin:

• <APPLICATION_CLIENT_ID> — 1.2. adımdaki Uygulama (istemci) kimliği.
• noreply@yourcompany.com — ParkFlow'un göndereceği posta kutusu.

``powershell New-ApplicationAccessPolicy -AppId "" -PolicyScopeGroupId "noreply@yourcompany.com"