Ten artykuł odpowiada na najczęściej zadawane pytania dotyczące tego, jak zbudowana jest nasza integracja Jira Cards.
Jak działa uwierzytelnianie Jira-Miro?
Zobacz artykuły w Centrum pomocy dotyczące
- Jira Server (on-premise)
- Jira Data Center (on-premise)
-
Jira Cloud
Wybierz na stronie ustawień Jira Cards.- OAuth 2.0 (3LO)
Czy dane są zabezpieczone podczas przesyłu między Jira a Miro?
Używamy protokołu bezpieczeństwa TLS. Szyfruje on komunikaty HTTP przed wysłaniem i odszyfrowuje je po otrzymaniu. Obsługujemy też mutual TLS w ramach abonamentu Enterprise.
Czy mutual TLS jest obsługiwane?
Tak, Dowiedz się więcej.
Czy Miro przechowuje jakieś dane Jira klienta?
Tak. Miro przechowuje dane kart, które są dodane do tablicy.
Jaki jest okres retencji i jak dane będą zabezpieczone?
W przypadku OAuth 1.0. (Jira Server lub Data Center) także dane są aktualizowane, jeśli webhooki zostaną skonfigurowane podczas procesu instalacji wtyczki Jira Cards. Okres retencji jest nieograniczony. Stosowane są tylko ogólne protokoły bezpieczeństwa Miro.
Czy możemy ograniczyć informacje pobierane z Miro?
Nie znaleźliśmy w dokumentacji Atlassiana wzmianki o tym, jak ograniczyć informacje do zaledwie kilku pól.
Czy możemy otrzymać diagram ilustrujący przepływ danych między Jira a Miro?
Szczegółowe informacje znajdziesz w tym artykule dla deweloperów Jira. Integrację wdrażamy zgodnie z dokumentacją Atlassiana.
Jak obsługiwany jest token?
OAuth 1.0: Używany jest tylko token dostępu. Token dostępu pozostaje ważny przez 5 lat, chyba że zostanie unieważniony (brak możliwości dostosowania, ponieważ zasada ta jest określona po stronie Atlassian. Możesz unieważnić token po stronie Jira za pomocą interfejsu sieciowego). Pamiętaj, że każdy nowy token powoduje przerwanie działania integracji i wymaga ponownego połączenia.
OAuth 2.0: Token dostępu jest ważny przez 1 godzinę. Token odświeżający jest ważny przez 90 dni (jeśli przez 90 dni nie będziesz korzystać z integracji, konieczne będzie ponowne uwierzytelnienie).
Czy jeden token dostępu odpowiada za cały dostęp klienta do Jira?
Każdy użytkownik Miro, który zamierza importować, tworzyć lub edytować karty Jira, musi połączyć swoje indywidualne dane dostępowe do Jira. Wszystkie powyższe działania mogą być wykonywane wyłącznie w imieniu indywidualnych danych dostępowych Jira.
Jak zabezpieczane są tokeny żądań, tokeny dostępu, klucze prywatne i inne sekrety/dane dostępowe OAuth?
W trakcie integracji używane są tylko tokeny dostępu. Są bezpiecznie przechowywane w bazie danych i wykorzystywane wyłącznie po stronie serwera.
Dla OAuth 1.0 (Jira Server i Data Center) authToken jest używany tylko dla webhooka. Nie jest to właściwy token uwierzytelniający używany przez OAuth. Żądania są wysyłane przez zaszyfrowane połączenie. Klucz tajny jest generowany automatycznie i przypisywany do zespołu.
Jakich endpointów używa Twoja integracja?
POST /rest/api/2/issue - create new issue
PUT /rest/api/2/issue/id - update issue
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
Dla OAuth 1.0. (Jira Server i Data Center) dodatkowo używamy:
POST /rest/webhooks/1.0/webhook
Czy karty będą działać z Jira Datacenter?
Tak. Zostaliśmy zatwierdzeni przez Atlassian i wielu naszych klientów z powodzeniem korzysta z kart Jira w środowisku Datacenter. Procedura instalacji jest taka sama.
Jakich adresów IP używacie do komunikacji z systemem Jira?
Listę naszych statycznych adresów IP znajdziesz tutaj.
Zwróć uwagę, że są to adresy używane wyłącznie do komunikacji z systemem Jira. Adresy IP aplikacji Miro są dynamiczne, dlatego aby wszystkie funkcje na tablicach Miro (w tym niektóre związane z kartami Jira) działały poprawnie, prosimy o dodanie naszych domen do Twojej listy dozwolonych.
Czy możemy zintegrować Jira z Miro i zablokować zgłoszenia Jira z ustawionym poziomem bezpieczeństwa "Private"?
Nie, to nie jest możliwe. Poziomy bezpieczeństwa w Jira nie mają przełożenia na Miro.
Czy możesz połączyć Miro z Jira, jeśli korzystasz z serwera Jira?
Ponieważ Miro jest narzędziem online, możesz połączyć się z Jira tylko wtedy, gdy Twoja instancja jest dostępna z publicznego internetu.
Czy możesz połączyć wiele instancji Jira jednocześnie?
Tak. Pamiętaj jednak, że podłączenie instancji Jira dotyczy nawiązania początkowego łącza, natomiast aktywne połączenie oznacza powiązaną instancję, z której aktualnie korzystasz. Aktywne połączenie określa, skąd są importowane karty Jira po otwarciu aplikacji Jira Cards oraz dla której instancji użytkownicy są autoryzowani. Dla danego użytkownika może istnieć tylko jedno (1) aktywne połączenie w danym momencie. Przy użyciu OAuth 2.0 użytkownik może edytować dowolną kartę Jira powiązaną z którąkolwiek z podłączonych instancji, do których jest już uwierzytelniony. Przy użyciu każdego innego protokołu uwierzytelniania cały zespół współdzieli aktywną instancję i może importować oraz pracować wyłącznie z kartami z tej instancji. Możesz zdefiniować wiele ustawień na poziomie organizacji i przełączać aktywne połączenia na poziomie zespołu.
Jaki jest proces migracji z serwera do chmury?
Ponieważ adres bazowy Jira (Jira Base URL) nieuchronnie zmieni się podczas migracji do Cloud, integracja przestanie działać, jeśli nie wprowadzimy zmian po naszej stronie. Skontaktuj się z pomocą Miro w celu uzyskania wsparcia.
Czy Miro utworzy webhook dla każdego zespołu, projektu czy instancji Miro?
Jeśli włączysz Automatyczny webhook w ustawieniach Miro, tworzenie webhooków odbywa się automatycznie. Jeśli korzystasz z autoryzacji na poziomie zespołu w Jira, Miro tworzy webhooki dla każdego zespołu. Jeśli korzystasz z autoryzacji na poziomie organizacji, Miro tworzy webhooki dla każdej organizacji.
Czy wtyczka Jira Cards obsługuje projekty Next-Gen?
Tak.
Pamiętaj, że obecnie po stronie Miro podczas tworzenia karty Jira dla projektu Next-Gen nie ma łącza/pola Epica.
Czy niestandardowe pola Jira są obsługiwane?
Tak — obsługujemy niemal wszystkie pola niestandardowe o podstawowych typach. Jeśli pole ma złożony typ danych, może nie być obsługiwane i powodować nieoczekiwane zachowanie podczas aktualizowania lub tworzenia kart Jira na tablicy.
Co stanie się z istniejącymi kartami Jira, jeśli przełączymy się na inną instancję Jira?
Obecnie, gdy przeniesiesz zgłoszenia Jira z jednego projektu do innego w Jira, nie będą one już aktualizowane po stronie Miro.
Zamiast tego skopiuj adres URL zgłoszenia Jira (Ctrl/Cmd+C) i wklej go na tablicę Miro (Ctrl/Cmd+V). W ten sposób karta Jira pokaże nowe wartości i zostanie automatycznie zaktualizowana.
Jeśli tablica zostanie przeniesiona do innego zespołu w Miro, co stanie się z kartami Jira na tej tablicy?
Karty Jira pozostaną na tablicy, ale nikt nie będzie mógł ich modyfikować (nawet jeśli ta sama instancja Jira jest skonfigurowana dla docelowego zespołu).
Po kliknięciu karty zobaczysz komunikat: „Karta Jira została zaimportowana z innego konta”. Jeśli chcesz, aby karty były edytowalne, zaimportuj je ponownie na tablicę.
Czy integracja Jira Cards wiąże się z dodatkowymi kosztami?
Karty Jira są dostępne we wszystkich płatnych planach oraz w planie Education bez dodatkowych opłat (Starter, Business, Education i Enterprise).
Czy użytkownik ma dostęp do wszystkich kart Jira na tablicy?
Uprawnienia integracji Jira Cards zapewniają, że użytkownicy mogą tworzyć i edytować karty tylko w tych projektach Jira, do których mają dostęp.
Ponieważ wszystkie widżety na tablicy Miro są widoczne dla wszystkich, którzy mają dostęp do tablicy, jeśli ktoś nie ma danych dostępowych do Jira albo ma niewłaściwe dane, będzie mógł zobaczyć zwiniętą kartę Jira na tablicy Miro (z tytułem i niektórymi innymi polami), ale nie będzie mógł jej rozwinąć, aby w pełni ją przejrzeć ani jej zmodyfikować.
Czy Atlassian zakończył wsparcie dla Jira Server?
Tak. Atlassian zakończył wsparcie dla Jira Server w lutym 2024 r.
Czy Miro Planner/Jira Cards obsługują niestandardowe pola Jira: Custom issue types i Custom dependencies?
Tak, oba są obsługiwane. Jeśli pola Custom issue types i Custom dependencies są skonfigurowane w Jira, a Miro Planner jest uwierzytelniony dla tej instancji Jira, to te niestandardowe pola będą dostępne w Planerze.
Czy Miro obsługuje OAuth 2.0 dla Jira Data Center?
Tak. Zobacz Połącz z Jira Data Center przy użyciu OAuth 2.0.
Jak zaimportować zgłoszenia Jira do tabel i na oś czasu?
Możesz przeciągnąć jedną lub kilka kart Jira bezpośrednio do tabeli lub na oś czasu. Obecnie to jedyny sposób.
Które pola w tabeli są połączone z Jira?
Pola systemowe Jira:
- Tytuł
- Opis
- Data zakończenia (Due Date w Jira)
- Przypisana osoba
- Stan
Pola niestandardowe Jira: - Każde niestandardowe pole, które dodasz za pomocą Dodaj pola Jira, oraz następujące automatycznie mapowane pola: Data początkowa, Estymacja. Aby dodać pola niestandardowe do tabeli, kliknij przycisk plus (+) u góry tabeli i wybierz Dodaj pola Jira. Następnie wybierz dowolne niestandardowe pole, które chcesz synchronizować.
Jakie pola w tabeli nie synchronizują się z Jira?
Kliknij komórkę, aby zobaczyć, które pola synchronizują się z Jira. Każde pole, które się synchronizuje, jest oznaczone logo Jira. Wszystkie pozostałe pola są przechowywane wyłącznie w Miro i nie synchronizują się z Jira.
Dlaczego nie mogę edytować pola w tabeli lub na osi czasu spośród pięciu obsługiwanych pól Jira wymienionych powyżej?
Pole może nie być dostępne na ekranie edycji w Jira.
Prosty sposób, by sprawdzić, czy pole jest dostępne na ekranie edycji:
W Miro otwórz panel boczny karty Jira. Sprawdź, czy pole jest widoczne w panelu bocznym. Jeśli pola nie ma, musisz dodać je do ekranu edycji w Jira.
Zdarzają się rzadkie przypadki, gdy pola są edytowalne w Jira, ale nie pojawiają się na ekranie edycji. W takim przypadku nie można ich edytować w Miro.
Czy pole, którego nie możesz edytować, to Start date lub Estimate? Jeśli tak:
Pole może nie istnieć w Jira lub nie być dostępne na ekranie edycji (zobacz poprzedni punkt)
Może występować problem z mapowaniem dla pól Data początkowa lub Estymata, ponieważ są to niestandardowe pola w Jira.
Mapujemy te pola zgodnie z następującą logiką:
- Data początkowa: Sprawdzamy pola o nazwach: Start Date , StartDate, Target Start
- Estymata: Sprawdzamy pola o nazwach: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Jeśli pole Data początkowa lub Estymata nie ma jednej z powyższych nazw, może to wyjaśniać, dlaczego edycja nie działa.
Dlaczego edycja pól Data początkowa lub Estymata w tabeli Miro lub na osi czasu nie działa lub aktualizuje niewłaściwe pole w Jira?
Obecnie korzystamy z automatycznego mapowania pól Start Date i Estimate w Jira. Ponieważ są to pola niestandardowe w Jira, może się zdarzyć, że w konfiguracji Jira istnieje kilka pól spełniających powyższe kryteria.
Wybieramy pierwsze dopasowanie zgodnie z kolejnością nazw pól podaną powyżej:
Na przykład, jeśli zgłoszenie w Jira ma zarówno pola Story Points, jak i Story point estimate, dopasowujemy to, które występuje pierwsze na powyższej liście, czyli Story Points. W związku z tym wszelkie zmiany pola Estimate w Tabeli zaktualizują pole Story Points w Jira, a nie Story point estimate.
Na chwilę obecną nie ma obejścia tego problemu. Jeśli napotkasz ten problem, wyślij proszę opinię do zespołu pomocy, abyśmy mogli lepiej zrozumieć Twoje potrzeby podczas prac nad bardziej zaawansowanymi możliwościami mapowania pól.
Dlaczego nie mogę zaimportować kart Jira z 2 różnych instancji do Tabeli lub Osi czasu?
Obecnie obsługujemy tylko jedną instancję Jira na tabelę lub oś czasu. Po zaimportowaniu karty Jira do tabeli lub do osi czasu tabela lub oś czasu zostaje powiązana z tą konkretną instancją Jira.
Nawet jeśli wszystkie rekordy Jira zostaną usunięte, połączenie z oryginalną instancją Jira pozostaje. Aby zaimportować karty z innej instancji Jira, musisz utworzyć nową tabelę lub oś czasu.
Dlaczego nie widzę ani nie mogę edytować pól Stan i Osoby przypisanej dla moich rekordów Jira w tabeli lub na osi czasu?
Obecnie pola Stan i Osoby przypisanej z Jira nie są obsługiwane w tabelach i na osi czasu. Zdecydowaliśmy się wyłączyć te pola w tabelach i na osi czasu, aby lepiej zarządzać oczekiwaniami, unikać nieporozumień i potencjalnej utraty danych. Pola Stan i Osoby przypisanej w Jira oraz ich zawartość istnieją, jednak nie pojawiają się w tabelach ani na osi czasu.
Nadal możesz edytować te pola bezpośrednio na kartach Jira, korzystając z panelu bocznego. Po prostu przeciągnij wiersz z tabeli lub osi czasu na planszę, aby karta Jira ponownie się pojawiła.
Więcej informacji: