Możliwe problemy z kartami Jira i dodatkiem Jira

Aplikacja kart Jira jest zainstalowana, ale Twój zespół w Miro nie jest połączony z Jira.

Proszę postępować zgodnie z tym przewodnikiem instalacji: Jak skonfigurować i odinstalować karty Jira. Jeśli nie jesteś administratorem zespołu, poproś administratora o wykonanie tego. 

Żądanie do Jira... niepowiodło się: Nastąpił limit czasu / Nieznany host / Połączenie odrzucone

Jira jest dostępna tylko w Twojej sieci wewnętrznej (używasz niewłaściwych adresów IP do komunikacji z systemem Jira).

Upewnij się, że dodasz na listę dozwolonych nasze adresy IP, domeny i subdomeny, aby zapewnić naszej integracji odpowiedni poziom dostępu. 

Jeśli korzystasz z Jira Server i masz starszą wersję, dokładnie sprawdź, czy żadna z ukrytych funkcji nie blokuje dostępu dla Miro.

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Link aplikacji w Twojej Jira jest niepoprawnie skonfigurowany

- Pominąłeś(-aś) niektóre kroki w konfiguracji linku lub webhoku

- Zainstalowałeś(-aś) dodatek Jira zamiast skonfigurować link dla kart Jira.

Spróbuj zainstalować integrację z kartami Jira od nowa. 

Jeśli wybrałeś(-aś) utworzenie webhoku ręcznie, spróbuj utworzyć go automatycznie.

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Link do aplikacji w Twojej instancji Jira nie jest poprawnie skonfigurowany, lub token wygasł. Sprawdź link do aplikacji i ponownie połącz integrację.

- Łącze aplikacji w Jira zostało skonfigurowane na nowo

- Token wygasł

- Token został cofnięty

Upewnij się, że łącze aplikacji jest skonfigurowane poprawnie i spróbuj ponownie połączyć Miro z kartami Jira.

Jeśli używasz bardzo zabezpieczonej wersji Jira lub korzystasz z proxy, upewnij się, że dodasz nasze adresy IP, domeny i subdomeny do listy dozwolonych, aby zapewnić naszemu rozwiązaniu integracyjnemu odpowiedni poziom dostępu. 

Jeśli korzystasz z Jira Server i starszej wersji, upewnij się, że żadne ukryte funkcje nie blokują dostępu dla Miro.

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Link aplikacji prosi o więcej wartości niż tylko URL, Klucz Konsumenta, Nazwa Konsumenta, Klucz Publiczny.

Znajdujesz się na karcie Outgoing Authentication w menu konfiguracji.

- Przełącz na Incoming Authentication. Outgoing Authentication nie wymaga konfiguracji.

- Jeśli nie możesz pominąć tego kroku, dodaj jakiekolwiek tymczasowe wartości. Będziesz mógł je później usunąć: na stronie z listą Application links kliknij Edit w przypadku linku Miro Cards i usuń tymczasowe wartości. 

Dotyczy wyłącznie OAuth 1.0. (Jira Server i Data Center).

Adres URL Jira jest nieprawidłowy /
Wprowadź bazowy URL Jira /
Zła prośba. Deserializacja.

Twoja Jira znajduje się w sieci prywatnej / zapora sieciowa twojej firmy blokuje połączenia zewnętrzne.

Dodaj nasze adresy IP bramy NAT (i porty) do swojej listy dozwolonych. 
*Pamiętaj, że jeśli sprawdzisz nasze adresy IP za pomocą programu nslookup, wynikiem będą adresy naszego load balancera, które mogą się zmieniać w czasie.

Używasz proxy / Twoje zewnętrzne i wewnętrzne adresy URL Jira się nie zgadzają.

Upewnij się, że pole Jira URL jest wypełnione adresem, do którego mamy dostęp, więc skonfiguruj odwrotne proxy umożliwiające dostęp i/lub postępuj zgodnie z instrukcjami podanymi w tym przewodniku Atlassian. Dzięki temu rozwiązaniu integracja będzie mogła skutecznie łączyć się i przekazywać żądania pomiędzy Jira a Miro, jeśli Twoje zewnętrzne i wewnętrzne adresy URL są różne.
Możesz także chcieć wydłużyć czas oczekiwania na serwerze proxy.
Listę punktów końcowych można znaleźć tutaj: często zadawane pytania dotyczące kart Jira

Występuje problem z Twoim certyfikatem SSL (certyfikaty samopodpisane nie są obsługiwane).

Sprawdź aktywny certyfikat SSL na serwerze Jira. To narzędzie może być pomocne: wprowadź swój URL Jira i zobacz wyniki testu połączenia.
Przykład: certyfikat może być poprawny (Certyfikat na zielono), ale łańcuch certyfikatów serwera może być niekompletny (Wymiana kluczy na żółto), w związku z czym nasz system otrzymuje odpowiedź, że certyfikat wymaga aktualizacji.
Odniesienie się do tej strony może rozwiązać problemy.

Twoja Jira działa z SSO (może to również skutkować błędem Niepoprawnie skonfigurowane uwierzytelnianie przychodzące).

Upewnij się, że proces SSO nie ma zastosowania do żądań połączenia w naszej integracji. Aby to zrobić, poniższe punkty końcowe muszą zostać wyłączone z procesów SSO:

GET {JIRA_URL}/rest/api/2/serverInfo
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/request-token
(OAuth 1.0) POST {JIRA_URL}/plugins/servlet/oauth/access-token
(OAuth 2.0) POST {JIRA_URL}/plugins/servlet/oauth2/*

Nieoczekiwane zachowanie podczas instalacji

Używasz wersji Jira 6.4 lub niższej.

Nasze karty nie będą działać z tymi wersjami z powodu tego błędu w Jira. Zaktualizuj swoją Jira do najnowszej wersji.

Autoryzacja aplikacji nie powiodła się. Spróbuj jeszcze raz autoryzować aplikację. 

1. Chwilowa utrata połączenia. Kliknij Połącz ponownie.

2. Wygasły token został wysłany podczas procedury autoryzacji. Wyczyść zbuforowane dane, zacznij od nowego środowiska roboczego. Innymi słowy, zmotywuj Jira do wygenerowania nowego tokenu.

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Błąd Jira: "Nie masz uprawnień do utworzenia webhooka 'Miro'."

Nie masz uprawnień administratora w Jira. Proszę poproś swojego administratora Jira o podniesienie twojej roli do administratora, abyś mógł(a) skonfigurować integrację.

Nieudane żądanie do Jira: Błąd podczas budowania ścieżki PKIX: nie znaleziono ważnej ścieżki certyfikacji do żądanego celu

Wystąpił problem z certyfikatem serwera.
 
Jako rozwiązanie, sugerujemy skontaktować się z działem IT, aby sprawdzić certyfikaty po Waszej stronie (przeładować serwery internetowe; upewnić się, że certyfikaty są publicznie zaufane, itp.). 

Brak możliwości autoryzacji w Jira przez Miro.
Błąd: wyjątki 
(np.  io.netty.handler.timeout.ReadTimeoutException)

Może to wystąpić z powodu błędnej konfiguracji infrastruktury Jira, kiedy konfiguracja infrastruktury wskazuje na obsługę protokołu HTTP/2, ale nie odbywa się transfer danych podczas próby jego użycia. Sprawdź swoje ustawienia HTTP/2 w plikach konfiguracyjnych serwera, aby upewnić się, że są prawidłowo skonfigurowane.

Jeśli to konieczne, tymczasowo wyłącz obsługę HTTP/2 w konfiguracji serwera, aby zapewnić zgodność wsteczną i nieprzerwaną usługę do czasu rozwiązania problemu.

Karty Jira się nie aktualizują

Dotyczy wyłącznie OAuth 1.0 (Jira Server i Data Center).

Używasz ręcznego webhooka.

Proszę wyłączyć integrację i ponownie połączyć ją przy użyciu automatycznego webhooka. Jeśli automatyczny webhook działa prawidłowo, oznacza to, że ręczny został nieprawidłowo skonfigurowany.

Zajrzyj również do Jak skonfigurować webhook dla kart Jira. 

Dotyczy OAuth 1.0 i OAuth 2.0 (Jira Server & Data Center).

Jeśli używasz automatycznego webhooka, pierwszym krokiem do rozwiązania problemu jest ponowne połączenie integracji. Jeśli to nie pomoże, może być kilka powodów, dla których karty Jira przestały się aktualizować . Na przykład:

- tablica Miro została przeniesiona lub pobrana za pomocą kopii zapasowej do innego zespołu

- zgłoszenia Jira zostały przeniesione z jednego projektu do innego po stronie Jira

- nie masz dostępu do projektów, w których znajdują się zgłoszenia Jira

- (tylko Enterprise) twłaściciel tablicy jest dezaktywowany lub ma bezpłatną ograniczoną licencję

- (Tylko OAuth 1.0) karty Jira nie znajdują się w tej samej instancji Jira , której aktualnie używasz w przeglądarce

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Karty Jira przestały się aktualizować bez żadnych zmian z Twojej strony, a próba ponownego połączenia wskazuje, że link aplikacji w Twojej Jira nie jest skonfigurowany poprawnie.

Komunikat o błędzie może pojawić się, gdy Miro nie może nawiązać żądania do połączonego Jira z powodu błędu autoryzacji. Może się tak stać, jeśli użytkownik, który skonfigurował integrację cofa swój token lub jeśli Jira jest w jakiś sposób skonfigurowana z krótkim czasem życia wydanego tokenu, przez co po tym czasie token staje się nieważny i musi być ponownie połączony, aby uzyskać nowy, ważny token autoryzacyjny, dzięki któremu Miro ma dostęp do Jira.

Opcja Edycja karty zwraca puste okno

Dotyczy tylko OAuth 1.0. (tylko serwer Jira i Data Center).

Używasz wersji Jira 7.6 i nowszych.

Ze względów bezpieczeństwa firma Atlassian może nie zezwalać na osadzanie treści w iFrames, co może wpływać również na okna pop-up do edycji kart Jira. Możesz użyć tych instrukcji jako obejście problemu.

Nie można dodać kart Jira

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Stworzyłeś webhook ręcznie i nie zapisałeś informacji o konfiguracji.

Sprawdź, czy pole Jira URL jest uzupełnione w ustawieniach Miro. Pamiętaj, aby kliknąć Połącz

Ikona Edycji nie jest wyświetlana

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Używasz wersji serwera Jira 7.6 lub wyższej.

Ikona edycji może nie być wyświetlana z powodu aktualizacji zabezpieczeń w tej wersji.

Twój profil nie ma uprawnień do edycji danego zgłoszenia Jira.

Sprawdź, czy możesz uzyskać dostęp do trybu edycji po otwarciu zgłoszenia po stronie Jira.

Otrzymujesz wiadomość: Nie jesteś zalogowany i nie masz uprawnień wymaganych do działania na wybranym zgłoszeniu jako gość. Proszę się zalogować

Ze względu na sposób, w jaki nasza integracja wykorzystuje pliki cookie, Twoje Jira może nie pozwalać na zalogowanie się z tej strony.

Zaloguj się do Jira w innej karcie przeglądarki.
Upewnij się, że pliki cookie stron trzecich są dozwolone w Twojej przeglądarce.

Twoje Jira działa pod systemem SSO, a Twój dostawca tożsamości nie pozwala na uwierzytelnianie przez iframes.

Jeśli pracujesz w aplikacji komputerowej Miro, zalecamy przełączenie się do wersji przeglądarkowej Miro pod adresem miro.com.

Brak opcji konwersji/stworzenia karty Jira w Miro, gdy wybierasz pewne projekty:

- brak danych w polu typu zgłoszenia

- przycisk Konwertuj/Stwórz jest nieaktywny

Nie masz dostępu do Projektu w Jira. Sprawdź, czy można przyznać Ci dostęp.

Nie można utworzyć zgłoszenia Jira podczas próby konwersji/stworzenia nowej karty Jira: 

Nie masz uprawnień do tworzenia zgłoszeń Jira.

Skontaktuj się ze swoim administratorem Jira i poproś go o nadanie Ci odpowiednich uprawnień po stronie Jira. Tak to powinno wyglądać:

Niektóre niestandardowe pola nie są wyświetlane w menu Konwersja na zgłoszenie Jira/Edycja zgłoszenia Jira

Nie można utworzyć zgłoszenia Jira. Wymagane pola (...) nie są obsługiwane błąd podczas tworzenia zgłoszenia Jira w Miro

Pola nie są włączone w selektorze kart Jira na tablicy.

Użyj naszego wbudowanego selektora Jira, aby skonfigurować pola niestandardowe, postępując według kroków z tego przewodnika.

Jeśli Wybierz pola do wyświetlenia na kartach nie pokazuje niestandardowych pól z Twojej instancji Jira, możliwe jest, że niektóre z Ekranów skonfigurowanych dla projektów w instancji Jira ukrywają pola przed Miro.

Przejdź do Ustawienia projektu > Ekrany > Schemat domyślny ekranu i sprawdź, czy potrzebne pola są dozwolone.

Miro nie obsługuje pól o złożonym typie danych.

Miro obsługuje podstawowe pola niestandardowe, ale nie złożone. Skonfiguruj pola kart Jira i usuń te pola, które nie są obsługiwane.

Nie można wybrać Zgłaszającego podczas edycji/tworzenia karty Jira

Brak pola Zgłaszający w metadanych Utwórz Jira: pole jest niedostępne na ekranie Utwórz w Jira dla wybranego projektu.

Przejdź do Ustawienia projektu > Ekrany i sprawdź, czy pole Zgłaszający jest obecne na ekranie Utwórz.

Nie masz niezbędnych uprawnień do ustawienia reportera dla zgłoszeń w wybranym projekcie.

Poproś administratora Jira o sprawdzenie twojego poziomu dostępu i upewnienie się, że masz uprawnienia do ustawiania/zmiany pola Reporter w wybranym projekcie. W tym celu, musi się zalogować do Jira > przejść do Ustawienia > Zgłoszenia > Schematy uprawnień > i sprawdzić pole Modyfikacja reportera (przynajmniej dodaj dostęp aplikacji: Każdy zalogowany użytkownik, jeśli nie jest dodane na liście):

Pole zgłaszającego nie jest edytowalne z powodu ścieżki audytu i jest ustawione na osobę, która utworzyła zgłoszenie.

Oczekiwanym działaniem jest brak dostępności tego pola.

Niektóre pola są wyświetlane w trybie edycji karty, ale nie pokazują się na kartach Jira na tablicach

Miro nie otrzymuje aktualizacji z Jira.

• Zamień sieć na inną
• Ponownie połącz integrację

Dotyczy wyłącznie OAuth 1.0 (Jira Server i Data Center).

Jira jest niedostępna błąd w Ustawieniach aplikacji kart Jira

1. Poproś administratora zespołu o wyłączenie i ponowne podłączenie integracji.

2. Twoja Jira jest chroniona (zapora sieciowa, blokery zabezpieczeń itp.) i Miro nie może się z nią połączyć.

Jeśli jednocześnie karty Jira synchronizują się między Miro a Jira, oznacza to, że Twoja Jira może wysyłać nam webhooks. Dlatego możesz zobaczyć aktualizacje na swoich tablicach.

Jako rozwiązanie sugerujemy omówienie problemu z działem IT i poproszenie ich o upewnienie się, że Miro jest prawidłowo dozwolone. 

Jeśli używasz Jira Server i starszej wersji, upewnij się, że żadne ukryte funkcje nie blokują dostępu dla Miro.

Dotyczy tylko OAuth 1.0. (Jira Server & Data Center).

Problemy z webhookami Jira błąd w Ustawieniach aplikacji kart Jira

- Zmieniłeś lub usunąłeś webhook po stronie Jira
- Miro otrzymuje odpowiedź 'Bad request' z Twojej Jira

Gdy używasz Ctrl + V (dla Windows)/Cmd + V (dla Mac), aby wkleić link do zgłoszenia Jira na tablicy, nie jest on konwertowany na kartę Jira, lecz wklejany jako URL

Tablica wciąż się ładuje. Może się zdarzyć na większych tablicach lub tablicach z większymi obrazami lub dokumentami PDF. 

Proszę poczekać co najmniej 10 sekund po otwarciu tablicy, aż tablica w pełni się załaduje. Następnie spróbuj ponownie wkleić link.

Opis nie jest widoczny na kartach Jira na tablicy

Aby zobaczyć szczegóły karty, kliknij kartę i wybierz rozwiń, aby zobaczyć szczegóły karty w bocznym panelu na Twojej tablicy. 

"Pokazano 0 z 0 pasujących sprintów" podczas próby wyszukiwania dostępnych sprintów

1. Dzieje się tak, gdy nie masz aktywnych/przyszłych sprintów (wszystkie są zakończone/zamknięte). 

2. Twój filtr w Jira nie obejmuje żadnych projektów. Dodaj potrzebny projekt do JQL dla filtra tablicy - wówczas sprinty pojawią się zarówno w Jira, jak i w Miro.

Dotyczy tylko OAuth 1.0. (Jira Server i Data Center).

Nie powiodło się SSL połączenie z ...

Błąd oznacza, że Miro nie ma dostępu do Twojej Jiry.

Skontaktuj się z administratorami zespołu Miro i poproś ich o sprawdzenie, czy pole Jira Base URL w ustawieniach kart Jira zawiera adres, do którego możemy się połączyć.

Upewnij się, że masz uprawnienie „Przeglądanie użytkowników” ustawione na poziomie globalnym w Jira. Dowiedz się więcej o zarządzaniu globalnymi uprawnieniami.