İçeriğe geç
Localtonet Localtonet Panel

Microsoft ile Tek Oturum Açma

Bakiye gerekir HTTP tünelleri

Bu sayfa için yardım al
Bu sayfada 6 bölüm
  1. Başlamadan önce
  2. Adımlar
  3. Microsoft Entra'da bir uygulama kaydedin
  4. Sağlayıcıyı Localtonet'e ekleyin
  5. Bir tünel için açın
  6. Deneyin
  7. Hesap türleri ve uç noktalar
  8. Localtonet Microsoft'tan neyi okur
  9. Sorun giderme
  10. İlgili sayfalar

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 #

Adımlar #

  1. 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:

    1. Microsoft Entra yönetim merkezinde Entra ID › App registrations bölümüne gidin ve New registration düğmesini seçin.
    2. Bir Name girin. Ziyaretçiler giriş yaparken bunu görür.
    3. Supported account types altında uygulamayı kimlerin kullanabileceğini seçin, ardından Register düğmesini seçin.
    4. 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.
    5. 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.
    6. 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/callback

    Bir 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.

  2. 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.

    AlanDeğ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.
    AktifAçık
    Client IDMicrosoft Entra'daki Application (client) ID.
    Client SecretSecret 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:

    AlanDoldurulan değerDeğiştirilsin mi?
    Yetkilendirme uç noktasıhttps://login.microsoftonline.com/common/oauth2/v2.0/authorizecommon değerini sonraki bölümdeki tabloya göre değiştirin.
    Token uç noktasıhttps://login.microsoftonline.com/common/oauth2/v2.0/tokencommon değ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.

  3. 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.

  4. 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ınKimler giriş yapabilir
Single tenant onlyDirectory (tenant) ID değerinizKendi kiracınızın kullanıcıları ve konukları.
Multiple Entra ID tenantsorganizationsHerhangi bir kuruluşun iş veya okul hesapları.
Any Entra ID Tenant + Personal Microsoft accountscommon olarak bırakınİş veya okul hesapları ve kişisel Microsoft hesapları.
Personal accounts onlyconsumersKişisel Microsoft hesapları.

Tek kiracılı bir uygulama için örnek. <TENANT_ID> yerine Directory (tenant) ID değerinizi yazın:

Tek kiracı
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/userinfo

Tek 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.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek