Osoby: Administratorzy firmy, administratorzy zespołu
Platformy: Przeglądarka, aplikacja komputerowa
Integracja z Box pozwala użytkownikom osadzić pliki Box na tablicach Miro. Ten przewodnik obejmuje techniczną implementację integracji, model bezpieczeństwa oraz obsługę danych dla administratorów oceniających lub konfigurujących integrację.
Najważniejsze funkcje
- Live embed: Użytkownicy mogą osadzić zawartość Box na tablicy Miro jako Live Embed w iFrame.
- Secure: Każdy odwiedzający tablicę musi się zalogować w iFrame, zanim zobaczy osadzoną zawartość.
- Display options: Użytkownicy mogą wybrać, czy wyświetlić osadzoną zawartość jako Live Embed, czy jako zakładkę.
- Focus mode: Użytkownicy mogą otworzyć Live Embed lub zakładkę w trybie skupienia, aby obejrzeć je bez rozproszeń.
- Action shortcut: Użytkownicy mogą dodać skrót akcji otwierający okno dialogowe do osadzenia linku z Boxa.
Ograniczenia
- Wybieracz zasobów nie jest dostępny dla tej integracji.
Wdrożenie techniczne
Miro integruje się z Box za pomocą Box REST API. Użytkownicy autoryzują dostęp przy użyciu OAuth 2.0, a następnie łączą swoje pliki Box z tablicą Miro.
Przepływy danych
- Użytkownik należący do zespołu lub organizacji, w której ta funkcja jest włączona, wkleja link Box na tablicę Miro.
- Miro odczytuje link. Jeśli użytkownik jeszcze nie autoryzował integracji, Miro uruchamia proces OAuth i przekierowuje użytkownika na stronę autoryzacji Box.
- Po udzieleniu autoryzacji usługa integracyjna Miro używa tokena dostępu użytkownika, aby wywołać Box REST API i pobrać zawartość.
Jakie dane z Box przechowuje Miro
Miro pobiera i przechowuje następujące dane z wklejonych linków Box:
- Tytuły dokumentów i plików
Retencja danych
Dane osadzone podlegają standardowej zasadzie retencji Miro dla wszystkich danych klientów.
Uwierzytelnianie i autoryzacja
Wklejenie linku Box na tablicę wymaga, aby użytkownik autoryzował integrację na ekranie zgody OAuth Boxa. W zależności od konfiguracji Box u klienta może to również wymagać zatwierdzenia integracji przez administratora Boxa.
Wymagane zakresy autoryzacji
Integracja z Box wymaga następującego zakresu:
-
root_readonly— odczyt wszystkich plików i folderów przechowywanych w Box.
Co Miro przechowuje i w jaki sposób
Miro przechowuje dwie kategorie danych dla tej integracji: dane autoryzacyjne oraz dane podglądu.
- 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 przy użyciu tokena odświeżania, 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 zapisuje tytuły zasobów jako część tablicy Miro, a tytuły i odwołania do obrazów przechowywane są zaszyfrowane w usłudze wewnętrznej.
Unieważnianie tokena
Użytkownicy mogą w dowolnym momencie rozłączyć integrację z Box w ustawieniach swojego konta Box.
Konfiguracja integracji z Box
UWAGA: Tylko administratorzy zespołu Miro mogą zainstalować aplikację. Jeśli Twoja organizacja Miro zezwala tylko na zatwierdzone aplikacje, a zwykły użytkownik wklei link z Box, zobaczy wtedy okno dialogowe z prośbą o zainstalowanie aplikacji.
Aby zainstalować i zacząć korzystać z integracji:
- Skopiuj adres URL pliku Box.
- Wklej adres URL na swoją tablicę Miro.
-
Co stanie się dalej, zależy od tego, kto wkleił link:
- Administrator zespołu Miro wkleja link: Aplikacja zostaje automatycznie autoryzowana i zainstalowana, a podgląd linku pojawia się bez dalszych czynności.
- Zwykły użytkownik wkleja link, a organizacja zezwala wyłącznie na zatwierdzone aplikacje: Otwiera się okno dialogowe z prośbą o instalację aplikacji. Po wysłaniu prośby przez użytkownika administratorzy firmy mogą postępować zgodnie z artykułem Przepływ żądania aplikacji, aby zatwierdzić prośbę.
Połącz konto Box
Po zainstalowaniu i autoryzacji integracji:
- Kliknij Połącz na widżecie utworzonym po wklejeniu adresu URL na tablicę. Zostaniesz przekierowany na stronę, która poprosi o udzielenie Miro dostępu do Twojego konta Box.
- Wprowadź dane dostępowe do konta Box i kliknij Autoryzuj.
- Kliknij Udziel dostępu do Box, aby Miro mogło uzyskać dostęp do Twoich plików w Box.
Po połączeniu Twój plik zostanie osadzony na tablicy z pełną funkcjonalnością Box. Możesz komentować, dodawać adnotacje i przeglądać dokumenty bezpośrednio w osadzeniu; zmiany są widoczne w czasie rzeczywistym, dzięki czemu Twój zespół może współpracować bez opuszczania tablicy.
Wskazówka: Otwórz osadzenie w trybie skupienia, aby w większym i niezakłóconym widoku wyświetlić dokument i wchodzić z nim w interakcję.
Często zadawane pytania
Którzy użytkownicy mogą osadzać zawartość Box w Miro?
Użytkownik i tablica Miro muszą spełniać oba z poniższych kryteriów:
- Użytkownik autoryzował integrację Miro z Box.
- Użytkownik ma dostęp do zawartości Box, którą próbuje osadzić.
Którzy użytkownicy mogą wyświetlać osadzoną zawartość Box?
Każda osoba mająca dostęp do tablicy Miro oraz zgodę właściciela osadzonej zawartości — czyli każda osoba z uprawnieniami do wyświetlania, komentowania lub edycji tablicy. Wyświetlający nie muszą autoryzować integracji ani posiadać licencji Box, aby wyświetlać osadzoną zawartość na tablicy.
Czy użytkownicy muszą ponownie autoryzować, aby wklejać linki na innych tablicach?
Nie, pod warunkiem że autoryzacja jest nadal ważna (Miro uznaje autoryzację za ważną przez miesiąc od jej udzielenia). Użytkownicy mogą wklejać linki Box 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 będzie mógł z niej korzystać.
Czy mogę przez Miro uzyskać dostęp do zawartości Box, do której nie mam dostępu bezpośrednio w Box?
Nie. Możesz osadzić tylko zawartość Box, do której już masz dostęp — nie możesz dzięki integracji zobaczyć rzeczy, których nie możesz otworzyć bezpośrednio w Box. Jeśli jednak ktoś z dostępem osadził tę zawartość jako statyczny obraz na tablicy, którą z nim udostępniasz, możesz wyświetlić 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 Miro, aby ograniczyć, kto może współpracować. Pamiętaj, że statyczny zrzut nie pozwala na przeglądanie danych źródłowych, otwieranie oryginalnego pliku ani zmianę filtrów.
Gdzie znajdę Aneks dotyczący przetwarzania danych Miro?
Zobacz Aneks 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średnie wyświetlanie zasobu (zasób zamiast Live Embed) — obsługiwane przez integrację Figma.