Ana içeriğe geç

Setting Up Outlook/Microsoft 365 OAuth Authentication

Bu kılavuz, Outlook/Microsoft 365 ile OAuth kimlik doğrulaması için Microsoft Azure uygulaması oluşturma adımlarında size yol gösterecektir. OAuth, geleneksel parola kimlik doğrulamasına kıyasla Outlook hesabınıza daha güvenli erişim sağlar.

Prerequisites​

  • Microsoft hesabı (kişisel veya Microsoft 365/Office 365)
  • Azure Portal erişimi
  • Perfex CRM kurulum URL'niz (redirect URI yapılandırması için)
bilgi

Microsoft 365 kuruluşları için yönetici onayı gerekebilir.

Step-by-Step Setup​

Step 1: Register an Application in Azure Portal​

  1. Azure Portal adresine gidin
  2. Microsoft hesabınızla oturum açın
  3. "Azure Active Directory"'e gidin (veya arayın)
  4. Sol menüden "App registrations"'a tıklayın
  5. "+ New registration"'a tıklayın
  6. Uygulama bilgilerini doldurun:
    • Name: İsim (örn. "Perfex CRM Mailbox")
    • Supported account types: Maksimum uyumluluk için "Accounts in any organizational directory and personal Microsoft accounts" seçin
    • Redirect URI: Platform: Web, URI: https://your-domain.com/admin/mailbox/oauth/callback?provider=outlook
    • your-domain.com değerini gerçek Perfex CRM etki alanınızla değiştirin
  7. "Register"'e tıklayın

Step 2: Configure API Permissions​

  1. Uygulama kaydında sol menüden "API permissions"'a tıklayın
  2. "+ Add a permission"'a tıklayın
  3. "Microsoft Graph" seçin
  4. "Delegated permissions" seçin
  5. Şunları ekleyin: Mail.Read, Mail.ReadWrite, Mail.Send, offline_access
  6. "Add permissions"'e tıklayın
  7. ÖNEMLİ: Görünüyorsa "Grant admin consent for [Your Organization]"'a tıklayın
uyarı

Kurumsal hesaplar için gerekli. Yönetici yetkileri gerekir.

Step 3: Create Client Secret​

  1. Uygulama kaydında sol menüden "Certificates & secrets"'a tıklayın
  2. "+ New client secret"'a tıklayın
  3. Açıklama girin (örn. "Perfex Mailbox Secret")
  4. Son kullanma: 24 months (üretim için önerilen)
  5. "Add"'e tıklayın
  6. ÖNEMLİ: Value'yu hemen kopyalayın (tekrar görüntülenemez) — bu Client Secret

Step 4: Get Application (Client) ID​

  1. Uygulama kaydında "Overview"'a gidin
  2. Application (client) ID'yi kopyalayın — bu Client ID

Step 5: Configure Redirect URI (Verify)​

  1. Uygulama kaydında sol menüden "Authentication"'a tıklayın
  2. "Redirect URIs" altında redirect URI'nin listelendiğini doğrulayın
  3. Yoksa "+ Add a platform" > "Web" ile ekleyin
  4. "Implicit grant and hybrid flows" altında "Access tokens" işaretli olsun (varsa)
  5. "Save"'e tıklayın

Step 6: Configure in Perfex CRM​

  1. Perfex CRM yönetim alanına gidin
  2. Mailbox > Configuration'a gidin
  3. "OAuth2" ve "Outlook" seçin
  4. Client ID, Client Secret girin
  5. Microsoft 365 kuruluşları için: Tenant ID girin (Azure AD > Overview). Kişisel hesaplar boş bırakın
  6. "Save Configuration"'a tıklayın
  7. "Connect Outlook"'a tıklayın ve Microsoft açılır penceresinde yetkilendirin

Important Limitations & Considerations​

These limitations are imposed by Microsoft, not by our software.
  • Admin Consent: Kurumsal hesaplar yönetici onayı gerektirir
  • Account Type Restrictions: Hesap türü kısıtlamaları
  • Tenant ID: Kurumsal hesaplar Tenant ID gerektirir

Notes​

  • Redirect URI, Azure Portal'daki yapılandırmayla tam eşleşmelidir
  • Client Secret'ı güvende tutun
  • Etki alanını değiştirirseniz Azure Portal'daki redirect URI'yi güncelleyin

Troubleshooting​

"AADSTS50011: Redirect URI mismatch": redirect URI tam eşleşmesi, sondaki eğik çizgiler, HTTP/HTTPS kontrol edin "Admin consent required": Onay almak için Microsoft 365 yöneticinize başvurun "Invalid client secret": Yeni gizli anahtar oluşturun (Value'yu kopyalayın, Secret ID değil)

Additional Resources​

bilgi

Yönetici onay gereksinimleri, hesap türü kısıtlamaları ve token politikaları Azure uygulamaları için Microsoft'un güvenlik politikalarıdır. Bu kısıtlamalar yazılımımız tarafından uygulanmaz.