Ten artykuł odpowiada na najpopularniejsze pytania dotyczące budowy naszej integracji kart Jira.
Jak działa uwierzytelnianie Jira-Miro?
Zobacz artykuły w Centrum pomocy dla
- Jira Server lokalne
- Jira Data Center lokalnie
-
Jira Cloud
Wybierz z ustawień karty Jira.- OAuth 2.0 (3LO)
Czy dane są bezpieczne podczas przesyłania między Jira i Miro?
Używamy protokołu zabezpieczeń TLS, który szyfruje wiadomości HTTP przed ich wysyłką i deszyfruje przy odbiorze. Wspieramy także wzajemny TLS dla wersji Enterprise.
Czy wspieracie wzajemny TLS?
Tak, więcej informacji.
Czy Miro będzie przechowywać dane z Jira klienta?
Tak, Miro przechowuje dane kart, które są dodawane do tablicy.
Jak długi jest okres retencji i jak dane będą zabezpieczane?
Dla OAuth 1.0 (Jira Server lub Data Center) dane są także aktualizowane, jeśli webhooki są skonfigurowane podczas procesu instalacji wtyczki kart Jira. Okres retencji jest nieograniczony. Stosowane są jedynie ogólne protokoły bezpieczeństwa Miro.
Czy możemy ograniczyć informacje pobierane z Miro?
Nie znaleźliśmy żadnej wzmianki w dokumentacji Atlassiana o możliwości ograniczenia informacji do zaledwie kilku pól.
Czy możemy otrzymać diagram pokazujący przepływ danych między Jira a Miro?
Szczegółowe informacje są dostępne w tym artykule dla deweloperów Jira. Naszą integrację wdrażamy zgodnie z dokumentacją Atlassiana.
Jak obsługiwany jest token?
OAuth 1.0: Używa się tylko tokena dostępu. Token dostępu trwa przez 5 lat, chyba że zostanie unieważniony (brak opcji dostosowania, ponieważ zasada ta jest definiowana po stronie Atlassian. Możesz unieważnić token po stronie Jira za pomocą interfejsu webowego). Pamiętaj, że każdy nowy token przerywa działanie integracji i wymaga ponownego połączenia.
OAuth 2.0: Token dostępu trwa 1 godzinę. Token odświeżania trwa 90 dni (jeśli przez 90 dni nie używasz integracji, będziesz musiał ponownie się uwierzytelnić).
Czy jeden token dostępu jest używany dla wszystkich dostępów 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 Jira. Wszystkie powyższe działania mogą być wykonywane tylko w imieniu indywidualnych danych dostępowych Jira.
W jaki sposób są zabezpieczane tokeny żądań, tokeny dostępowe, klucze prywatne i inne tajemnice/dane dostępowe OAuth?
Podczas integracji używane są tylko tokeny dostępowe. Są one bezpiecznie przechowywane w bazie danych i używane wyłącznie po stronie serwera.
Dla OAuth 1.0. (Jira Server i Data Center) authToken jest używany tylko dla webhooka. Nie jest to faktyczny token autoryzacji używany przez OAuth. Żądania są wysyłane przez szyfrowane połączenie. Klucz tajny jest generowany automatycznie i powiązany zgodnie z zespołem.
Jakie punkty końcowe używa twoja integracja?
POST /rest/api/2/issue - utwórz nowe zgłoszenie
PUT /rest/api/2/issue/id - zaktualizuj zgłoszenie
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. Jesteśmy zatwierdzeni przez Atlassian i mamy już wielu klientów, którzy pomyślnie używają kart Jira z Datacenter. Procedura instalacji jest taka sama.
Jakie adresy IP są wykorzystywane do komunikacji z systemem Jira?
Listę naszych statycznych adresów IP można znaleźć tutaj.
Zwróć uwagę, że są to adresy używane wyłącznie do komunikacji z systemem Jira. Adresy IP aplikacji Miro są dynamiczne, a aby zapewnić, że wszystkie funkcjonalności na tablicach Miro (w tym niektóre powiązane z kartami Jira) działają poprawnie, prosimy o dodanie naszych domen do listy dozwolonych.
Czy możemy zintegrować Jira z Miro, ale blokować zgłoszenia Jira z Poziomem Bezpieczeństwa ustawionym na "Prywatne"?
Nie, to nie jest opcja. Poziomy Bezpieczeństwa w Jira nie mają korelacji z Miro.
Czy możemy połączyć Miro z Jira, jeśli używamy serwera Jira?
Ponieważ Miro jest narzędziem online, możesz połączyć się z Jira tylko wtedy, gdy Twoja instancja jest dostępna w publicznym internecie.
Czy możemy połączyć jednocześnie wiele instancji Jira?
Tak. Jednak należy pamiętać, że połączenie instancji Jira polega na ustanowieniu początkowego łącza, podczas gdy aktywne połączenie odnosi się do instancji, która jest obecnie w użyciu. Aktywne połączenie określa miejsce, z którego importowane są karty Jira, kiedy otwierasz aplikację kart Jira, oraz dla której instancji użytkownicy są autoryzowani. Dla danego użytkownika może być tylko jedno (1) aktywne połączenie w danym czasie. Dzięki OAuth 2.0, użytkownik może edytować każdą kartę Jira związaną z dowolną podłączoną instancją, do której już ma dostęp. W przypadku innego protokołu autoryzacji, cały zespół dzieli się aktywną instancją i może jedynie importować i wchodzić w interakcje z kartami z tej instancji. Możesz zdefiniować wiele ustawień na poziomie organizacji i przełączać się między aktywnymi połączeniami na poziomie zespołu.
Jaki jest proces migracji z serwera na chmurę?
Ponieważ Twój podstawowy URL Jira nieuchronnie zmieni się podczas migracji do Cloud, integracja zostanie przerwana bez wprowadzenia zmian po naszej stronie. Prosimy o skontaktowanie się z pomocą techniczną Miro w celu uzyskania pomocy.
Czy Miro utworzy webhook dla każdego zespołu, projektu lub instancji Miro?
Jeśli w ustawieniach Miro włączysz automatyczne tworzenie webhooków, to utworzenie webhooka następuje automatycznie. Jeśli używasz autoryzacji na poziomie zespołu z Jira, Miro tworzy webhooki dla każdego zespołu. Jeśli używasz autoryzacji na poziomie organizacji, Miro tworzy webhooki dla każdej organizacji.
Czy wtyczka karty Jira obsługuje projekty Next-Gen?
Tak, obsługuje.
Zwróć uwagę, że obecnie brak jest łącza/hiperlinii Epika przy tworzeniu karty Jira dla projektu Next-Gen po stronie Miro.
Czy niestandardowe pola Jira są obsługiwane?
Tak, obsługujemy prawie wszystkie pola niestandardowe podstawowych typów. Jeśli masz pole ze złożonym typem danych, może nie być obsługiwane, co może powodować nieoczekiwane zachowanie podczas aktualizacji lub tworzenia kart Jira na tablicy.
Co się stanie z istniejącymi kartami Jira, jeśli przejdziemy na inne środowisko Jira?
Obecnie, gdy przenosisz zgłoszenia Jira z jednego projektu do innego w Jira, przestają się one aktualizować po stronie Miro.
Jako obejście sugerujemy skopiowanie adresu URL zgłoszenia Jira (Ctrl/Cmd+C) i wklejenie go na tablicę Miro (Ctrl/Cmd+V). W ten sposób karta Jira pokaże nowe wartości i będzie aktualizowana automatycznie.
Jeśli tablica zostanie przeniesiona do innego zespołu Miro, co stanie się z kartami Jira na 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 zespołu docelowego).
Po kliknięciu na kartę, 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 kart Jira wiąże się z dodatkowymi kosztami?
Karty Jira są dostępne we wszystkich płatnych i edukacyjnych planach bez dodatkowych opłat (abonament Starter, Business, Education i Enterprise).
Czy użytkownik ma dostęp do wszystkich kart Jira na tablicy?
Uprawnienia do integracji kart Jira zapewniają, że użytkownicy mogą tworzyć i edytować karty tylko w projektach Jira, do których mają dostęp.
Ponieważ wszystkie widżety na tablicy Miro są widoczne dla każdego, kto ma dostęp do tablicy, jeśli ktoś nie posiada danych dostępowych do Jira, albo nie ma właściwych danych, będzie w stanie zobaczyć zwinietą kartę Jira na tablicy Miro (z tytułem i innymi polami), ale nie może rozwinąć karty, aby ją w pełni przejrzeć lub zmodyfikować.
Czy Atlassian zakończył pomoc techniczną dla Jira Server?
Tak, Atlassian zakończył pomoc techniczną dla Jira Server w lutym 2024 roku.
Czy Miro Planner/Jira Cards obsługują niestandardowe pola Jira: niestandardowe typy zgłoszeń i niestandardowe zależności?
Tak, oba są obsługiwane. Jeśli pola niestandardowe typy zgłoszeń i niestandardowe zależności są skonfigurowane w Jira a Miro Planner jest uwierzytelniony dla tej instancji Jira, wówczas te niestandardowe pola są dostępne w planerze.
Czy Miro obsługuje OAuth 2.0 dla Jira Data Center?
Tak. Zobacz Jak połączyć się z Jira Data Center używając OAuth 2.0.
Jak mogę zaimportować zgłoszenia Jira do tabel i osi czasu?
Możesz przeciągnąć i upuścić jedną lub kilka kart Jira bezpośrednio do tabeli lub na oś czasu. Jest to obecnie jedyny sposób, aby to zrobić.
Jakie pola w tabeli łączą się z Jira?
Systemowe pola Jira:
- Tytuł
- Opis
- Data zakończenia (Data wymagalności w Jira)
- Przypisana osoba
- Stan
Niestandardowe pola Jira:
- Data początkowa
- Estymata
Kliknij komórkę, aby zobaczyć, które pola synchronizują się z Jira. Wszystkie pola, które się synchronizują, są oznaczone logo Jira. Wszystkie inne pola są przechowywane tylko w Miro i nie synchronizują się z Jira.
Dlaczego nie mogę edytować pola w tabeli lub na osi czasu z obsługiwanych pięciu pól Jira powyżej?
Pole może nie być obecne na ekranie edycji w Jira.
Łatwy sposób sprawdzenia, czy pole jest obecne na ekranie edycji, czy nie:
W Miro otwórz panel boczny dla karty Jira. Sprawdź, czy pole jest obecne w panelu bocznym. Jeśli pole nie jest obecne, musisz dodać je do ekranu edycji w Jira.
W rzadkich przypadkach pola są edytowalne w Jira, ale nie są widoczne na ekranie edycji w Jira. W takim przypadku tych pól nie można edytować w Miro.
Czy pole, którego nie możesz edytować to Data rozpoczęcia lub Szacowanie? Jeśli tak:
Pole może być nieobecne w Jira lub brakować go na ekranie edycji (odnieś się do poprzedniego punktu).
Może wystąpić problem z mapowaniem dla pola Data rozpoczęcia lub Szacowanie, ponieważ są to pola niestandardowe w Jira.
Mapujemy te pola zgodnie z następującą logiką:
- Data rozpoczęcia: Sprawdzamy pola o nazwach: Start Date, StartDate, Target Start
- Szacowanie: Sprawdzamy pola o nazwach: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Jeśli pole Data rozpoczęcia lub Szacowanie nie jest nazwane zgodnie z powyższymi nazwami, to może wyjaśniać, dlaczego edytowanie nie działa.
Dlaczego edytowanie daty rozpoczęcia lub oszacowania w tabeli lub na osi czasu w Miro nie działa lub aktualizuje niewłaściwe pole w Jira?
Obecnie polegamy na automatycznym mapowaniu dla pól daty rozpoczęcia i oszacowania w Jira. Ponieważ są one niestandardowymi polami na Jira, mogą występować przypadki, gdzie wiele pól w Twojej konfiguracji Jira spełnia wspomniane powyżej kryteria.
Wybieramy pierwsze dopasowanie zgodnie z kolejnością nazw pól wymienionych powyżej:
Na przykład, jeśli bilet w Jira ma zarówno pola Story Points, jak i Story point estimate, dopasowujemy pierwsze zgodnie z listą powyżej, czyli Story Points. W związku z tym wszelkie zmiany w polu oszacowania w tabeli będą aktualizować pole Story Points w Jira, a nie Story point estimate.
Obecnie nie ma obejścia tego problemu. Jeśli doświadczasz tego problemu, prosimy o przesłanie feedbacku do swojego zespołu wsparcia, abyśmy mogli lepiej zrozumieć Twoje potrzeby podczas rozwijania bardziej zaawansowanych funkcji mapowania pól.
Dlaczego nie mogę importować kart Jira z 2 różnych instancji do tabeli lub osi czasu?
Obecnie obsługujemy tylko jedną instancję Jira na tabelę/oś czasu. Gdy karta Jira zostanie zaimportowana do tabeli/oś czasu, tabela/oś czasu zostaje powiązana z tą konkretną instancją Jira.
Nawet jeśli wszystkie rekordy Jira zostaną usunięte, link do pierwotnej instancji Jira pozostanie. Aby importować karty z innej instancji Jira, musisz utworzyć nową tabelę/oś czasu.
Dlaczego nie mogę zobaczyć lub edytować pól stanu i przypisanego dla moich rekordów Jira w tabeli lub osi czasu?
Obecnie pola stanu Jira i przypisanego nie są obsługiwane w tabelach i osi czasu. Zdecydowaliśmy się wyłączyć te pola w tabelach i osi czasu, aby zarządzać oczekiwaniami, unikać nieporozumień i potencjalnej utraty danych. Pola stanu i przypisanego oraz ich zawartość istnieją, ale nie pojawiają się w tabelach lub osi czasu.
Możesz nadal edytować te pola bezpośrednio w kartach Jira za pomocą panelu bocznego. Wystarczy przeciągnąć wiersz z tabeli lub osi czasu na planszę, aby karta Jira ponownie się pojawiła.
Więcej informacji: