Ekleme belirteci oluşturma

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

Belirteç oluşturma, web uygulamasına veya portala Power BI raporu veya anlam modeli eklemek için belirteç oluşturmanıza olanak tanıyan bir REST API'dir. Tek bir öğe için veya birden çok rapor veya anlam modeli için belirteç oluşturabilir. Belirteç, isteğinizi Power BI hizmeti karşı yetkilendirmek için kullanılır.

Belirteç oluşturma API'sinde, uygulamadaki (etkin kimlik) kullanıcının kimlik bilgilerine bağlı olarak tek bir kullanıcı için belirteç oluşturmak üzere tek bir kimlik (ana kullanıcı veya hizmet sorumlusu) kullanılır.

Kimlik doğrulaması başarılı olduktan sonra ilgili verilere erişim verilir.

Verilerinizin güvenliğini sağlama

Birden çok müşteriden gelen verileri işleniyorsa, verilerinizin güvenliğini sağlamaya yönelik iki ana yaklaşım vardır: Çalışma alanı tabanlı yalıtım ve Satır düzeyinde güvenlik tabanlı yalıtım. Hizmet sorumlusu profillerinde ve satır düzeyi güvenlikte bunlar arasında ayrıntılı bir karşılaştırma bulabilirsiniz.

Profillerle çalışma alanı tabanlı yalıtım kullanmanızı öneririz, ancak RLS yaklaşımını kullanmak istiyorsanız bu makalenin sonundaki RLS bölümünü gözden geçirin.

Belirteç izinleri ve güvenlik

Belirteç oluşturma API'lerinin GenerateTokenRequest bölümünde belirteç izinleri açıklanmaktadır.

Erişim Düzeyi

• Kullanıcıya görüntüleme veya düzenleme izinleri vermek için allowEdit parametresini kullanın.

• Kullanıcının bu çalışma alanında yeni raporlar oluşturmasına (ya SaveAs ya da CreateNew) izin vermek için, çalışma alanı kimliğini ekleme belirtecine ekleyin.

Satır Düzeyinde Güvenlik

Satır Düzeyi Güvenlik (RLS) ile kullandığınız kimlik, belirteci oluşturmak için kullandığınız hizmet sorumlusunun veya ana kullanıcının kimliğinden farklı olabilir. Farklı kimlikler kullanarak, ekli bilgileri hedeflediğiniz kullanıcıya göre görüntüleyebilirsiniz. Örneğin, uygulamanızda kullanıcılardan oturum açmalarını isteyebilir ve ardından yalnızca oturum açmış kullanıcı bir satış çalışanıysa satış bilgilerini içeren bir rapor görüntüleyebilirsiniz.

RLS kullanıyorsanız, bazen kullanıcının kimliğini ( EffectiveIdentity parametresi) dışarıda bırakabilirsiniz. EffectiveIdentity parametresini kullanmadığınızda, belirtecin veritabanının tamamına erişimi vardır. Bu yöntem, anlamsal modelin tamamını görüntüleme izni olan yöneticiler ve yöneticiler gibi kullanıcılara erişim vermek için kullanılabilir. Ancak, bu yöntemi her senaryoda kullanamazsınız. Aşağıdaki tabloda farklı RLS türleri listelenmiştir ve kullanıcının kimliği belirtilmeden hangi kimlik doğrulama yönteminin kullanılabileceğini gösterir.

Tabloda ayrıca her RLS türü için geçerli olan önemli noktalar ve sınırlamalar gösterilmektedir.

Power BI anlam modelleri için DirectQuery

Başka bir Power BI anlam modeline Doğrudan Sorgu bağlantısı olan bir anlam modeline sahip bir Power BI raporu eklemek için:

• Power BI portalında XMLA uç noktasını, Premium kapasite için okuma-yazmayı etkinleştirme bölümünde açıklandığı gibi Salt Okunur veya Okuma Yazma olarak ayarlayın. Bunu kapasite başına yalnızca bir kez yapmanız gerekir.

• Çok kaynaklı ekleme belirteci oluşturma

  • İstekteki tüm veri kümesi kimliklerini belirtin.
  • İstekteki XmlaPermissionsher anlam modeli için öğesini Salt Okunur olarak ayarlayın.
  • Çoklu Oturum Açma (SSO) özellikli her veri kaynağı için içindeki veri kaynağı için kimlik blobunu DatasourceIdentitysağlayın.

Belirteçlerin süresi dolmadan önce yenileme

Belirteçler bir zaman sınırıyla birlikte gelir. Bu nedenle, bir Power BI öğesini ekledikten sonra, bu öğeyle etkileşime geçmek için sınırlı bir süreniz olur. Kullanıcılarınıza sürekli bir deneyim sunmak için, süresi dolmadan önce belirteci yenileyin (veya yenileyin).

Panolar ve kutucuklar

Belirteç oluştur, raporlar ve anlamsal modeller için çalışır. Pano veya kutucuk için ekleme belirteci oluşturmak için 1 . Panolar GenerateTokenInGroup veya Tile GenerateTokenInGroup API'lerini kullanın. Bu API'ler aynı anda yalnızca bir öğe için belirteçler oluşturur. Birden çok öğe için belirteç oluşturamazsınız.

Bu API'ler için:

• Kullanıcının erişim düzeyini belirlemek için accessLevel parametresini kullanın.

  • Görünüm - Kullanıcıya görüntüleme izinleri verin.

  • Düzenle - Kullanıcıya görüntüleme ve düzenleme izinleri verin (yalnızca rapor için ekleme belirteci oluştururken geçerlidir).

  • Oluşturma - Kullanıcıya yeni rapor oluşturma izinleri verin (yalnızca rapor oluşturmak için ekleme belirteci oluştururken geçerlidir). Rapor oluşturmak için datasetId parametresini de sağlamanız gerekir.

• Kullanıcıların raporu yeni bir rapor olarak kaydetmesine izin vermek için allowSaveAs boole değerini kullanın. Bu ayar varsayılan olarak false olarak ayarlanır ve yalnızca rapor için ekleme belirteci oluşturulurken geçerlidir.

Dikkat edilecekler ve sınırlamalar

• Güvenlik nedeniyle ekleme belirtecinin ömrü, API'yi çağırmak için kullanılan Microsoft Entra belirtecinin kalan ömrüne GenerateToken ayarlanır. Bu nedenle, birkaç ekleme belirteci oluşturmak için aynı Microsoft Entra belirtecini kullanırsanız, oluşturulan ekleme belirteçlerinin ömrü her çağrıda kısalır.

• Katıştırılacak anlamsal model ve öğe iki farklı çalışma alanındaysa, hizmet sorumlusu veya ana kullanıcı en az her iki çalışma alanının da üyesi olmalıdır.

• Data Lake Storage (DLS) kullanarak öğeleri eklemek için Belirteç oluşturma API'sininV2 gerekir.

• Çalışma alanım için ekleme belirteci oluşturamazsınız.

İlgili içerik

• Bir uygulamayı kaydetme
• Müşterileriniz için Power BI Embedded
• Hizmet sorumlusuyla Power BI içeriği ekleme