Osoby: administratorzy firmy
Integracja z Lookerem pozwala użytkownikom osadzać pulpity Looker i Eksploracje na tablicach Miro. Ten przewodnik obejmuje konfigurację, techniczną implementację integracji, model bezpieczeństwa oraz przetwarzanie danych dla administratorów oceniających lub konfigurujących integrację.
Najważniejsze funkcje
- Osadzanie na żywo: Użytkownicy mogą osadzić pulpit Looker lub Eksplorację w tablicy Miro jako aktywne iFrame.
- Bezpieczeństwo: Każdy odwiedzający tablicę zostanie poproszony o zalogowanie się w iFrame, zanim będzie mógł wyświetlić osadzoną zawartość.
- Opcje wyświetlania: Użytkownicy mogą wybrać, czy osadzone treści mają być pokazane jako Live Embed, czy jako zakładka.
- Tryb skupienia: Użytkownicy mogą otworzyć Live Embed lub zakładkę w trybie skupienia, aby wyświetlić je bez rozpraszania.
- Skrót akcji: Użytkownicy mogą dodać skrót akcji, który otwiera okno dialogowe do osadzenia linku Looker.
- Selektor zasobów: Użytkownicy mogą dodać konkretny wykres lub kafelek jako statyczny obraz na tablicy, dzięki czemu współpracownicy mogą przeglądać i odwoływać się do tego konkretnego elementu bez potrzeby dostępu do pliku źródłowego.
- Kontrole administratora: Administratorzy mogą uniemożliwić użytkownikom korzystanie z selektora zasobów do dodawania zawartości Looker jako statycznych obrazów.
Ograniczenia
- Looker Studio nie jest obsługiwany.
- Looker Looks nie są obsługiwane.
- Osadzanie zapytań scalających Looker lub linków do tablic Looker nie jest obsługiwane.
- Obrazów dodanych za pomocą narzędzia wyboru zasobów nie można odświeżyć.
Znane problemy
Użytkownicy, którzy są już uwierzytelnieni w przeglądarce lub w aplikacji komputerowej Miro, mogą napotkać problemy z uwierzytelnianiem po przełączeniu się między przeglądarką a aplikacją komputerową Miro. Może to przerwać proces uwierzytelniania i zakłócić dostęp do Looker.
Konfiguracja integracji Looker
Wymagania wstępne
- Administrator firmy zatwierdził Looker dla Twojej organizacji Miro.
- Masz uprawnienia administratora w Looker, aby zarejestrować Miro jako aplikację OAuth w Looker.
Zarejestruj aplikację OAuth w Looker
- W Marketplace Looker znajdź i wybierz Rozszerzenie API Explorer, a następnie wybierz Zainstaluj.
- Przejdź do Strona główna > Aplikacje > API Explorer.
- W polu wyszukiwania API Explorer wpisz
oauth, a następnie wybierz Zarejestruj aplikację OAuth w sekcji Uwierzytelnianie. - Wybierz Run It w prawym górnym rogu strony.
-
W formularzu żądania wprowadź następujące wartości:
-
client_guid:
15609152-a12a-4fa1-b364-337e7896d25d -
body:
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Miro Looker Integration", "enabled": true, "group_id": "" } - Pozostaw fields puste.
Dla bardziej zaawansowanych opcji — na przykład ograniczenia autoryzacji do konkretnej grupy Looker za pomocą
group_id— zobacz dokumentację Looker dotyczącą rejestracji aplikacji OAuth (zewnętrzne). -
client_guid:
- Wybierz Rozumiem, że ten punkt końcowy API zmieni dane.
- Wybierz Uruchom. Pomyślne uruchomienie zwraca treść żądania i odpowiedź HTTP 200.
Jeśli zwrócone ciało zawiera"enabled": false, uruchom Aktualizuj aplikację OAuth z tymi samymi wartościami, aby włączyć klienta.
Zainstaluj i autoryzuj integrację w Miro
UWAGA: Tylko administratorzy zespołu Miro mogą zainstalować aplikację. Jeśli w Twojej organizacji Miro dozwolone są tylko zatwierdzone aplikacje, a zwykły użytkownik wklei link do Lookera, zobaczy zamiast tego okno dialogowe z prośbą o zainstalowanie aplikacji.
- Skopiuj adres URL pulpitu Looker lub Explore.
- Wklej adres URL na swoją tablicę Miro.
- Dalsze kroki zależą od tego, kto wkleił link:
- Administrator zespołu Miro wkleja link: Aplikacja jest automatycznie autoryzowana i instalowana, a podgląd linku pojawia się bez potrzeby podejmowania dalszych działań.
-
Zwykły użytkownik wkleja link, a organizacja zezwala tylko na zatwierdzone aplikacje: Otwiera się okno dialogowe z prośbą o zainstalowanie aplikacji. Po wysłaniu prośby administratorzy firmy mogą postępować zgodnie z artykułem Przepływ prośby o aplikację, aby zatwierdzić prośbę.
Połącz konto Looker
Po zainstalowaniu i autoryzacji integracji:
- Kliknij Połącz w widżecie, który pojawił się po wklejeniu adresu URL na tablicy. Zostaniesz przekierowany na stronę, na której trzeba będzie udzielić Miro dostępu do twojego konta Looker.
- Potwierdź autoryzację po stronie Looker. Zawartość Looker zostanie dodana do twojej tablicy jako iFrame.
Wdrożenie techniczne
Miro integruje się z Looker za pomocą Looker REST API. Użytkownicy autoryzują dostęp za pomocą OAuth 2.0, a następnie łączą swoje pulpity Looker lub Explores z tablicą Miro.
Zagadnienia dotyczące bezpieczeństwa
Narzędzie wyboru zasobów integracji pozwala użytkownikom dołączać wykres lub kafelek Looker do planszy jako statyczny obraz. Tylko uprawnieni użytkownicy mogą uzyskać dostęp do Live Embed, natomiast każdy, kto ma dostęp do tablicy, może obejrzeć dołączony statyczny obraz. Domyślnie dodawanie zasobów z osadzeń jest wyłączone na tablicach publicznych.
Administratorzy firmy mogą wyłączyć narzędzie wyboru zasobów dla wszystkich tablic:
- Przejdź do Ustawienia firmy > Aplikacje i integracje > Aplikacje > Podgląd Looker (na karcie Zarządzaj aplikacjami).
- Przełącz Zabroń użytkownikom dodawania zasobów z osadzeń na planszę.
Przepływy danych
- Użytkownik należący do zespołu lub organizacji, w której ta funkcja jest włączona, wkleja link do Looker na tablicę Miro.
- Miro odczytuje link. Jeśli użytkownik jeszcze nie autoryzował integracji, Miro rozpoczyna przepływ OAuth i przekierowuje użytkownika na stronę autoryzacji Looker.
- Po przyznaniu autoryzacji usługa integracji Miro wykorzystuje token dostępu użytkownika, aby wywołać Looker REST API i pobrać zawartość.
Jakie dane z Looker przechowuje Miro
Miro pobiera i przechowuje z wklejonych linków Looker następujące dane:
- Tytuły dashboardów i Explore
- Obrazy utworzone przez asset picker
Retencja danych
Dane osadzone podlegają standardowej zasadzie retencji Miro dotyczącą wszystkich danych klientów.
Uwierzytelnianie i autoryzacja
Osadzenie linku Looker na tablicy wymaga, by użytkownik autoryzował integrację przez API OAuth Looker. Wymaga to także, aby administrator Looker zarejestrował Miro jako aplikację OAuth — zobacz Zarejestruj aplikację OAuth w Looker powyżej.
Wymagane zakresy autoryzacji
Integracja Looker wymaga następującego zakresu:
apiCo Miro przechowuje i w jaki sposób
Miro przechowuje dwa rodzaje danych dla tej integracji: dane autoryzacyjne i dane podglądu.
Dane autoryzacyjne: Miro przechowuje token dostępu (access token) i token odświeżający (refresh token) w swojej bazie danych przez kilka dni. Gdy autoryzacja jest aktywna, Miro automatycznie odnawia wygasły token dostępu przy użyciu tokenu odświeżającego, bez konieczności ponownej autoryzacji przez użytkownika. Wszystkie dane przechowywane dla tej integracji są szyfrowane w spoczynku przy użyciu 256-bitowego AES.
Dane podglądu: Miro przechowuje dwa rodzaje danych podglądu: obrazy przechwycone przez asset picker (przechowywane jako część tablicy) oraz tytuły i odwołania do obrazów (przechowywane zaszyfrowane w usłudze wewnętrznej).
Unieważnianie tokena
Administratorzy Looker mogą unieważnić dostęp integracji z konsoli administracyjnej Looker:
- Przejdź do Administrator > Użytkownicy.
- Wybierz użytkownika.
- Przewiń do Klucze API i wybierz obok tokena Usuń.
Często zadawane pytania
Jak wyłączyć integrację?
Usuń aplikację Miro OAuth z Looker. To nie usuwa danych Looker już osadzonych na tablicach Miro, ale uniemożliwia użytkownikom osadzanie nowych treści lub odświeżanie istniejących zasobów.
Którzy użytkownicy mogą osadzać zawartość Looker w Miro?
Użytkownik i tablica Miro muszą spełniać oba poniższe kryteria:
- Użytkownik autoryzował integrację Miro z Looker.
- Użytkownik ma dostęp do treści z Looker, które próbuje osadzić.
Którzy użytkownicy mogą wyświetlać osadzone treści z Looker?
Każda osoba, która ma dostęp do tablicy Miro i uprawnienia od właściciela osadzonej treści — tzn. osoba z uprawnieniami do wyświetlania, komentowania lub edycji tablicy. Wyświetlający nie muszą autoryzować integracji ani posiadać licencji Looker, aby wyświetlać osadzoną zawartość na tablicy.
Czy użytkownicy muszą ponownie autoryzować, aby wklejać linki na innych tablicach?
Nie — o ile autoryzacja nadal jest ważna (Miro uznaje autoryzację za ważną przez miesiąc od jej udzielenia). Użytkownicy mogą wklejać linki Looker na dowolnej tablicy, a zawartość zostanie zaimportowana normalnie.
Jeśli tablica należy do innego zespołu lub organizacji, w której ta integracja nie jest włączona, użytkownik nie może jej tam używać.
Czy przez Miro mogę uzyskać dostęp do zawartości Looker, do której nie mam dostępu bezpośrednio w Looker?
Nie. Możesz osadzić tylko zawartość Looker, do której już masz dostęp — nie możesz użyć integracji, aby zobaczyć coś, czego nie możesz otworzyć w Looker. Jeśli jednak ktoś z uprawnieniami dostępu osadził tę zawartość jako statyczny obraz na tablicy, którą z nim współdzielisz, możesz wyświetlić ten zrzut nawet bez bezpośredniego dostępu do pliku źródłowego. Integracja nie nakłada żadnych dodatkowych zasad dostępu — użyj ustawień udostępniania tablicy Miro, aby ograniczyć, kto może współpracować. Zwróć uwagę, że statycznego obrazu nie da się użyć do eksploracji danych, otwarcia oryginalnego wykresu ani zmiany filtrów.
Gdzie znajdę Załącznik dotyczący przetwarzania danych Miro?
Zobacz Dodatek dotyczący przetwarzania danych Miro.
Co jest niedozwolone na publicznych tablicach Miro?
Ze względów bezpieczeństwa na publicznych tablicach wyłączone są:
- Wyodrębnianie zasobów — obsługiwane przez integracje: Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel i Microsoft PowerPoint.
- Bezpośredni podgląd zasobu (zasób zamiast Live Embed) — obsługiwane przez integrację Figma.
Jak mogę ograniczyć dostęp do tablicy tylko do tych samych osób, które mają dostęp do pliku źródłowego?
Integracja zarządza tylko dostępem do plików w systemie źródłowym (Looker), a nie w Miro. Domyślnie nie jest to egzekwowane — aby zachować ten poziom bezpieczeństwa, administratorzy organizacji Miro muszą wyłączyć narzędzie wyboru zasobów w ustawieniach administracyjnych aplikacji (zob. Rozważania dotyczące bezpieczeństwa).
Wyłączenie narzędzia wyboru zasobów uniemożliwia zapisywanie zawartości Looker jako statycznych obrazów na tablicy Miro, gdzie mogłyby być później widoczne dla osób, które nie mają do niej dostępu w Looker (na przykład jeśli tablica jest udostępniona publicznie lub osobom, które nie mają dostępu do źródła).