Katıştırılmış sayfalandırılmış raporlarda satır düzeyi güvenlik uygulama

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

Bu makalede, uygulamanızın veri uygulamasına RLS (satır düzeyi güvenlik) kullanan sayfalandırılmış bir raporun nasıl eklendiğini açıklanmaktadır.

Not

Bu makale yalnızca uygulamanın sahip olduğu veri müşterileri için geçerlidir.

Sayfalandırılmış raporlarınızda RLS kullanmak için:

1. Raporu filtrelemek için ortamı ayarlama
2. Verileri rapor veya sorgu düzeyinde filtreleme
3. Ekleme belirteci kullanarak yapılandırılmış parametreyi geçirme

Önkoşullar

• Bu makalede, Power BI sayfalandırılmış raporunu eklemeyi bildiğiniz varsayılır. Raporun yalnızca kullanıcının erişim iznine sahip olduğunu göstermesi için ekleme belirtecinin nasıl oluşturulacağı açıklanır.

• Sayfalandırılmış raporlar Power BI (Analysis Services) altyapısı değil SQL Server Reporting Services altyapısı kullanılarak oluşturulur, bu nedenle RLS filtresi Power BI Rapor Oluşturucusu'de ayarlanır.

Ortamı ayarlama

Power BI sayfalandırılmış raporuna satır düzeyi güvenlik uygulamak için, bir parametre atamak için yerleşik UserID alanını kullanın. Bu parametre, verilerinizi filtrelemek veya sorgulamak için kullanılır.

Ardından, ekleme belirtecini almak için UserID'yi Ekleme Belirteci - Belirteç Oluşturma API'sine geçirin.

UserID'i rapor veya sorgu düzeyinde filtre olarak kullanma

UserId'yi filtre olarak veya veri kaynağı sorgusunda kullanabilirsiniz.

Verileri filtreleme

1. Anlam modeli Özellikleri penceresinde, sol bölmeden Filtre'yi seçin.

   

2. İfade açılan menüsünden verileri filtrelemek için kullanmak istediğiniz parametreyi seçin.

   

3. Değer işlevi düğmesini seçin.

   

4. İfade penceresindeki Kategori listesinde Yerleşik Alanlar'ı seçin.

   

5. Öğe listesinden Kullanıcı Kimliği'ni ve ardından Tamam'ı seçin.

   

6. Anlam modeli Özellikleri penceresinde, ifadenin seçtiğiniz parametre = UserID olduğunu doğrulayın ve Tamam'ı seçin.

   

Sorgu kullanma

1. Anlam modeli Özellikleri penceresinde, sol gezinti bölmesinden Parametreler'i ve ardından Ekle'yi seçin.

   

2. Parametre Adı alanına @UserID girin ve Parametre Değeri alanına [&UserID] ekleyin.

   

3. Sol bölmeden Sorgu'yu seçin, Sorgu'da UserID parametresini sorgunuzun bir parçası olarak ekleyin ve Tamam'ı seçin.

   Not

   Aşağıdaki ekran görüntüsünde renk parametresi örnek olarak kullanılmıştır (WHERE FinalTable.Color = @UserID). Gerekirse daha karmaşık bir sorgu oluşturabilirsiniz.

   

Ekleme belirteci oluşturma

Müşterileriniz için sayfalandırılmış rapor eklediğinizde, ekleme belirtecini almak için Reports GenerateTokenInGroup API'sini kullanın. Bu belirteç, sayfalandırılmış raporun bazı verilerini filtrelemek için de kullanılabilir.

Bir belirteci yalnızca hizmet sorumlusu kullanarak oluşturabilirsiniz. Ana kullanıcı olarak belirteç oluşturamazsınız. Hizmet sorumlusunun Power BI hizmeti çalışma alanında en az üye izinlerine sahip olması gerekir. (Hizmet sorumlusu katkıda bulunan veya görüntüleyiciyse belirteç oluşturamaz).

Belirteç oluşturmak için, görüntülemek istediğiniz bilgileri içeren alanı atayınusername. Örneğin, renk parametresi olan sayfalandırılmış bir raporda, alana yeşil username girerseniz, ekleme belirteci eklenmiş verileri yalnızca renk sütunundaki değeri yeşil olan verilerle kısıtlar.

{
 "reports": [
 {
  "id": "8d57615e-cfed-4d60-bd21-7dc05727193c"
 }
 ],
 "identities": [
 {
  "username": "green",
  "reports": [
  "8d57615e-cfed-4d60-bd21-7dc05727193c"
  ]
 }
 ]
}

Not

Kullanıcı kimliği belirtmeden ekleme belirteci oluşturursanız, hizmet sorumlusunun object-id değeri kullanılır.

Dikkat edilecekler ve sınırlamalar

• Ana kullanıcı, müşterileriniz için ekleme için sayfalandırılmış raporlarda desteklenmez. Ana kullanıcı, kuruluşunuz için ekleme için desteklenir.
• Hizmet sorumlusunun en az üye veya (görüntüleyici veya katkıda bulunan değil) çalışma alanı izinlerine sahip olması gerekir.

İlgili içerik

Ekleme belirteci oluşturma