Kto może to zrobić: administratorzy firmy
Dostępne plany: Enterprise
Ten artykuł zawiera szczegóły techniczne dotyczące użycia zewnętrznego serwera autoryzacji z OAuth 2.0 do integracji Jira z Miro.
Aby dowiedzieć się, jak skonfigurować połączenie, zobacz Połączenie z Jira on-premise z wykorzystaniem zewnętrznych serwerów autoryzacji (OAuth 2.0).
Jak działa integracja Jira z Miro przy użyciu autoryzacji on-premise i OAuth 2.0
Poniższy schemat przedstawia przepływ komunikacji między Miro a lokalnym serwerem autoryzacji Jira.
Integracja Miro z Jira przy użyciu lokalnego serwera autoryzacji za pośrednictwem bramy API
Parametry konfiguracji
Aby skonfigurować przepływ autoryzacji między Miro a Jira z użyciem zewnętrznego serwera autoryzacji obsługującego OAuth 2.0, musisz określić następujące parametry:
-
Serwer autoryzacji
- URL żądania autoryzacji
- URL żądania tokenu
- Zakres
-
Konfiguracja aplikacji autoryzacyjnej
- ID klienta
- Sekret klienta
-
Instancja Jira
- Publiczny adres URL Jira
- Podstawowy adres URL Jira; adres URL wewnętrzny
✏️ Miro udostępnia adres URL przekierowania, który serwer autoryzacji weryfikuje względem zarejestrowanej aplikacji.
Więcej informacji: Zobacz Połączenie z Jira on-premise za pomocą zewnętrznych serwerów autoryzacji (OAuth 2.0).
Żądania autoryzacji użytkownika między Miro a lokalnym serwerem autoryzacji
W przypadku integracji Miro z Jira przy użyciu zewnętrznego serwera autoryzacji poniższy schemat przedstawia przepływ żądania autoryzacji użytkownika.
Żądanie autoryzacji użytkownika
Żądanie autoryzacji
https://{authorization_URL}?
response_type=code&
client_id={CLIENT_ID}&
redirect_uri={Miro Redirect URI}&
scope={scope}&
state={state}Użytkownik może dodać parametry do żądania autoryzacji jako pary klucz-wartość w konfiguracji.
Żądanie tokenu
curl --request POST \
--url '{token request URL}' \
--header 'content-type: application/x-www-form-urlencoded' \
--data grant_type=authorization_code \
--data 'client_id={CLIENT_ID}' \
--data 'client_secret={CLIENT_SECRET}' \
--data 'code={Obtained Authorization Code}' \
--data 'redirect_uri={Miro Redirect URI}' \Po otrzymaniu kodu autoryzacyjnego Miro przekazuje stan i żąda pary tokenów.
Wymiana tokenów odświeżania
curl --request POST \
--url '{token request URL}' \
--header 'content-type: application/x-www-form-urlencoded' \
--data grant_type=refresh_token \
--data 'client_id={CLIENT_ID}' \
--data 'refresh_token={current valid refresh token}' \Upewnij się, że operacja odświeżania tokenów jest włączona; włącz dostęp offline do API.
Żądania API Jira
curl --request GET \
--url {Jira Public URL}/rest/api/{apiversion}/... \
--header 'authorization: Bearer {accessToken}' \
--header 'content-type: application/json'Każde żądanie używa podanego publicznego adresu URL Jira jako adresu bazowego oraz tokenu dostępu użytkownika jako tokenu typu Bearer.