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.

Dekont

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.

    Screenshot of the Power BI Report Builder filter.

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

    Screenshot shows the value Color selected from the Expression menu.

  3. Değer işlevi düğmesine tıklayın.

    Power BI Report Builder value

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

    Screenshot shows the Expression window with Built-in Fields selected as Category and ExecutionTime selected as Item.

  5. Öğe listesinden UserID'yi seçin ve Tamam'a tıklayın.

    Power BI Report Builder UserID

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

    Power BI Report Builder semantic model properties

Sorgu kullanma

  1. Anlam modeli Özellikleri penceresinde, sol gezinti bölmesinde Parametreler'i seçin ve Ekle'ye tıklayın.

    Power BI Report Builder parameters

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

    Power BI Report Builder parameter name

  3. Sol bölmeden Sorgu'yu seçin, Sorgu'da Kullanıcı Kimliği parametresini sorgunuzun bir parçası olarak ekleyin ve Tamam'a tıklayın.

    Dekont

    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.

    Power BI Report Builder queries edit

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 veriyle kısıtlar.

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

Dekont

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 üye veya üzeri (görüntüleyici veya katkıda bulunan değil) çalışma alanı izinlerine sahip olması gerekir.

Ekleme belirteci oluşturma