Kto: Administratorzy firmy i administratorzy zespołu
Platformy: Przeglądarka, komputer
Integracja Google Workspace umożliwia użytkownikom osadzanie zawartości Google Docs, Google Sheets i Google Slides na tablicach Miro. Ten przewodnik opisuje techniczną implementację integracji, model bezpieczeństwa oraz przetwarzanie danych dla administratorów, którzy oceniają lub konfigurują integrację.
Najważniejsze funkcje
- Live Embed: Użytkownicy mogą osadzić zawartość Dokumentów Google, Arkuszy Google lub Slajdów Google na tablicy Miro jako iFrame na żywo.
- Bezpieczne: 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 osadzona zawartość ma być wyświetlana jako Live Embed czy jako zakładka.
- Tryb skupienia: Użytkownicy mogą powiększyć Live Embed lub zakładkę do trybu skupienia, aby je wyświetlić bez rozpraszaczy.
- Skrót akcji: Użytkownicy mogą dodać skrót akcji, który otwiera okno dialogowe do osadzania linku do Dokumentów Google, Arkuszy Google lub Slajdów Google.
- Wybieracz zasobów: Użytkownicy mogą dodać konkretny slajd jako statyczny obraz na tablicę, dzięki czemu współpracownicy mogą zobaczyć i odnieść się do tej konkretnej zawartości bez potrzeby dostępu do pliku źródłowego.
- Kontrole administratora: Administratorzy mogą uniemożliwić użytkownikom korzystanie z wybieracza zasobów do dodawania zawartości Google Slides jako statycznych obrazów.
Ograniczenia
- Wybieracz zasobów jest dostępny tylko dla Google Slides. Nie jest dostępny dla Google Docs ani Google Sheets.
Implementacja techniczna
Miro integruje się z Google Workspace za pośrednictwem Google REST API. Użytkownicy autoryzują dostęp za pomocą OAuth 2.0, a następnie łączą swoje pliki Google Docs, Google Sheets lub Google Slides z tablicą Miro.
Kwestie bezpieczeństwa
Wybieracz zasobów integracji pozwala użytkownikom dołączać część pliku Google Slides do planszy jako statyczny obraz. Tylko uprawnieni użytkownicy mają dostęp do Live Embed, ale każdy, kto ma dostęp do tablicy, może zobaczyć dołączony statyczny obraz. Dodawanie zasobów z osadzeń jest domyślnie wyłączone na tablicach publicznych.
Administratorzy firmy mogą wyłączyć wybieracz zasobów dla wszystkich tablic:
- Przejdź do Ustawienia firmy > Aplikacje i integracje > Aplikacje > Google Office Integration App (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 na tablicę Miro link do Google Docs, Google Sheets lub Google Slides.
- Miro odczytuje link. Jeśli użytkownik nie autoryzował jeszcze integracji, Miro rozpoczyna proces OAuth i przekierowuje użytkownika na stronę autoryzacji Google.
- Po udzieleniu autoryzacji usługa integracyjna Miro używa tokenu dostępu użytkownika, aby wywołać Google REST API i pobrać zawartość.
Jakie dane z Google przechowuje Miro
Miro pobiera i przechowuje następujące dane z wklejanych linków z Google Workspace:
- Tytuły dokumentów i plików
- Obrazy utworzone przez narzędzie wyboru zasobów
Retencja danych
Dane osadzone podlegają standardowej zasadzie retencji danych Miro dla wszystkich danych klientów.
Uwierzytelnianie i autoryzacja
Osadzenie linku do Google Docs, Sheets lub Slides na tablicy wymaga, by użytkownik autoryzował integrację za pomocą ekranu zgody OAuth Google. W zależności od konfiguracji Google Workspace u klienta, może to także wymagać zatwierdzenia integracji przez administratora Google Workspace.
Wymagane zakresy autoryzacji
Integracja z Google Workspace wymaga następujących zakresów:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
Co jest przechowywane w Miro i w jaki sposób
Miro przechowuje dwie kategorie danych dla tej integracji: dane autoryzacyjne i dane związane z rozwijaniem linków.
- Dane autoryzacyjne: Miro przechowuje token dostępu i token odświeżania w swojej bazie danych przez kilka dni. Dopóki autoryzacja jest aktywna, Miro automatycznie odświeża wygasły token dostępu za pomocą tokena odświeżającego, bez konieczności ponownej autoryzacji przez użytkownika. Wszystkie dane przechowywane dla tej integracji są szyfrowane w stanie spoczynku przy użyciu 256-bitowego AES.
- Dane związane z rozwijaniem linków: Miro przechowuje dwa rodzaje danych związanych z rozwijaniem linków: obrazy przechwycone przez narzędzie wyboru zasobów (przechowywane jako część tablicy) oraz tytuły i odwołania do obrazów (przechowywane zaszyfrowane w wewnętrznej usłudze).
Unieważnianie tokena
Użytkownicy mogą w dowolnym momencie cofnąć dostęp integracji ze swojego konta Google, postępując zgodnie z przewodnikiem Google Identity.
Konfiguracja integracji Google Workspace
Uwaga: Tylko administratorzy zespołu Miro mogą zainstalować aplikację. Jeśli Twoja organizacja Miro pozwala tylko na zatwierdzone aplikacje, a zwykły użytkownik wklei link z Google Workspace, zobaczy w zamian okno dialogowe z prośbą o zainstalowanie aplikacji.
Aby zainstalować i zacząć korzystać z integracji:
- Skopiuj adres URL pliku w Dokumentach Google, Arkuszach Google lub Prezentacjach Google.
- Wklej adres URL na swoją tablicę w Miro.
-
Co stanie się dalej zależy od tego, kto wkleił link:
- Administrator zespołu Miro wkleja link: Aplikacja zostaje autoryzowana i zainstalowana automatycznie, a podgląd linku pojawia się bez dodatkowych 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 przez użytkownika administratorzy firmy mogą postępować zgodnie z artykułem Przepływ prośby o aplikację, aby zatwierdzić prośbę.
Połącz konto Google
Po zainstalowaniu i autoryzowaniu integracji:
- Kliknij Połącz w widżecie utworzonym po wklejeniu adresu URL na tablicy. Zostaniesz przekierowany na stronę Google, która poprosi cię o przyznanie Miro dostępu do twojego konta.
- Potwierdź autoryzację po stronie Google. Zawartość Google zostanie dodana do twojej tablicy jako iFrame.
Często zadawane pytania
Którzy użytkownicy mogą osadzić zawartość Google w Miro?
Użytkownik i tablica Miro muszą spełniać oba z poniższych kryteriów:
- Użytkownik autoryzował integrację Miro z Google Workspace.
- Użytkownik ma dostęp do treści Google, które próbuje osadzić.
Którzy użytkownicy mogą wyświetlać osadzone treści Google?
Każda osoba mająca dostęp do tablicy Miro oraz odpowiednie uprawnienia nadane przez właściciela osadzonej zawartości — czyli osoba z uprawnieniami do wyświetlania, komentowania lub edycji tablicy. Wyświetlający nie muszą autoryzować integracji ani posiadać licencji Google, aby zobaczyć osadzone treści na tablicy.
Czy użytkownicy muszą ponownie autoryzować, aby wklejać linki na innych tablicach?
Nie, o ile autoryzacja jest nadal ważna (Miro traktuje autoryzację jako ważną przez miesiąc od jej udzielenia). Użytkownicy mogą wklejać linki Google Workspace na dowolnej tablicy, a zawartość importuje się normalnie.
Jeśli tablica należy do innego zespołu lub organizacji, w której ta integracja nie jest włączona, użytkownik nie będzie mógł z niej korzystać.
Czy mogę w Miro uzyskać dostęp do treści Google, do których nie mam dostępu bezpośrednio w Google?
Nie. Można osadzać tylko treści Google, do których ma się już dostęp — integracja nie pozwala zobaczyć rzeczy, których nie da się otworzyć bezpośrednio w Google. Jeśli jednak ktoś, kto ma dostęp, wcześniej osadził tę zawartość jako obraz statyczny na tablicy, którą współdzielisz z tą osobą, możesz zobaczyć taki zrzut nawet bez bezpośredniego dostępu do pliku źródłowego. Integracja nie egzekwuje żadnych dodatkowych zasad dostępu poza tym; użyj ustawień udostępniania tablicy w Miro, aby ograniczyć, kto może współpracować. Zwróć uwagę, że statyczny zrzut nie pozwala na przeglądanie danych źródłowych, otwieranie oryginalnego pliku ani zmianę filtrów.
Gdzie znajdę Dodatek dotyczący przetwarzania danych Miro (Miro Data Processing Addendum)?
Zobacz Aneks dotyczący przetwarzania danych Miro.
Co jest niedozwolone na publicznych tablicach Miro?
Ze względów bezpieczeństwa na tablicach publicznych 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średnie wyświetlanie 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 (Google), a nie dostępem 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 administratora aplikacji.
Wyłączenie narzędzia wyboru zasobów uniemożliwia zapisywanie treści z Google jako statycznych obrazów na tablicy Miro, które później mogłyby być widoczne dla osób nieposiadających dostępu do tych plików w Google (na przykład, jeśli tablica jest udostępniona publicznie lub osobom bez dostępu do źródła).