Vložení řídicího panelu

Tato stránka ukazuje, jak vložit řídicí panel AI/BI do externího webu nebo aplikace.

Práce s publikovanými řídicími panely

Do externích aplikací je možné vložit jenom publikované řídicí panely. Řídicí panely je možné publikovat s oprávněními ke sdíleným datům nebo bez. Stručně řečeno, důsledky každého nastavení jsou následující:

  • Oprávnění ke sdíleným datům: U řídicích panelů publikovaných s tímto nastavením určují přihlašovací údaje vydavatele přístup k podkladovým datům. Dotazy se spouštějí s oprávněními vydavatele.

  • Jednotlivá oprávnění k datům: U řídicího panelu publikovaného s tímto nastavením musí mít každý prohlížeč explicitní přístup k podkladovým datům, aby mohl zobrazit výsledky.

Další podrobnosti najdete v tématu Sdílení řídicího panelu.

Poznámka:

Pokud pro vložení používáte instanční objekt, řídí oprávnění instančního objektu přístup k rozhraním API (například načtení konfigurace řídicího panelu nebo vyžádání výsledků). Tato oprávnění však nemají přednost před přístupem uděleným oprávněními ke sdíleným datům.

Možnosti vkládání

Stejně jako u řídicích panelů v uživatelském rozhraní Azure Databricks umožňují vložené řídicí panely centrálně spravovat oprávnění ke čtení datových prostředků spravovaných katalogem Unity a spouštět oprávnění pro řídicí panely, sledovat aktivity uživatelů prostřednictvím historie dotazů a protokolů auditu a udržovat počet jedinečných prohlížečů i pro uživatele bez účtu Azure Databricks. K vložení řídicího panelu použijte jednu z následujících možností.

Základní vkládání

Uživatelé se musí přihlásit pomocí svých Azure Databricks přihlašovacích údajů, aby mohli zobrazit vložený řídicí panel. Následující body popisují klíčové podrobnosti o tom, jak základní vkládání funguje:

  • Autoři řídicího panelu můžou vygenerovat kód prvku iframe z dialogového okna Sdílet .
  • Správci pracovního prostoru musí definovat povolené plochy pro vkládání. Viz Manažování dashboardu a přístup k Genie.
  • Vložené řídicí panely můžou zobrazit jenom uživatelé, kteří mají explicitně udělený přístup. Další informace o sdílení řídicího panelu najdete v tématu Sdílení řídicího panelu .
  • Uživatelům se zobrazí výzva, aby se přihlásili k Azure Databricks, pokud nemají aktivní relaci z posledního přihlášení k původnímu pracovnímu prostoru.

Vkládání pro externí uživatele

Vkládání externích uživatelů umožňuje integrovat řídicí panely do externích systémů, aniž by museli čtenáři mít Azure Databricks účty. Podívejte se na jaké je zadávání externích uživatelů. Vložení použijte pro externí uživatele k:

  • Povolte vaší aplikaci ověřit pomocí Azure Databricks použitím služebního principálu s tajným kódem OAuth.
  • Povolte přístup pro uživatele mimo váš účet Azure Databricks nebo zprostředkovatele identity.

Příklad případu použití

Organizace spravující provoz budov pro správce nemovitostí může použitím vložení pro externí uživatele poskytnout každému správci nemovitostí integrovaný panel pro každou budovu, který zobrazuje spotřebu energie, statistiky obsazenosti a výstrahy údržby v jejich portálu pro správu.

Vestavěné přístupy k ověřování

Pokud chcete pomoct zvolit správný přístup pro vložení, zvažte interakce a případy použití v následující tabulce.

Metoda vkládání Jak se uživatelé ověřují Jak se vyhodnocují oprávnění Typický případ použití Zeptejte se podpory Genie
Ověřování Databricks Uživatelé se přihlašují pomocí účtu Azure Databricks Jsou zaškrtnutá vlastní oprávnění uživatelů (a pokud řídicí panel používá oprávnění ke sdíleným datům, použijí se oprávnění vydavatele). Uživatelé zaregistrovaní v účtu Azure Databricks Podporováno. Viz Ptejte se Genie ve vložených řídicích panelech.
Vkládání pro externí uživatele Aplikace se ověřuje pomocí principálu služby a tokenu OAuth. Oprávnění předmětu služby řídí přístup k rozhraní API, ale oprávnění ke sdíleným datům (pokud jsou udělena) stále určují přístup k datům. Externí uživatelé, portály nebo široká distribuce Není podporováno. Místo toho použijte rozhraní API pro konverzaci Genie .

Poznámka:

Pro vložení dashboardu pro externí uživatele doporučuje Databricks publikovat vložený dashboard s individuálními oprávněními k datům a přiřadit požadovaná oprávnění k datům hlavní službě spojené s aplikací. Pokud je řídicí panel publikován s oprávněními ke sdíleným datům, použijí se oprávnění vydavatele pro přístup k datům, nikoli oprávnění service principal.

Osvědčené postupy pro nastavení oprávnění

Snížení rizika vystavení citlivých dat při použití přístupového tokenu:

  • Publikujte řídicí panel s individuálními oprávněními k datům: Tím se zajistí, že se dotazy spustí s oprávněními prohlížeče, ne s vydavatelem. Zabrání neúmyslnému přístupu, pokud se později rozšíří oprávnění vydavatele.

  • Omezte služebního principála na očekávané tabulky: I když Azure Databricks nemůže odvodit, které tabulky řídicí panel bude dotazovat – zejména s parametrizovanými dotazy – můžete nakonfigurovat svého služebního principála tak, aby omezil přístup tokenu pouze na požadované tabulky.

Tokeny používané pro vkládání externích uživatelů jsou platné po dobu jedné hodiny. Pokud dojde k ohrožení zabezpečení tokenu a byl vytvořen bez správného rozsahu, útočník může mít během této doby přístup k jakýmkoli tabulkám zahrnutým v novější verzi řídicího panelu.

Aktualizace vloženého řídicího panelu

Všichni uživatelé vloženého řídicího panelu můžou ručně aktualizovat řídicí panely na vyžádání. Můžete také nastavit plán pravidelné aktualizace řídicích panelů. Viz Správa plánovaných aktualizací řídicího panelu a předplatných.

Řešení potíží s vloženými řídicími panely

Tato část uvádí běžné problémy a nabízí navrhovaná řešení.

Tmavý režim se nezobrazuje

Ve výchozím nastavení se vložené řídicí panely zobrazují pomocí světlého režimu. Pokud chcete povolit tmavý režim nebo povolit, aby řídicí panel automaticky odpovídal předvolbě systému uživatele, nastavte colorScheme možnost při inicializaci řídicího panelu:

  • "light": Vynutí světlý režim. Toto je výchozí chování, pokud colorScheme není nastaveno.
  • "dark": Vynutí tmavý režim.
  • "light dark": Automaticky odpovídá předvolbě systému nebo prohlížeče uživatele.

Tato možnost odpovídá vlastnosti CSS color-scheme, která se používá u vloženého prvku iframe.

Pokud chcete zobrazit náhled zobrazení řídicího panelu v určitém barevném režimu, otevřete ho v režimu konceptu, přejděte do nastavení řídicího panelu a vyberte požadovaný motiv pod motivem. Další informace o přizpůsobení motivů řídicího panelu najdete v tématu Nastavení motivu.

Vložený prvek iframe je prázdný.

Pokud vložený prvek iframe nezobrazuje data, ujistěte se, že jsou ve vašem prohlížeči povolené soubory cookie třetích stran. Externí obsah, například vložené řídicí panely, vyžaduje, aby toto nastavení fungovalo správně.

Pokud chcete tento problém vyřešit, povolte soubory cookie třetích stran v nastavení prohlížeče. Pokud nechcete povolit soubory cookie pro všechny weby, můžete přidat výjimky pro konkrétní weby. Pokyny ke správě souborů cookie najdete v dokumentaci nápovědy k vašemu prohlížeči.

Následující postup vysvětluje, jak restartovat relaci s povolenými soubory cookie třetích stran v prohlížeči Chrome. Tento proces zajistí čistý stav tím, že nejprve zakážete a znovu povolíte soubory cookie třetích stran:

  1. Odhlaste se ze všech aktivních relací Azure Databricks.
  2. Klikněte na ikonu posuvníku vedle adresy URL.
  3. Klikněte na Soubory cookie a data webu a zakažte nebo zablokujte soubory cookie třetích stran. Zobrazí se výzva k aktualizaci stránky.
  4. Aktualizujte stránku a klikněte na přihlásit se ve vloženém prvku iframe. Měla by se zobrazit chybová zpráva. Zavřete okno prohlížeče.
  5. V části Soubory cookie a data webu povolte soubory cookie třetích stran.
  6. Aktualizujte stránku ještě jednou.
  7. Přejděte na vložený řídicí panel a klikněte na Přihlásit se.

Další kroky

  • Last updated on