Tümleşik analiz erişim belirteçleri

UYGULANANLAR: Uygulama verilerin sahibidir Veriler Kullanıcıya aittir

Power BI içeriğinin (raporlar, panolar ve kutucuklar gibi) tüketilmesi için erişim belirteci gerekir. Çözümünüze bağlı olarak, bu belirteç bir Microsoft Entra belirteci, ekleme belirteci veya her ikisi de olabilir.

Müşterileriniz için ekleme çözümünde uygulama, web kullanıcılarınıza Power BI içeriğine erişim izni veren bir ekleme belirteci oluşturur.

Not

Müşterileriniz için ekleme çözümünü kullandığınızda, web uygulamanıza erişime izin vermek için herhangi bir kimlik doğrulama yöntemini kullanabilirsiniz.

Kuruluşunuz için ekleme çözümünde, web uygulaması kullanıcılarınız kendi kimlik bilgilerini kullanarak Microsoft Entra Kimliği'nde kimlik doğrulaması yapar. Müşterileriniz, Power BI hizmeti erişim iznine sahip oldukları Power BI içeriğine erişebilir.

Microsoft Entra belirteci

Hem müşterileriniz için ekleme hem de kuruluş çözümleriniz için ekleme için bir Microsoft Entra belirteci gerekir. Microsoft Entra belirteci tüm REST API işlemleri için gereklidir ve bir saat sonra süresi dolar.

• Müşterileriniz için ekleme çözümünde, ekleme belirtecini oluşturmak için Microsoft Entra belirteci kullanılır.

• Kuruluşunuz için ekleme çözümünde, Power BI'a erişmek için Microsoft Entra belirteci kullanılır.

Microsoft Entra belirtecini aşağıdaki yollardan biriyle alabilirsiniz:

• Belirteç almak için Bruno gibi bir dış araç kullanın. İstek URL'si şeklindedir https://login.windows.net/{{tenantId}}/oauth2/token. {tenantID} değerini kiracı kimliğiniz ile değiştirin.

• PowerBI-Developer-Samples'daki örnek çözümleri izleyin. Örneğin:

  • Müşterileriniz için ekleme için bu AadService.cs dosyasına bakın. ve scopeBase dosyasını authorityUrl AppOwnsData/Web.config adresinde bulabilirsiniz.

  • Kuruluşunuz için ekleme için bu OwinOpenIdConnect.cs dosyasına bakın. UserOwnsData/Web.config konumunda bulabilirsinizauthorityUrl.

  Not

  Kamu ve ulusal/bölgesel bulutlar için uygulamanıza içerik ekleme bölümünde bazı bağımsız bulutların ve değerlerini bulabilirsiniz authorityUrl scopeBase.

Ekleme belirteci

Müşterileriniz için ekleme çözümünü kullandığınızda web uygulamanızın bir kullanıcının erişebileceği Power BI içeriğini bilmesi gerekir. Aşağıdaki bilgileri belirten bir ekleme belirteci oluşturmak için ekleme belirteci REST API'lerini kullanın:

• Web uygulaması kullanıcınızın erişebileceği içerik

• Web uygulaması kullanıcısının erişim düzeyi (görüntüleme, oluşturma veya düzenleme)

Daha fazla bilgi için bkz . Ekleme belirteci oluştururken dikkat edilmesi gerekenler.

Kimlik doğrulama akışları

Bu bölümde, müşterinizeyönelik ekleme ve kuruluş çözümleriniz için ekleme için farklı kimlik doğrulama akışları açıklanmaktadır.

Müşterileriniz için ekleme

Müşterileriniz için ekleme çözümü etkileşimli olmayan bir kimlik doğrulama akışı kullanır. Müşterileriniz için ekleme çözümünde kullanıcılar Power BI'a erişmek için Microsoft Entra Id'de oturum açmaz. Bunun yerine, web uygulamanız Microsoft Entra kimliğinde kimlik doğrulaması yapmak ve ekleme belirtecini oluşturmak için ayrılmış bir Microsoft Entra kimliği kullanır. Ayrılmış kimlik bir hizmet sorumlusu veya ana kullanıcı olabilir:

• Hizmet sorumlusu Web uygulamanız, Microsoft Entra kimliğinde kimlik doğrulaması yapmak ve yalnızca uygulama için Microsoft Entra belirteci almak için Microsoft Entra hizmet sorumlusu nesnesini kullanır. Bu yalnızca uygulama kimlik doğrulama yöntemi Microsoft Entra Id tarafından önerilir.

  Hizmet sorumlusu kullanırken, Power BI hizmeti yönetici ayarlarında Power BI API'leri erişimini etkinleştirmeniz gerekir. Erişimin etkinleştirilmesi, web uygulamanızın Power BI REST API'lerine erişmesini sağlar. Bir çalışma alanında API işlemlerini kullanmak için hizmet sorumlusunun çalışma alanının üyesi veya yöneticisi olması gerekir.

• Ana kullanıcı Web uygulamanız, Microsoft Entra Kimliği'ne göre kimlik doğrulaması yapmak ve Microsoft Entra belirtecini almak için bir kullanıcı hesabı kullanır. Ana kullanıcı hesabının Power BI Pro veya Kullanıcı Başına Premium (PPU) lisansı olması gerekir.

  Ana kullanıcı hesabı kullandığınızda, uygulamanızın temsilci izinlerini (kapsamlar olarak da bilinir) tanımlamanız gerekir. Ana kullanıcı veya kiracı yöneticisinin Power BI REST API'lerini kullanırken bu izinleri kullanma izni vermesi gerekir.

Microsoft Entra Id'de başarılı bir kimlik doğrulamasından sonra web uygulamanız, kullanıcılarının belirli Power BI içeriğine erişmesine izin vermek için bir ekleme belirteci oluşturur.

Not

• Müşterileriniz için ekleme çözümünü kullanarak ekleme yapmak için A, EM veya P SKU'su olan bir kapasiteye sahip olmanız gerekir.
• Üretime geçmek için bir kapasiteye ihtiyacınız vardır.

Aşağıdaki diyagramda, müşterileriniz için ekleme çözümünün kimlik doğrulama akışı gösterilmektedir .

1. Web uygulaması kullanıcısı, kimlik doğrulama yönteminizle web uygulamanızda kimlik doğrulaması yapar.

2. Web uygulamanız, Microsoft Entra Kimliği'nde kimlik doğrulaması yapmak için bir hizmet sorumlusu veya ana kullanıcı kullanır.

3. Web uygulamanız, Microsoft Entra Id'den bir Microsoft Entra belirteci alır ve Power BI REST API'lerine erişmek için bunu kullanır. Seçtiğiniz kimlik doğrulama yöntemi Power BI REST APIS'sine erişim verir. Bu, kimlik doğrulama yönteminin hizmet sorumlusu mu yoksa ana kullanıcı mı olduğuna bağlıdır.

4. Web uygulamanız Bir Ekleme Belirteci REST API'sini çağırır ve ekleme belirtecini istemektedir. Ekleme belirteci, hangi Power BI içeriğinin ekleyebileceğinizi belirtir.

5. REST API, ekleme belirtecini web uygulamanıza döndürür.

6. Web uygulaması ekleme belirtecini kullanıcının web tarayıcısına geçirir.

7. Web uygulaması kullanıcısı, Power BI'a erişmek için ekleme belirtecini kullanır.

Kuruluşunuz için ekleme

Kuruluşunuz için ekleme çözümü etkileşimli bir kimlik doğrulama akışı kullanır. Web uygulaması kullanıcıları kendi Power BI kimlik bilgilerini kullanarak Microsoft Entra Id'de kimlik doğrulaması yapar. Uygulama Microsoft Entra Id ile kaydedildiğinde ayarlanan API izinlerini onaylaması gerekir. Microsoft İzinleri istendi iletişim penceresi, kullanıcılardan bu izinleri vermelerini ister. Onay verildikten sonra, kullanıcı erişimi olan Power BI içeriğini ekleyebilir.

Not

• Kuruluş çözümünüz için ekleme, A SKU'larını desteklemez.

• Üretime geçmek için aşağıdaki yapılandırmalardan birine ihtiyacınız vardır:

  • Pro lisansı olan tüm kullanıcılar.
  • PPU lisansı olan tüm kullanıcılar.
  • Kapasite veya Doku F64 veya daha büyük kapasite. Bu yapılandırma, tüm kullanıcıların ücretsiz lisanslara sahip olmasını sağlar.

Bu diyagramda, kuruluş çözümünüz için ekleme için kimlik doğrulama akışının bir örneği gösterilir.

1. Web uygulaması kullanıcısı web uygulamasına erişir.

2. Web uygulaması, web uygulaması kullanıcısını Microsoft Entra Id'ye yönlendirir.

3. Web uygulaması kullanıcısı, Power BI kimlik bilgilerini kullanarak Microsoft Entra Kimliği'ne göre kimlik doğrulaması yapar.

4. Microsoft Entra Id, web uygulaması kullanıcısını Microsoft Entra belirteciyle web uygulamasına geri yönlendirir. Örtük bir izin senaryosunda, erişim belirteci kullanıcının tarayıcısına döndürülür.

5. Web uygulaması Microsoft Entra belirtecini kullanıcının web tarayıcısına geçirir.

6. Power BI web uygulamanız, web uygulaması kullanıcısının erişim iznine sahip olduğu raporlar ve panolar gibi Power BI içeriğini eklemek için Microsoft Entra belirtecini kullanır.

İlgili içerik

• Ekleme belirteci oluştururken dikkat edilmesi gerekenler
• Power BI tümleşik analizlerinde kapasite ve SKU'lar

Başka sorunuz var mı? Power BI Topluluğu sormayı deneyin