Kto może to zrobić: administratorzy firmy
Jakie abonamenty: Enterprise
✏️ Podłączenie Jira za pomocą serwera autoryzacji jest włączone tylko na poziomie organizacji.
Artykuł przedstawia kroki podłączenia Miro do Jira za pomocą serwera autoryzacji innych firm działającego lokalnie, wykorzystując OAuth2.0.
Aby poznać szczegóły techniczne dotyczące tej konfiguracji, zobacz artykuł referencyjny dla Jira on-premise z autoryzacją firm trzecich przy użyciu OAuth 2.0.
Wymagania wstępne
- Upewnij się, że masz następujące uprawnienia:
- Administrator firmy Miro
- (Opcjonalnie) Admin systemu Jira, jeśli chcesz używać automatycznych webhooków.
- Na swoim serwerze autoryzacji utwórz aplikację OAuth 2.0.
- Skonfiguruj URL przekierowania w swojej aplikacji OAuth 2.0 na następujący URL:
https://integrations.miro.com/api/external-auth/oauth2/callback - Upewnij się, że masz gotowe następujące szczegóły z Twojej aplikacji OAuth 2.0 do skonfigurowania w Miro:
- URL autoryzacji
- URL tokena
- ID klienta
- Sekret klienta
- Zakres
Połącz z Jira on-premise za pomocą serwerów zewnętrznych, używając OAuth 2.0
- Na pulpicie Miro, wybierz swój awatar w prawym górnym rogu i przejdź do konsoli administratora | Ustawienia.
- Przejdź do Aplikacje i integracje
> Aplikacje > Karta zarządzania aplikacjami .
- Upewnij się, że Zezwalaj tylko na aplikacje z poniższej listy jest włączone.
- Pod kolumną Aplikacja wybierz Ustawienia dla kart Jira.
- Kliknij Dodaj nowe połączenie.
- W sekcji Jira setup kliknij Centrum danych Jira.
- Pod Metoda uwierzytelniania wybierz OAuth2.0 za pośrednictwem zewnętrznego serwera autoryzacji.
- W polu Jira URL wprowadź adres URL swojej instancji Jira.
✏️ Możesz dodać swój zewnętrzny główny adres URL Jira lub wewnętrzny adres URL Jira. Jeśli używasz wewnętrznego URL Jira, musisz określić zewnętrzny URL bramy API w kroku 10.
✏️ Ogólnie rzecz biorąc, użycie wewnętrznego adresu URL umożliwia dostosowanie funkcji nawigacji do źródła.
- (Opcjonalne) Aby ustawić to połączenie jako domyślne dla wszystkich zespołów w twojej organizacji, zaznacz Ustaw jako domyślne.
- (Opcjonalnie) Jeśli używasz bramy API do składania żądań do Jira, to dla Podstawowy URL Jira API Gateway, wpisz zewnętrzny URL swojej bramy API.
- Wprowadź następujące szczegóły z aplikacji OAuth 2.0:
- URL autoryzacji
- URL tokena
- Identyfikator klienta
- Klucz tajny klienta
- Zakres
- (Opcjonalnie) Aby otrzymywać aktualizacje w czasie rzeczywistym z Jira w Miro, zaznacz Utwórz webhook automatycznie.
✏️ Możesz ręcznie dodać webhook później.
- Kliknij Połącz.
- Postępuj zgodnie z procesem uwierzytelniania dla swojego serwera autoryzacji. Jeśli zostaniesz poproszony, zaloguj się do swojego środowiska.
Po zakończeniu połączenia Twoja instancja Jira zostanie wyświetlona pod Połączone instancje z następującą etykietą: Serwer autoryzacji.
Upewnij się, że Twój zespół może się uwierzytelnić
Teraz, gdy masz połączoną instancję Jira na poziomie organizacji, możesz zacząć używać Jira na poziomie zespołu.
- Na pulpicie Miro wybierz swój awatar w prawym górnym rogu i przejdź do Konsoli Administratora.
- Wybierz Zespoły > Twój zespół.
Suwak Twój zespół otwiera się. - Wybierz kartę Aplikacje.
- Z listy aplikacji wybierz karty Jira.
- W ustawieniach administratora sprawdź, czy Twoja konfiguracja Jira pokazuje etykietę GLOBAL CONNECTION i czy widoczny jest poprawny adres URL instancji Jira, a następnie wykonaj jedną z poniższych czynności:
- Jeśli tak, ukończyłeś tę procedurę. Możesz przejść do Co dalej?
- Jeśli nie, wybierz Zmień konfigurację > Globalne ustawienia organizacji > Twoją instancję Jira.
- Wybierz Zapisz ustawienia.
Co dalej?
Każdy członek zespołu musi autoryzować swoje konto użytkownika. Aby zapewnić, że każdy użytkownik uzyska tokeny dostępu i odświeżenia, gdy członek zespołu podejmie próbę działania związanego z Jira na tablicy Miro, zostanie poproszony o autoryzację swojego konta.
FAQ
Jeśli wszystkie z poniższych elementów są prawdziwe, OAuth 2.0 za pośrednictwem serwera autoryzacji stron trzecich jest dobrym rozwiązaniem:
- Twoja instancja Jira jest hostowana lokalnie.
- Dostęp zewnętrzny do Jira jest możliwy tylko za pomocą API Gateway.
- Bramka API egzekwuje autoryzację przy użyciu niestandardowego serwera autoryzacji.
- Musisz połączyć Miro z Jira, nie ujawniając publicznego adresu bazowego Jira.