Dış kiracınıza uygulama kaydetme

  • Makale

Şunlar için geçerlidir: Gri X simgesine sahip beyaz daire. İş gücü kiracılarıBeyaz onay işareti simgesi olan yeşil daire. Dış kiracılar (daha fazla bilgi edinin)

Microsoft Entra Dış Kimlik kuruluşunuzun müşterilerin kimliklerini yönetmesine ve genel kullanıma yönelik uygulamalarınıza ve API'lerinize erişimi güvenli bir şekilde denetlemesine olanak tanır. Müşterilerinizin ürünlerinizi satın alabileceği, hizmetlerinize abone olabileceği veya hesap ve verilerine erişebileceği uygulamalar. Müşterilerinizin bir cihazda veya web tarayıcısında yalnızca bir kez oturum açması ve izinlerini vermiş olduğunuz tüm uygulamalarınıza erişmesi gerekir.

Uygulamanızın Dış Kimlik ile oturum açmasını sağlamak için uygulamanızı Dış Kimlik ile kaydetmeniz gerekir. Uygulama kaydı, uygulama ile Dış Kimlik arasında bir güven ilişkisi kurar. Uygulama kaydı sırasında yeniden yönlendirme URI'sini belirtirsiniz. Yeniden yönlendirme URI'si, kullanıcıların kimlik doğrulamasından sonra Dış Kimlik tarafından yönlendirildiği uç noktadır. Uygulama kayıt işlemi, uygulamanızı benzersiz olarak tanımlayan istemci kimliği olarak da bilinen bir uygulama kimliği oluşturur.

Dış Kimlik, web uygulaması veya tek sayfalı uygulama gibi çeşitli modern uygulama mimarileri için kimlik doğrulamasını destekler. Her uygulama türünün dış kiracıyla etkileşimi farklıdır, bu nedenle kaydetmek istediğiniz uygulama türünü belirtmeniz gerekir.

Bu makalede, bir uygulamayı dış kiracınıza kaydetmeyi öğreneceksiniz.

Önkoşullar

Uygulama türünüzü seçin

Tek sayfalı uygulamanızı kaydetme

Dış Kimlik, Tek sayfalı uygulamalar (SPA' lar) için kimlik doğrulamasını destekler.

Aşağıdaki adımlarda SPA'nızı Microsoft Entra yönetim merkezine kaydetme adımları gösterilmektedir:

  1. Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.

  2. Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden dış kiracınıza geçmek için üst menüdeki Ayarlar simgesini kullanın.

  3. Kimlik>Uygulamaları'na> göz atın Uygulama kayıtları.

  4. + Yeni kayıt'ı seçin.

  5. Görüntülenen Uygulamayı kaydet sayfasında, uygulamanızın kayıt bilgilerini girin:

    1. Ad bölümünde, uygulamanın kullanıcılarına gösterilen anlamlı bir uygulama adı girin, örneğin ciam-client-app.

    2. Desteklenen hesap türleri'nin altında Yalnızca bu kuruluş dizinindeki Hesaplar'ı seçin.

    3. Yeniden Yönlendirme URI'si (isteğe bağlı) altında Tek sayfalı uygulama (SPA) öğesini seçin ve URL kutusuna yazınhttp://localhost:3000/.

  6. Kaydet'i seçin.

  7. Kayıt tamamlandığında uygulamanın Genel Bakış bölmesi görüntülenir. Uygulama kaynak kodunuzda kullanılacak Dizin (kiracı) kimliğini ve Uygulama (istemci) kimliğini kaydedin.

Yeniden yönlendirme URI'si hakkında

Yeniden yönlendirme URI'si, kullanıcının kullanıcıyla etkileşimini tamamladıktan sonra yetkilendirme sunucusu (bu örnekte Microsoft Entra Id) tarafından gönderildiği ve başarılı yetkilendirme sonrasında erişim belirtecinin veya yetkilendirme kodunun gönderildiği uç noktadır.

Bir üretim uygulamasında, genellikle uygulamanızın çalıştığı genel olarak erişilebilir bir uç noktadır, örneğin https://contoso.com/auth-response.

Uygulama geliştirme sırasında, uygulamanızın yerel olarak dinlediği uç noktayı ekleyebilirsiniz, örneğin http://localhost:3000. Kayıtlı uygulamalarınıza istediğiniz zaman yeniden yönlendirme URI'leri ekleyebilir ve değiştirebilirsiniz.

Yeniden yönlendirme URI'leri için aşağıdaki kısıtlamalar geçerlidir:

  • Localhost yeniden yönlendirme URL'si kullanmadığınız sürece yanıt URL'si düzeniyle httpsbaşlamalıdır.

  • Yanıt URL'si büyük/küçük harfe duyarlıdır. Büyük/küçük harf, çalışan uygulamanızın URL yolunun durumuyla eşleşmelidir. Örneğin, uygulamanız yolunun .../abc/response-oidcbir parçası olarak içeriyorsa yanıt URL'sinde belirtmeyin .../ABC/response-oidc . Web tarayıcısı yolları büyük/küçük harfe duyarlı olarak ele aldığından, büyük/küçük harf eşleşmeyen .../ABC/response-oidc URL'ye yönlendirildiğinde ile .../abc/response-oidc ilişkili tanımlama bilgileri dışlanabilir.

  • Yanıt URL'si, uygulamanızın beklediği şekilde sondaki eğik çizgiyi içermelidir veya hariç tutmalıdır. Örneğin, https://contoso.com/auth-response ve https://contoso.com/auth-response/ uygulamanızda eşleşmeyen URL'ler olarak ele alınabilir.

Uygulamanızı kaydettikten sonra user.read izni atanır. Ancak, kiracı bir dış kiracı olduğundan, müşteri kullanıcıları bu izni onaylayamaz. Yönetici olarak kiracıdaki tüm kullanıcılar adına bu izni onaylamanız gerekir:

  1. Uygulama kayıtları sayfasında, oluşturduğunuz uygulamayı (ciam-client-app gibi) seçerek Genel Bakış sayfasını açın.

  2. Yönet'in altında API izinleri'ne tıklayın.

    1. Kiracı adınız> için <Yönetici onayı ver'i ve ardından Evet'i seçin.
    2. Yenile'yi seçin, ardından izin için Durum altında Kiracı adınız> için <Verildi seçeneğinin gösterildiğini doğrulayın.

API izinleri verme (isteğe bağlı):

SPA'nızın bir API'yi çağırması gerekiyorsa, API'yi çağırabilmesi için SPA API'nize izin vermelisiniz. Çağırmanız gereken web API'sini de kaydetmeniz gerekir.

İstemci uygulamanıza (ciam-client-app) API izinleri vermek için şu adımları izleyin:

  1. Uygulama kayıtları sayfasında, oluşturduğunuz uygulamayı (ciam-client-app gibi) seçerek Genel Bakış sayfasını açın.

  2. Yönet'in altında API izinleri'ne tıklayın.

  3. Yapılandırılan izinler'in altında İzin ekle'yi seçin.

  4. Kuruluşumun kullandığı API'ler sekmesini seçin.

  5. API'ler listesinde ciam-ToDoList-api gibi API'yi seçin.

  6. Temsilci izinleri seçeneğini belirleyin.

  7. İzinler listesinden ToDoList.Read, ToDoList.ReadWrite öğesini seçin (gerekirse arama kutusunu kullanın).

  8. İzin ekle düğmesini seçin. Bu noktada izinleri doğru atamış olursunuz. Ancak, kiracı bir müşterinin kiracısı olduğundan, tüketici kullanıcıları bu izinlere onay veremez. Bu sorunu çözmek için, yönetici olarak kiracıdaki tüm kullanıcılar adına bu izinleri onaylamanız gerekir:

    1. Kiracı adınız> için <Yönetici onayı ver'i ve ardından Evet'i seçin.

    2. Yenile'yi seçin, ardından her iki kapsam için de Durum altında Kiracı adınız> için <Verildi ifadesinin gösterildiğini doğrulayın.

  9. Yapılandırılan izinler listesinden ToDoList.Read ve ToDoList.ReadWrite izinlerini birer birer seçin ve daha sonra kullanmak üzere iznin tam URI'sini kopyalayın. Tam izin URI'si veya api://{clientId}/{ToDoList.ReadWrite}gibi api://{clientId}/{ToDoList.Read} görünür.

Bağlantı ekleyerek izinleri kullanıma sunma hakkında bilgi edinmek isterseniz Web API'si bölümüne gidin.

Kullanıcı akışını test edin (isteğe bağlı)

Bu uygulama kaydıyla bir kullanıcı akışını test etmek için kimlik doğrulaması için örtük verme akışını etkinleştirin.

Önemli

Örtük akış, üretim uygulamalarınızdaki kullanıcıların kimliğini doğrulamak için değil yalnızca test amacıyla kullanılmalıdır. Testi tamamladıktan sonra kaldırmanızı öneririz.

Örtük akışı etkinleştirmek için şu adımları izleyin:

  1. Microsoft Entra yönetim merkezinde en azından Uygulama Geliştiricisi olarak oturum açın.
  2. Birden çok kiracıya erişiminiz varsa, Dizinler + abonelikler menüsünden dış kiracınıza geçmek için üst menüdeki Ayarlar simgesini kullanın.
  3. Kimlik>Uygulamaları'na> göz atın Uygulama kayıtları.
  4. Oluşturduğunuz uygulama kaydını seçin.
  5. Yönet'in altında Kimlik Doğrulama'yı seçin.
  6. Örtük verme ve karma akışlar'ın altında kimlik belirteçleri (örtük ve karma akışlar için kullanılır) onay kutusunu seçin.
  7. Kaydet'i seçin.

Uygulama (istemci) kimliğini bulma

Yeni bir uygulamayı kaydettikten sonra, Microsoft Entra yönetim merkezindeki genel bakış sayfasından Uygulama (istemci) kimliğini bulabilirsiniz.

  1. Uygulama kayıtları sayfasında Tüm uygulamalar veya Sahip olunan uygulamalar sekmesini seçin.

  2. Uygulamayı seçerek Genel Bakış sayfasını açın.

  3. Temel Bilgiler'in altında Uygulama (istemci) kimliği de dahil olmak üzere tüm uygulama ayrıntılarını bulabilirsiniz.

    Uygulama (istemci) kimliğini gösteren ekran görüntüsü.

Sonraki adımlar