Aracılığıyla paylaş

Hızlı Başlangıç: İstemci uygulamasını web API'sine erişecek şekilde yapılandırma

  • Makale

Bu hızlı başlangıçta kapsamı belirlenmiş, kendi web API'nize izinler temelinde erişimi olan, Microsoft kimlik platformuna kaydedilmiş bir istemci uygulaması sağlarsınız. Ayrıca istemci uygulamasına Microsoft Graph erişimi de verirsiniz.

İstemci uygulamanızın kaydında bir web API'sinin kapsamlarını belirterek, istemci uygulaması Microsoft kimlik platformu bu kapsamları içeren bir erişim belirteci alabilir. Web API'si kodu içinde, erişim belirtecinde bulunan kapsamlara göre kaynaklarına izin tabanlı erişim sağlayabilir.

Önkoşullar

Web API'nize erişim izinleri ekleme

İpucu

Bu makaledeki adımlar, başladığınız portala göre biraz değişiklik gösterebilir.

API'lere erişim, erişim kapsamlarının ve rollerinin yapılandırılmasını gerektirir. Kaynak uygulama web API'lerinizi istemci uygulamalarına göstermek istiyorsanız, API için erişim kapsamlarını ve rolleri yapılandırabilirsiniz. bir istemci uygulamasının bir web API'sine erişmesini istiyorsanız, uygulama kaydında API'ye erişim izinlerini yapılandırabilirsiniz.

bir istemci uygulamasına kendi web API'nize erişme izni vermek için iki uygulama kaydınızın olması gerekir;

Diyagramda, istemci uygulamasının farklı izin türlerine sahip olduğu ve web API'sinin istemci uygulamasının erişebileceği farklı kapsamlara sahip olduğu iki uygulama kaydının birbiriyle ilişkisi gösterilmektedir. Bu bölümde, istemci uygulamasının kaydına izinler eklersiniz.

Sağda kullanıma sunulan kapsamlara sahip bir web API'sini ve izin olarak seçilen bu kapsamları içeren bir istemci uygulamasını gösteren çizgi diyagram

Hem istemci uygulamanızı hem de web API'nizi kaydettikten ve kapsamlar oluşturarak API'yi kullanıma sunduğunuzda, aşağıdaki adımları izleyerek istemcinin API izinlerini yapılandırabilirsiniz:

  1. Microsoft Entra yönetim merkezinde en az Bir Bulut Uygulaması Yöneticisi olarak oturum açın.

  2. Birden çok kiracıya erişiminiz varsa, Üst menüdeki Ayarlar simgesini kullanarak Dizinler + abonelikler menüsünden uygulama kaydını içeren kiracıya geçin.

  3. Kimlik>Uygulamaları'na> göz atın Uygulama kayıtları ve ardından istemci uygulamanızı (web API'nizi değil) seçin.

  4. API izinleri'ni, ardından İzin ekle'yi ve kenar çubuğunda API'lerim'i seçin.

  5. Önkoşulların bir parçası olarak kaydettiğiniz web API'sini seçin ve temsilci izinleri'ni seçin.

    • Temsilci izinleri , oturum açmış kullanıcı olarak bir web API'sine erişen ve erişimi sonraki adımda seçtiğiniz izinlerle kısıtlanması gereken istemci uygulamaları için uygundur. Bu örnek için Temsilci izinlerini seçili bırakın.

    • Uygulama izinleri , oturum açma veya onay için kullanıcı etkileşimi olmadan bir web API'sine kendileri gibi erişmesi gereken hizmet veya daemon türündeki uygulamalara yöneliktir. Web API'niz için uygulama rolleri tanımlamadığınız sürece bu seçenek devre dışı bırakılır.

  6. İzinleri seçin altında, web API'niz için kapsamlarını tanımladığınız kaynağı genişletin ve istemci uygulamasının oturum açmış kullanıcı adına sahip olması gereken izinleri seçin.

  7. Önkoşulları tamamlarken oluşturduğunuz izni seçin, örneğin. Employees.Read.All

  8. İşlemi tamamlamak için İzin ekle'yi seçin.

API'nize izin ekledikten sonra, yapılandırılmış izinler altında seçili izinleri görmeniz gerekir. Aşağıdaki görüntüde, istemci uygulamasının kaydına eklenen Employees.Read.All temsilci izni örneği gösterilmektedir.

Azure portalında yeni eklenen izni gösteren yapılandırılmış izinler bölmesi

Microsoft Graph API'sinin User.Read iznini de fark edebilirsiniz. Bir uygulamayı Azure portalına kaydettiğinizde bu izin otomatik olarak eklenir.

Microsoft Graph'a erişmek için izin ekleme

Oturum açmış kullanıcı adına kendi web API'nize erişmeye ek olarak, uygulamanızın microsoft graph'te depolanan kullanıcının (veya diğer) verilerine de erişmesi veya bunları değiştirmesi gerekebilir. Alternatif olarak, kullanıcı etkileşimi olmadan işlemler gerçekleştirerek Microsoft Graph'a kendi başına erişmesi gereken hizmet veya daemon uygulamanız da olabilir.

Microsoft Graph için temsilci izni

İstemci uygulamanızın oturum açmış kullanıcı adına e-postasını okuma veya profilini değiştirme gibi işlemler gerçekleştirmesini sağlamak için Microsoft Graph için temsilci izni yapılandırın. Varsayılan olarak, istemci uygulamanızın kullanıcıları oturum açtıklarında, bu uygulama için yapılandırdığınız temsilci izinlerini onaylamaları istenir.

  1. İstemci uygulamanızın Genel Bakış sayfasında API izinleri>Microsoft Graph izin>ekle'yi seçin

  2. Atanan izinler'i seçin. Microsoft Graph birçok izni kullanıma sunar ve en yaygın kullanılanlar listenin en üstünde gösterilir.

  3. İzinleri seçin altında aşağıdaki izinleri seçin:

    İzin Açıklama
    email Kullanıcıların e-posta adresini görüntüleme
    offline_access Buna erişim izni verdiğiniz verilere erişimi koruma
    openid Kullanıcıların oturumunu açma
    profile Kullanıcıların temel profilini görüntüleme

  4. İşlemi tamamlamak için İzin ekle'yi seçin.

İzinleri yapılandırdığınızda uygulamanızın kullanıcılarından, uygulamanızın kendi adlarına kaynak API'sine erişmesine izin vermek için oturum açmaları istenir.

Yönetici olarak, tüm kullanıcılar adına onay verebilirsiniz, böylece bunu yapmaları istenmez. Yönetici onayı daha sonra bu makalenin API izinleri ve yönetici onayı hakkında daha fazla bilgi bölümünde açıklanmıştır.

Microsoft Graph'a uygulama izni

Kullanıcı etkileşimi veya onayı olmadan kendi kimliğini doğrulaması gereken bir uygulama için uygulama izinlerini yapılandırın. Uygulama izinleri genellikle bir API'ye "başsız" bir şekilde erişen arka plan hizmetleri veya daemon uygulamaları ve başka bir (aşağı akış) API'ye erişen web API'leri tarafından kullanılır.

Aşağıdaki adımlarda, örnek olarak Microsoft Graph'ın Files.Read.All iznini verirsiniz.

  1. Microsoft Entra yönetim merkezinde en az Bir Bulut Uygulaması Yöneticisi olarak oturum açın.
  2. Birden çok kiracıya erişiminiz varsa, Üst menüdeki Ayarlar simgesini kullanarak Dizinler + abonelikler menüsünden uygulama kaydını içeren kiracıya geçin.
  3. Kimlik>Uygulamaları'na> göz atın Uygulama kayıtları ve ardından istemci uygulamanızı seçin.
  4. API izinleri>İzin ekle>Microsoft Graph>Uygulaması izinleri'ne tıklayın.
  5. Microsoft Graph tarafından sunulan tüm izinler İzinleri seçin altında gösterilir.
  6. Uygulamanıza vermek istediğiniz izni veya izinleri seçin. Örneğin, kuruluşunuzdaki dosyaları tarayan ve belirli bir dosya türü veya adı hakkında uyarı veren bir daemon uygulamanız olabilir. İzinleri seçin'in altında Dosyalar'ı genişletin ve ardından izni seçinFiles.Read.All.
  7. İzinler ekle'yi seçin.
  8. Microsoft Graph'ın Files.Read.All izni gibi bazı izinler için yönetici onayı gerekir. Yönetici onayı ver düğmesini seçerek yönetici onayı verirsiniz. Daha sonra Yönetici onayı düğmesi bölümünde ele alın.

İstemci kimlik bilgilerini yapılandırma

Uygulama izinlerini kullanan uygulamalar, kullanıcı etkileşimi gerektirmeden kendi kimlik bilgilerini kullanarak kimlik doğrulaması yapar. Uygulamanızın (veya API'nizin) uygulama izinlerini kullanarak Microsoft Graph'a, kendi web API'nize veya başka bir API'ye erişebilmesi için önce bu istemci uygulamasının kimlik bilgilerini yapılandırmanız gerekir.

Bir uygulamanın kimlik bilgilerini yapılandırma hakkında daha fazla bilgi için Hızlı Başlangıç: Uygulamayı Microsoft kimlik platformu kaydetme bölümünün Kimlik bilgileri ekleme bölümüne bakın.

Bir uygulama kaydının API izinleri bölmesi, yapılandırılan izinler tablosunu ve aşağıdaki bölümlerde açıklanan Yönetici onayı düğmesini içerir.

Yapılandırılmış izinler

API izinleri bölmesindeki Yapılandırılan izinler tablosu, uygulamanızın temel işlem için gerektirdiği izinlerin listesini (gerekli kaynak erişimi (RRA) listesi) gösterir. Kullanıcıların veya yöneticilerinin uygulamanızı kullanmadan önce bu izinleri onaylaması gerekir. Diğer, isteğe bağlı izinler daha sonra çalışma zamanında istenebilir (dinamik onay kullanılarak).

Bu, kişilerin uygulamanız için onay vermek zorunda olacağı izinlerin en düşük listesidir. Daha fazlası da olabilir, ancak bunlar her zaman gerekli olacaktır. Güvenlik ve kullanıcıların ve yöneticilerin uygulamanızı kullanırken kendilerini daha rahat hissetmelerine yardımcı olmak için hiçbir zaman ihtiyacınız olmayan bir şey istemeyin.

Yukarıda açıklanan adımları kullanarak bu tabloda görüntülenen izinleri ekleyebilir veya kaldırabilirsiniz. Yönetici olarak, tabloda görünen bir API'nin tüm izinleri için yönetici onayı verebilir ve tek tek izinler için onayı iptal edebilirsiniz.

{kiracınız} için yönetici onayı ver düğmesi, bir yöneticinin uygulama için yapılandırılan izinler için yönetici onayı vermesine olanak tanır. Düğmeyi seçtiğinizde, onay eylemini onaylamanızı isteyen bir iletişim kutusu gösterilir.

Azure portalındaki Yapılandırılmış izinler bölmesinde vurgulanan Yönetici onayı ver düğmesi

Onay verildikten sonra, yönetici onayı gerektiren izinler verilen onay olarak gösterilir:

Azure portalında Files.Read.All izni için verilen yönetici onayını gösteren izinler tablosunu yapılandırma

Yönetici değilseniz veya uygulama için hiçbir izin yapılandırılmadıysa Yönetici onayı ver düğmesi devre dışı bırakılır . Verilmiş ancak henüz yapılandırılmamış izinleriniz varsa, yönetici onayı düğmesiyle bu izinleri işlemeniz istenir. Bunları yapılandırılmış izinlere ekleyebilir veya kaldırabilirsiniz.

Uygulama izinlerini kaldırma

Bir uygulamaya gerekenden çok fazla izin vermemek önemlidir. Uygulamanızdaki bir izin için yönetici onayını iptal etmek için;

  1. Uygulamanıza gidin ve API izinleri'ne tıklayın.
  2. Yapılandırılan izinler'in altında, kaldırmak istediğiniz iznin yanındaki üç noktayı seçin ve ardından İzni kaldır'ı seçin
  3. Görüntülenen açılır pencerede Evet, kaldır'ı seçerek izin için yönetici onayını iptal edin.

İlgili içerik

Uygulamanıza erişebilecek hesap türlerini yapılandırmayı öğrenmek için serideki bir sonraki hızlı başlangıca ilerleyin. Örneğin, erişimi yalnızca kuruluşunuzdaki kullanıcılarla (tek kiracılı) sınırlamak veya diğer Microsoft Entra kiracılarındaki (çok kiracılı) ve kişisel Microsoft hesapları (MSA) olan kullanıcılara izin vermek isteyebilirsiniz.

Bir uygulama tarafından desteklenen hesapları değiştirme