Microsoft ile Tek Oturum Açma
Bakiye gerekir HTTP tünelleri
Bu sayfada 6 bölüm
Ziyaretçilerin bir HTTP tüneli açabilmeden önce Microsoft Entra ID iş veya okul hesabıyla ya da kişisel bir Microsoft hesabıyla giriş yapmasını sağlayın. Microsoft Entra'da bir uygulama kaydeder, onu Localtonet'e sağlayıcı olarak eklersiniz, ardından tünel için açarsınız.
Başlamadan önce #
- Hesabınızda bir HTTP tüneli ve Bakiye. Bkz. Tek Oturum Açma genel bakış.
- Uygulama kaydedebilen bir role sahip olarak Microsoft Entra yönetim merkezine erişim. Microsoft en düşük rol olarak Application Developer'ı belirtir.
- Kimin giriş yapabileceğine dair bir karar: yalnızca kuruluşunuz, herhangi bir kuruluş veya kişisel hesaplar da. Bu karar, Localtonet'e girdiğiniz adreslerden ikisini belirler. Bkz. Hesap türleri ve uç noktalar.
Adımlar #
-
Microsoft Entra'da bir uygulama kaydedin #
Microsoft'un kendi kılavuzları şunlardır: Microsoft Entra ID'de uygulama kaydetme, Yönlendirme URI'si ekleme ve Uygulama kimlik bilgileri ekleme. Kısaca:
- Microsoft Entra yönetim merkezinde Entra ID › App registrations bölümüne gidin ve New registration düğmesini seçin.
- Bir Name girin. Ziyaretçiler giriş yaparken bunu görür.
- Supported account types altında uygulamayı kimlerin kullanabileceğini seçin, ardından Register düğmesini seçin.
- Overview sayfasında Application (client) ID değerini kopyalayın. Tek kiracılı bir uygulama için ayrıca Directory (tenant) ID değerini de kopyalayın.
- Manage altında Authentication sayfasını açın, Add Redirect URI düğmesini seçin, Web platformunu seçin, aşağıdaki yönlendirme URI'sini girin ve Configure düğmesini seçin.
- Certificates & secrets › Client secrets bölümünü açın ve New client secret düğmesini seçin. Bir açıklama ekleyin, bir son kullanma süresi seçin ve Add düğmesini seçin. Gizli anahtarın Value değerini hemen kopyalayın: Microsoft, sayfadan ayrıldıktan sonra onu bir daha göstermez.
Yönlendirme URI'si (platform: Web)http://auth.localtonet.com/auth/callbackBir client secret'ın süresi dolar. Microsoft ömrünü 24 ayla sınırlar. Süresi dolduğunda, yeni bir secret oluşturup Localtonet sağlayıcısına kaydedene kadar giriş çalışmaz.
-
Sağlayıcıyı Localtonet'e ekleyin #
Tünellerim › HTTP sayfasını açın ve sayfanın üstündeki SSO düğmesini seçin. SSO sağlayıcıları iletişim kutusunda Sağlayıcı ekle düğmesini seçin.
Alan Değer Sağlayıcı adı Herhangi bir ad, örneğin Company Microsoft. Tünel ayarlarında bunu görürsünüz.Sağlayıcı türü Microsoft. Kaydedilmiş bir sağlayıcının türünü değiştirmek Client ID alanını boşaltır, bu nedenle client ID'yi ve client secret'ı yeniden girin. Aktif Açık Client ID Microsoft Entra'daki Application (client) ID. Client Secret Secret ID değil, gizli anahtarın Value değeri. Kaydedildikten sonra bir daha gösterilmez. Uç noktalar ve callback bölümünü açın. Bu değerler otomatik doldurulur:
Alan Doldurulan değer Değiştirilsin mi? Yetkilendirme uç noktası https://login.microsoftonline.com/common/oauth2/v2.0/authorizecommondeğerini sonraki bölümdeki tabloya göre değiştirin.Token uç noktası https://login.microsoftonline.com/common/oauth2/v2.0/tokencommondeğerini yukarıdakiyle aynı değerle değiştirin.Kullanıcı bilgisi uç noktası https://graph.microsoft.com/oidc/userinfoHayır. Kiracı içermez. Callback yolu /auth/callback/microsoftHayır. İsterseniz E-posta erişim kuralları bölümünü doldurun, ardından Sağlayıcıyı kaydet düğmesini seçin.
-
Bir tünel için açın #
Tünelleriniz altında tünelin Ayarlar düğmesini, ardından SSO Sağlayıcıları yanındaki Yönet düğmesini seçin. Tek oturum açma (SSO) iletişim kutusunda Girişi zorunlu kıl seçeneğini ve Microsoft sağlayıcınızın anahtarını açın. Kaydet düğmesini seçin.
Kimler giriş yapabilir ve Giriş yolları altındaki listeler isteğe bağlıdır. Genel bakışta açıklanmıştır.
-
Deneyin #
Tünel URL'sini özel bir tarayıcı penceresinde açın. Localtonet, sağlayıcınız için bir düğmeyle birlikte Sign in to continue gösterir. Microsoft'ta giriş yaptıktan sonra tünele geri yönlendirilirsiniz ve hizmetiniz yüklenir.
Hesap türleri ve uç noktalar #
Microsoft adresinde login.microsoftonline.com/ sonrasındaki bölüm kimlerin giriş yapabileceğini belirler. Bu bölüm, uygulamanızın Supported account types ayarına uymalıdır. Yetkilendirme uç noktası ve Token uç noktası her zaman aynı değeri alır. Kullanıcı bilgisi uç noktası hiç değişmez.
| Microsoft Entra'daki Supported account types ayarı | common yerine kullanın | Kimler giriş yapabilir |
|---|---|---|
| Single tenant only | Directory (tenant) ID değeriniz | Kendi kiracınızın kullanıcıları ve konukları. |
| Multiple Entra ID tenants | organizations | Herhangi bir kuruluşun iş veya okul hesapları. |
| Any Entra ID Tenant + Personal Microsoft accounts | common olarak bırakın | İş veya okul hesapları ve kişisel Microsoft hesapları. |
| Personal accounts only | consumers | Kişisel Microsoft hesapları. |
Tek kiracılı bir uygulama için örnek. <TENANT_ID> yerine Directory (tenant) ID değerinizi yazın:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoTek kiracılı bir uygulama common ile çalışmaz. Microsoft AADSTS50194 hatasıyla yanıt verir. Ya kiracı kimliğinizi her iki uç noktaya da yazın ya da uygulamayı çok kiracılı bir hesap türüne değiştirin.
Çok kiracılı veya kişisel hesap türünde, kuruluşunuzun dışındaki kişiler Microsoft'ta giriş yapabilir. Yalnızca istediğiniz kişileri kabul etmek için sağlayıcıdaki İzin verilen e-posta alan adları bölümünü veya tüneldeki Kimler giriş yapabilir bölümünü kullanın.
Localtonet Microsoft'tan neyi okur #
Microsoft'un kullanıcı bilgisi uç noktası bir e-posta adresini yalnızca hesapla ilişkilendirilmiş bir adres varsa döndürür, bu nedenle e-posta adresi olmayan bir hesap e-postaya dayalı kuralları geçemeyebilir.
Sorun giderme #
AADSTS50011: the reply URL does not match
İstekteki yönlendirme URI'si uygulama için kayıtlı değil. Mesaj, gönderilen adresi gösterir. Adres, uygulama kaydının Authentication sayfasında, Web platformundaki bir yönlendirme URI'siyle büyük/küçük harfler dahil aynı olmalıdır. Tam olarak http://auth.localtonet.com/auth/callback adresini kaydedin.
AADSTS50194: the application is not configured as a multitenant application
Uygulama tek kiracılıdır ancak uç noktalar hâlâ common içeriyor. Yetkilendirme uç noktası ve Token uç noktası içinde common değerini Directory (tenant) ID değerinizle değiştirin ve Sağlayıcıyı kaydet düğmesini seçin.
AADSTS700016: the application was not found in the directory
Client ID yanlış veya uç noktalar, uygulamanın bulunmadığı bir kiracıyı gösteriyor. Application (client) ID değerini ve uç noktalardaki kiracı kimliğini kontrol edin.
AADSTS7000215 or AADSTS7000222: invalid or expired client secret
Certificates & secrets altında yeni bir client secret oluşturun, Value değerini Localtonet'te Client Secret alanına yapıştırın ve Sağlayıcıyı kaydet düğmesini seçin.
Microsoft yönetici onayı istiyor
Kiracınız kullanıcıların uygulamalara kendilerinin onay vermesine izin vermiyor. Kiracının bir yöneticisi, Microsoft Entra yönetim merkezinde uygulama için onay vermelidir.
Başarılı bir Microsoft girişinden sonra "403 - Access Denied"
Bir Localtonet kuralı hesabı reddetti. Sağlayıcıdaki E-posta erişim kuralları bölümünü, tüneldeki Kimler giriş yapabilir bölümünü ve hesabın hiç e-posta adresi olup olmadığını kontrol edin. Bir kuralı düzelttikten sonra bir dakika bekleyin ve sayfayı yeniden yükleyin.