Dela via

Bädda in en kontrollpanel

Den här sidan visar hur du bäddar in en AI/BI-instrumentpanel på en extern webbplats eller ett program.

Arbeta med publicerade instrumentpaneler

Endast publicerade instrumentpaneler kan bäddas in i externa program. Instrumentpaneler kan publiceras med eller utan behörigheter för åtkomst till delad data. Kortfattat är konsekvenserna av varje inställning följande:

  • Behörighet för delade data: För instrumentpaneler som publicerats med den här inställningen fastställer utgivarens autentiseringsuppgifter åtkomst till underliggande data. Frågor körs med utgivarens behörigheter.

  • Enskilda databehörigheter: För en dashboard publicerad med den här inställningen måste varje användare ha explicit åtkomst till den underliggande datan för att se resultaten.

Mer information finns i Dela en instrumentpanel.

Anmärkning

Om du använder ett huvudnamn för tjänsten för inbäddning styr huvudkontots behörigheter åtkomsten till API:er (till exempel att hämta instrumentpanelskonfiguration eller begära resultat). Dessa behörigheter åsidosätter dock inte åtkomst som beviljas av delade databehörigheter.

Inbäddningsalternativ

Precis som med instrumentpaneler i Azure Databricks-användargränssnittet kan du med inbäddade instrumentpaneler centralt hantera läsbehörigheter för Unity Catalog-styrda datatillgångar och köra behörigheter för instrumentpaneler, spåra användaraktivitet via frågehistorik och granskningsloggar och underhålla unika visningsantal även för användare utan ett Azure Databricks-konto. Använd något av följande alternativ för att bädda in instrumentpanelen.

Grundläggande inbäddning

Användarna måste logga in med sina Azure Databricks-autentiseringsuppgifter för att visa den inbäddade instrumentpanelen. Följande punkter beskriver viktig information om hur grundläggande inbäddning fungerar:

  • Instrumentpanelsförfattare kan generera iframe-kod från dialogrutan Dela .
  • Arbetsyteadministratörer måste definiera tillåtna ytor för inbäddning. Se Hantera instrumentpanel och Genie-åtkomst.
  • Endast användare som uttryckligen har beviljats åtkomst kan visa de inbäddade instrumentpanelerna. Mer information om delning av instrumentpaneler finns i Dela en instrumentpanel .
  • Användarna uppmanas att logga in på Azure Databricks om de inte har en aktiv session från en nyligen genomförd inloggning till den ursprungliga arbetsytan.

Inbäddning för externa användare

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Med inbäddning för externa användare kan du integrera instrumentpaneler i externa system utan att användarna behöver ha Azure Databricks-konton. Se Vad är inbäddning för externa användare?. Använd inbäddning för externa användare för att:

  • Tillåt att ditt program autentiserar med Azure Databricks med hjälp av ett huvudnamn för tjänsten med en OAuth-hemlighet.
  • Aktivera åtkomst för användare utanför ditt Azure Databricks-konto eller identitetsprovider.

Exempel på användningsfall

En organisation som hanterar byggåtgärder för fastighetsförvaltare kan använda inbäddning för externa användare för att ge varje egenskapshanterare en inbäddad instrumentpanel för varje byggnad som visar energianvändning, statistik för beläggning och underhållsaviseringar i hanteringsportalen.

Bädda in autentiseringsmetoder

Du kan välja rätt inbäddningsmetod genom att överväga interaktioner och användningsfall i följande tabell.

Inbäddningsmetod Så här autentiserar användare Hur behörigheter utvärderas Typiskt användningsfall
Databricks-autentisering Användare loggar in med Azure Databricks-konto Användarnas egna behörigheter kontrolleras (och om instrumentpanelen använder delade databehörigheter används utgivarens behörigheter) Användare som är registrerade på Azure Databricks-kontot
Inbäddning för externa användare Programmet autentiserar med hjälp av tjänstens huvudnamn och OAuth-token Tjänstens huvudnamns behörigheter styr API-åtkomst, men delade databehörigheter (om de beviljas) avgör fortfarande dataåtkomst Externa användare, portaler eller bred distribution

Anmärkning

För inbäddning för externa användare rekommenderar Databricks att du publicerar den inbäddade instrumentpanelen med enskilda databehörigheter och tilldelar nödvändiga databehörigheter till tjänstens huvudnamn som är associerat med programmet. Om delade databehörigheter används vid publicering av kontrollpanelen, används utgivarens behörigheter för dataåtkomst, inte tjänstens huvudman.

Metodtips för behörighetsinställning

Så här minskar du risken för att exponera känsliga data när du använder en åtkomsttoken:

  • Publicera instrumentpanelen med enskilda databehörigheter: Detta säkerställer att frågeställningar körs med betraktarens behörigheter, inte utgivarens. Det förhindrar oavsiktlig åtkomst om utgivarens behörigheter senare expanderas.

  • Begränsa tjänstens huvudnamn till förväntade tabeller: Även om Azure Databricks inte kan härleda vilka tabeller en instrumentpanel ska köra frågor mot– särskilt med parameteriserade frågor – kan du konfigurera tjänstens huvudnamn för att begränsa tokenåtkomsten till de tabeller som krävs.

Token som används för inbäddning för externa användare är giltiga i en timme. Om en token komprometteras och har skapats utan korrekt omfång kan en angripare komma åt alla tabeller som ingår i en senare version av instrumentpanelen under den tiden.

Uppdatera en inbäddad instrumentpanel

Alla användare av en inbäddad instrumentpanel kan manuellt uppdatera instrumentpaneler på begäran. Du kan också konfigurera ett schema för att uppdatera instrumentpaneler med jämna mellanrum. Se Hantera schemalagda instrumentpanelsuppdateringar och prenumerationer.

Felsöka inbäddade instrumentpaneler

Det här avsnittet innehåller vanliga problem och förslag på lösningar.

Mörkt läge visas inte

Inbäddade instrumentpaneler visas alltid i ljusläge. Om du har anpassat instrumentpanelen med ett tema i mörkt läge eller arbetar i mörkt läge i Azure Databricks, visar den inbäddade iframe bara ljuslägesversionen av temat.

Så här ser du till att den inbäddade instrumentpanelen visas korrekt:

  1. Öppna instrumentpanelen i utkastläge.
  2. Åtkomst till instrumentpanelsinställningar.
  3. Under Tema klickar du på Ljust läge för att förhandsgranska hur instrumentpanelen visas när den är inbäddad.
  4. Justera färger och formatering efter behov för att optimera ljuslägets utseende.

Mer information om hur du anpassar instrumentpanelsteman finns i Temainställningar.

Den inbäddade iframe är tom

Om den inbäddade iframe:en inte visar data kontrollerar du att cookies från tredje part är aktiverade i webbläsaren. Externt innehåll, till exempel inbäddade instrumentpaneler, kräver att den här inställningen fungerar korrekt.

Lös problemet genom att aktivera cookies från tredje part i webbläsarinställningarna. Om du föredrar att inte aktivera cookies för alla webbplatser kan du lägga till undantag för specifika webbplatser. Mer information om hur du hanterar cookies finns i webbläsarens hjälpdokumentation.

Följande steg förklarar hur du startar om sessionen med cookies från tredje part aktiverade i Webbläsaren Chrome. Den här processen säkerställer ett rent tillstånd genom att först inaktivera och sedan återaktivera cookies från tredje part:

  1. Logga ut från alla aktiva Azure Databricks-sessioner.
  2. Klicka på skjutreglageikonen bredvid URL:en.
  3. Klicka på Cookies och webbplatsdata och inaktivera eller blockera cookies från tredje part. Du uppmanas att uppdatera sidan.
  4. Uppdatera sidan och klicka på Logga in i den inbäddade iframe. Ett felmeddelande ska visas. Stäng webbläsarfönstret.
  5. Under Cookies och webbplatsdata tillåter du cookies från tredje part.
  6. Uppdatera sidan igen.
  7. Gå till den inbäddade instrumentpanelen och klicka på Logga in.

Nästa steg

  • Last updated on