Dostępne dla: Jira Cloud, Jira Server (On-Premise) i Datacenter (również chronione przy pomocy LDAP)
Konfigurują: Administrator zespołu Miro i administrator systemu Jira z uprawnieniami administracyjnymi do projektów
Metoda uwierzytelniania OAuth1.0 nie będzie już obsługiwana w Miro od 1 lipca 2025 roku. Protokół uwierzytelniania OAuth1.0 jest wycofany w Jira i nie powinien być używany. Zmiana ta jest częścią szerszego przejścia na OAuth2.0, co jest zalecane zgodnie z najlepszymi praktykami bezpieczeństwa. Użytkownikom zaleca się przejście na OAuth2.0, aby zapewnić ciągłe wsparcie i kompatybilność z usługami Miro.
Konfigurowanie Miro na Jira
⚠️ W razie pojawienia się problemów technicznych zapoznaj się z naszym artykułem o możliwych problemach i sposobach ich rozwiązania.
💡 Dowiedz się więcej o kartach Jira w artykułach FAQ dotyczące kart Jira oraz Jak skonfigurować webhook dla kart Jira.
✏️ Pamiętaj, że menu Jira mogą się różnić w zależności od wersji Jira, której używasz, jednak ogólny przebieg powinien pozostać taki sam. Instrukcje poniżej można również znaleźć w pomocy technicznej Atlassian.
Krok 1 – Link do aplikacji
Najpierw utwórz link do aplikacji i skonfiguruj go.
- Przejdź do Ustawienia Jira > Produkty > Integracje > Linki do aplikacji > Utwórz link:
Pamiętaj, że interfejs Jira może się różnić w zależności od wersji Jira.
- Wybierz Link bezpośredni do aplikacji i wprowadź https://miro.com/ w polu URL aplikacji.
Ważne: musisz podać URL w dokładnie takim formacie. Kliknij Kontynuuj.
Tworzenie linku
- W następnym menu po prostu kliknij ponownie Kontynuuj.
- W menu Link do recenzji dwukrotnie sprawdź, czy URL nadal jest dokładnie https://miro.com/ i wprowadź nazwę aplikacji wg własnego wyboru. Przewiń w dół, a na dole zaznacz pole Utwórz przychodzący link. Pomiń resztę pól i kliknij Kontynuuj.
Tylko pole nazwy aplikacji musi być wypełnione.
- Zobaczysz tutaj pola dla wartości Miro. Aby uzyskać wartości, zaloguj się do Miro.
- Aby korzystać z integracji na poziomie zespołu, przejdź do ustawień zespołu > Aplikacje i integracje > Karty Jira.
- Dla integracji na poziomie organizacji, przejdź do Ustawień firmy > Aplikacje > Zarządzaj aplikacjami > Karty Jira > Ustawienia.
Jeśli nie masz karty Jira na liście aplikacji, przewiń do góry sekcji, kliknij Zainstaluj aplikacje i przejdź do zainstalowania aplikacji z Miro Marketplace. Po zobaczeniu kart Jira na liście, kliknij, aby ją otworzyć.
Karta wtyczki otworzy się, a Ty zobaczysz Krok 1, aby uzyskać wymagane wartości:Wartości kart Jira
Skopiuj wartości i dodaj je do menu Link do Recenzji Atlassian.
- Zobaczysz komunikat przetwarzania na chwilę lub dwie:
Ostatni krok tworzenia linku
To kończy kroki po stronie Atlassian. Link pojawi się na liście Twoich linków aplikacji.
Krok 2 – Połączenie
Wróć do swoich ustawień karty Jira w Miro i wybierz jedną z dwóch opcji: utwórz webhook ręcznie lub automatycznie. Jeśli wybierzesz ręcznie, odznacz tę opcję. Więcej informacji znajdziesz w tym artykule. Zdecydowanie zalecamy korzystanie z automatycznego webhooka, aby nie musieć go resetować w przypadku dużych aktualizacji wtyczki.
Na koniec wprowadź swój URL Jira i kliknij Połącz:
Połączenie kart Jira
Aby uzyskać adres URL Jira, proszę skopiować podstawowy adres URL Twojej instancji Jira. Akceptujemy następujące formaty:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://adres IP:port/
Jeśli Twój URL Jira nie jest akceptowany, zapoznaj się z tym artykułem. Proszę również sprawdzić, czy Miro ma wystarczający dostęp do Jira, aby nawiązać połączenie.
Teraz połączyłeś swoją instancję Jira z zespołem Miro.
⚠️ Mimo że Atlassian zakończył wsparcie dla Jira Server z dniem luty 2024 roku, Miro będzie nadal wspierać integrację kart Jira dla Jira Server w przewidywalnej przyszłości.
- Przejdź do https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Jeśli „Linki aplikacji” nie są zaznaczone, kliknij je.
Linki aplikacji Jira Server
- Kliknij Utwórz link. Wybierz "produkt Atlassian" i podaj URL aplikacji, "https://miro.com". Kliknij Kontynuuj.
Konfigurowanie URL aplikacji
- Zostaniesz przeniesiony do okna dialogowego "Połącz aplikacje". Dodaj nazwę aplikacji (np. Miro Jira Card) i wybierz "Generyczna aplikacja" jako typ aplikacji.
Powinieneś zobaczyć adres URL swojej aplikacji Jira pod „Tworzysz link z:”, a https://miro.com pod „Do tej aplikacji:”. Kliknij Kontynuuj.Konfigurowanie szczegółów aplikacji Link
- Konfiguracja linku zostanie przetworzona. Kiedy się to zakończy, zobaczysz nowy link w obszarze „Linki aplikacji” na serwerze Jira.
Twoja skonfigurowana aplikacja w Jira Server
- Następnie musisz skonfigurować szczegóły swojej aplikacji. Kliknij ikonę ołówka obok swojej aplikacji, aby edytować szczegóły aplikacji.
- W oknie dialogowym Konfigurowanie kliknij opcję Uwierzytelnianie przychodzące. Wypełnij klucz klienta, nazwę klienta, klucz publiczny i opcjonalnie opis.
- Dla integracji na poziomie zespołu informacje te są dostępne w ustawieniach zespołu > Aplikacje i integracje > Karty Jira.
- W przypadku integracji na poziomie organizacji te informacje są dostępne w Ustawienia firmy > Aplikacje > Zarządzaj aplikacjami > Karty Jira > Ustawienia.
Konfigurowanie szczegółów uwierzytelniania przychodzącego w Jira Server
Szczegóły połączenia aplikacji Jira w Miro
- Przewiń do końca opcji uwierzytelniania przychodzącego i kliknij Zapisz.</span> Twój status weryfikacji powinien być teraz potwierdzony, a ten serwer Jira można teraz używać w Miro do pracy z kartami Jira. Upewnij się, że wybierasz "Jira Server" i "OAuth 1.0" po stronie Miro.
Autoryzacja użytkownika
Po podłączeniu integracji każdy z Twoich użytkowników końcowych musi połączyć swój osobisty profil Jira, aby ustanowić odpowiednie uprawnienia – zapewnia to, że dostęp użytkownika po stronie Miro jest dokładnie taki sam, jak po stronie Twojej instancji Jira. Gdy użytkownicy końcowi próbują po raz pierwszy zaimportować lub edytować kartę Jira, zostaną poproszeni o zalogowanie się do Jira za pomocą indywidualnych danych dostępowych.
Po zakończeniu użytkownicy mogą dodawać zadania jako karty na tablicę. Wszystkie zmiany wprowadzone w Jirze są odzwierciedlane na kartach Jira na tablicy.
✏️ Jeśli użytkownik nie ma danych dostępowych do Jira, ale ma dostęp do tablicy, na której dodano kartę, zobaczy tytuł karty, typ zgłoszenia, priorytet, osobę przypisaną oraz wszystkie atrybuty skonfigurowane do wyświetlania na karcie Jira. Jednak nie będą mogli rozwinąć karty, aby zobaczyć inne atrybuty i edytować ją, dopóki nie uzyskają autoryzacji. Jeśli użytkownik nie połączy swoich danych dostępowych do Jira, nie zobaczy awatara przypisanej osoby, a ogólny wygląd karty będzie inny.
Korzystanie z jednej instancji Jira dla kilku zespołów Miro
Możesz zainstalować karty na poziomie zespołu lub organizacji. Jeśli masz wiele zespołów, możesz wykorzystać ustawienia na poziomie organizacji, aby uniknąć powtarzania procedury konfiguracji dla każdego zespołu. Istniejące łącze aplikacji jest używane we wszystkich zespołach.
Po połączeniu zespołu lub organizacji z instancją Jira, w Jira WebHooks dla tego zespołu lub organizacji Miro zostanie utworzony nowy webhook. Tworzenie webhooka ustanawia kanał dla próśb o aktualizacje.
Jeśli określisz ustawienia na poziomie organizacji, zespoły, które są już połączone, zachowają swoje bieżące ustawienia. Jednak w każdej chwili mogą przełączyć się na ustawienia na poziomie organizacji.
Dodatkowo, w razie potrzeby zespoły mogą nadpisać ustawienia na poziomie organizacji, aby połączyć się z inną instancją Jira.
Jeśli jesteś klientem Enterprise i chcesz przenieść wiele połączeń na poziomie zespołu do domyślnego połączenia na poziomie organizacji, skontaktuj się ze swoim zespołem ds. konta.
⚠️ Jeśli chcesz połączyć kilka zespołów osobno, zalecamy nadanie webhookowi dla każdego zespołu unikalnej nazwy. Przejdź do swojej strony webhooków Jira i edytuj każdy nowo utworzony webhook.
Łączenie kilku instancji Jira z jednym zespołem Miro nie jest obsługiwane.
Wyłączanie wtyczki
Aby zintegrować się na poziomie zespołu, przejdź do ustawień zespołu > aplikacji i integracji > karty Jira. Następnie wybierz Usuń z zespołu.
Aby ograniczyć użycie aplikacji Jira na poziomie organizacji, przejdź do Ustawienia firmy > Aplikacje > Zarządzanie aplikacjami > Karty Jira. Następnie przesuń przełącznik do pozycji wyłączonej.
⚠️ Jeśli wyłączysz Jirę dla organizacji, użytkownicy wszystkich zespołów Enterprise nie będą mogli korzystać z kart Jira. Aby dowiedzieć się więcej o zarządzaniu aplikacjami i ich ograniczaniu, zobacz Zarządzanie aplikacjami.
Więcej informacji: Zobacz Jak korzystać z kart Jira.