Samouczek: integracja aplikacji Microsoft Entra SSO z usługą JIRA SAML SSO by Microsoft (V5.2)

  • Artykuł

Z tego samouczka dowiesz się, jak zintegrować aplikację JIRA SAML SSO by Microsoft (V5.2) z identyfikatorem Entra firmy Microsoft. Po zintegrowaniu programu JIRA SAML SSO by Microsoft (V5.2) z usługą Microsoft Entra ID można wykonywać następujące czynności:

  • Kontroluj w usłudze Microsoft Entra ID, kto ma dostęp do usługi JIRA SAML SSO by Microsoft (V5.2).
  • Zezwalaj swoim użytkownikom na automatyczne logowanie do usługi JIRA SAML SSO by Microsoft (V5.2) przy użyciu kont Microsoft Entra.
  • Zarządzaj kontami w jednej centralnej lokalizacji.

opis

Użyj swojego konta Microsoft Entra z serwerem Atlassian JIRA, aby włączyć logowanie jednokrotne. Dzięki temu wszyscy użytkownicy organizacji mogą logować się do aplikacji JIRA przy użyciu poświadczeń firmy Microsoft Entra. Ta wtyczka używa protokołu SAML 2.0 na potrzeby federacji.

Wymagania wstępne

Aby skonfigurować integrację firmy Microsoft Entra z usługą JIRA SAML SSO by Microsoft (V5.2), potrzebne są następujące elementy:

  • Subskrypcja firmy Microsoft Entra.
  • Programy JIRA Core i Software 5.2 powinny być zainstalowane i skonfigurowane w wersji 64-bitowej systemu Windows.
  • Serwer JIRA jest włączony za pomocą protokołu HTTPS.
  • Zwróć uwagę na obsługiwane wersje wtyczki usługi JIRA podane w poniżej sekcji.
  • Serwer JIRA jest dostępny w Internecie, szczególnie do strony logowania firmy Microsoft Entra na potrzeby uwierzytelniania i powinien mieć możliwość odbierania tokenu z identyfikatora Entra firmy Microsoft.
  • Administracja poświadczenia są konfigurowane w usłudze JIRA.
  • Usługa WebSudo jest wyłączona w programie JIRA.
  • Użytkownik testowy utworzony w aplikacji serwera JIRA.

Uwaga

Podczas testowania kroków w tym samouczku nie zalecamy używania środowiska produkcyjnego usługi JIRA. Integrację należy najpierw przetestować w środowisku programistycznym lub przejściowym aplikacji, a dopiero później użyć środowiska produkcyjnego.

Aby przetestować czynności opisane w tym samouczku, należy postępować zgodnie z następującymi zaleceniami:

  • Nie używaj środowiska produkcyjnego, chyba że jest to konieczne.
  • Subskrypcja firmy Microsoft Entra. Jeśli nie masz subskrypcji, możesz uzyskać bezpłatne konto.

Obsługiwane wersje usługi JIRA

  • JIRA Core and Software: 5.2.
  • Usługa JIRA obsługuje także wersje od 6.0 do 7.12. Aby uzyskać więcej informacji, kliknij pozycję JIRA SAML SSO by Microsoft.

Uwaga

Pamiętaj, że nasza wtyczka JIRA działa również w systemie Ubuntu w wersji 16.04.

Opis scenariusza

W tym samouczku skonfigurujesz i przetestujesz logowanie jednokrotne firmy Microsoft Entra w środowisku testowym.

  • Aplikacja JIRA SAML SSO by Microsoft (V5.2) obsługuje logowanie jednokrotne inicjowane przez dostawcę usług.

Aby skonfigurować integrację usługi JIRA SAML SSO by Microsoft (V5.2) z usługą Microsoft Entra ID, należy dodać aplikację JIRA SAML SSO by Microsoft (V5.2) z galerii do listy zarządzanych aplikacji SaaS.

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji w chmurze.
  2. Przejdź do sekcji Identity Applications Enterprise applications>New application (Aplikacje dla przedsiębiorstw w aplikacji> dla>przedsiębiorstw).
  3. W sekcji Dodawanie z galerii wpisz JIRA SAML SSO by Microsoft (V5.2) w polu wyszukiwania.
  4. Wybierz pozycję JIRA SAML SSO by Microsoft (V5.2) z panelu wyników, a następnie dodaj aplikację. Zaczekaj kilka sekund na dodanie aplikacji do dzierżawy.

Alternatywnie można również użyć Kreatora konfiguracji aplikacji dla przedsiębiorstw. W tym kreatorze możesz dodać aplikację do dzierżawy, dodać użytkowników/grupy do aplikacji, przypisać role, a także przejść przez konfigurację logowania jednokrotnego. Dowiedz się więcej o kreatorach platformy Microsoft 365.

Konfigurowanie i testowanie logowania jednokrotnego Microsoft Entra dla usługi JIRA SAML SSO by Microsoft (V5.2)

W tej sekcji skonfigurujesz i przetestujesz logowanie jednokrotne firmy Microsoft Entra z aplikacją JIRA SAML SSO by Microsoft (V5.2), korzystając z danych użytkownika testowego Britta Simon. Aby logowanie jednokrotne działało, należy ustanowić połączoną relację między użytkownikiem firmy Microsoft Entra i powiązanym użytkownikiem aplikacji JIRA SAML SSO by Microsoft (V5.2).

Aby skonfigurować i przetestować logowanie jednokrotne firmy Microsoft Entra z aplikacją JIRA SAML SSO by Microsoft (V5.2), wykonaj następujące kroki:

  1. Skonfiguruj logowanie jednokrotne firmy Microsoft Entra — aby umożliwić użytkownikom korzystanie z tej funkcji.
    1. Tworzenie użytkownika testowego aplikacji Microsoft Entra — aby przetestować logowanie jednokrotne firmy Microsoft Entra z użytkownikiem Britta Simon.
    2. Przypisz użytkownika testowego aplikacji Microsoft Entra — aby umożliwić użytkownikowi Britta Simon korzystanie z logowania jednokrotnego firmy Microsoft Entra.
  2. Skonfiguruj logowanie jednokrotne JIRA SAML firmy Microsoft (V5.2) — aby skonfigurować ustawienia logowania jednokrotnego po stronie aplikacji.
    1. Tworzenie użytkownika testowego aplikacji JIRA SAML SSO by Microsoft (V5.2) — aby mieć w aplikacji JIRA SAML SSO by Microsoft (V5.2) odpowiednik użytkownika Britta Simon połączony z reprezentacją użytkownika w usłudze Microsoft Entra.
  3. Testowanie logowania jednokrotnego — aby sprawdzić, czy konfiguracja działa.

Konfigurowanie logowania jednokrotnego firmy Microsoft

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji w chmurze.

  2. Przejdź do strony integracji aplikacji>dla>>przedsiębiorstw JIRA SAML SSO by Microsoft (V5.2), znajdź sekcję Zarządzanie i wybierz pozycję Logowanie jednokrotne.

  3. Na stronie Wybieranie metody logowania jednokrotnego wybierz pozycję SAML.

  4. Na stronie Konfigurowanie logowania jednokrotnego przy użyciu protokołu SAML kliknij ikonę ołówka podstawową konfigurację protokołu SAML, aby edytować ustawienia.

    Screenshot shows how to edit Basic SAML Configuration.

  5. W sekcji Podstawowa konfiguracja protokołu SAML wykonaj następujące czynności:

    a. W polu Identyfikator wpisz adres URL, korzystając z następującego wzorca: https://<domain:port>/

    b. W polu tekstowym Adres URL odpowiedzi wpisz adres URL, korzystając z następującego wzorca: https://<domain:port>/plugins/servlet/saml/auth

    c. W polu tekstowym Adres URL logowania wpisz adres URL, korzystając z następującego wzorca: https://<domain:port>/plugins/servlet/saml/auth

    Uwaga

    Te wartości nie są prawdziwe. Zaktualizuj te wartości przy użyciu rzeczywistego identyfikatora, adresu URL odpowiedzi i adresu URL logowania. Port jest opcjonalny, jeśli adres URL zawiera nazwę. Te wartości można uzyskać podczas konfigurowania wtyczki usługi Jira, co jest objaśnione w dalszej części tego samouczka.

  6. Na stronie Konfigurowanie logowania jednokrotnego za pomocą protokołu SAML w sekcji Certyfikat podpisywania SAML kliknij przycisk kopiowania, aby skopiować adres URL metadanych federacji aplikacji i zapisać go na komputerze.

    Screenshot shows the Certificate download link.

Tworzenie użytkownika testowego aplikacji Microsoft Entra

W tej sekcji utworzysz użytkownika testowego o nazwie B.Simon.

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako użytkownik Administracja istrator.
  2. Przejdź do pozycji Użytkownicy tożsamości>>Wszyscy użytkownicy.
  3. Wybierz pozycję Nowy użytkownik Utwórz nowego użytkownika> w górnej części ekranu.
  4. We właściwościach użytkownika wykonaj następujące kroki:
    1. W polu Nazwa wyświetlana wprowadź wartość B.Simon.
    2. W polu Główna nazwa użytkownika wprowadź username@companydomain.extensionwartość . Na przykład B.Simon@contoso.com.
    3. Zaznacz pole wyboru Pokaż hasło i zanotuj wartość wyświetlaną w polu Hasło.
    4. Wybierz pozycję Przejrzyj i utwórz.
  5. Wybierz pozycję Utwórz.

Przypisywanie użytkownika testowego aplikacji Microsoft Entra

W tej sekcji włączysz użytkownikowi B.Simon możliwość korzystania z logowania jednokrotnego, udzielając dostępu do usługi JIRA SAML SSO by Microsoft (V5.2).

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji w chmurze.
  2. Przejdź do sekcji Identity>Applications Enterprise Applications>>JIRA SAML SSO by Microsoft (V5.2).
  3. Na stronie przeglądu aplikacji wybierz pozycję Użytkownicy i grupy.
  4. Wybierz pozycję Dodaj użytkownika/grupę, a następnie wybierz pozycję Użytkownicy i grupy w oknie dialogowym Dodawanie przypisania .
    1. W oknie dialogowym Użytkownicy i grupy wybierz pozycję B.Simon z listy Użytkownicy, a następnie kliknij przycisk Wybierz w dolnej części ekranu.
    2. Jeśli oczekujesz, że rola zostanie przypisana do użytkowników, możesz wybrać ją z listy rozwijanej Wybierz rolę . Jeśli dla tej aplikacji nie skonfigurowano żadnej roli, zostanie wybrana rola "Dostęp domyślny".
    3. W oknie dialogowym Dodawanie przypisania kliknij przycisk Przypisz.

Konfigurowanie logowania jednokrotnego SAML PROGRAMU JIRA by Microsoft (V5.2) SSO

  1. W innym oknie przeglądarki internetowej zaloguj się do wystąpienia usługi JIRA jako administrator.

  2. Zatrzymaj wskaźnik myszy nad ikoną koła zębatego i kliknij pozycję Dodatki.

    Screenshot shows Add-ons selected from the Settings menu.

  3. W sekcji karty Dodatki kliknij pozycję Zarządzaj dodatkami.

    Screenshot shows Manage add-ons selected in the Add-ons tab.

  4. Pobierz wtyczkę z Centrum pobierania Microsoft. Ręcznie przekaż wtyczkę udostępnioną przez firmę Microsoft za pomocą menu Przekazywanie dodatku. Pobieranie wtyczki jest objęte umową serwisową firmy Microsoft.

    Screenshot shows Manage add-ons with the Upload add-on link called out.

  5. Po zainstalowaniu wtyczki jest ona wyświetlana w sekcji dodatków Zainstalowane przez użytkownika. Kliknij pozycję Configure (Konfiguruj), aby skonfigurować nową wtyczkę.

    Screenshot shows the Microsoft Entra SAML Single Sign-on for Jira section with Configure selected.

  6. Wykonaj następujące kroki na stronie konfiguracji:

    Screenshot shows the Microsoft Jira S S O Connector configuration page.

    Napiwek

    Upewnij się, że tylko jeden certyfikat jest zamapowany do aplikacji, aby zapobiec błędom podczas rozpoznawania metadanych. Jeśli jest dostępnych wiele certyfikatów podczas rozpoznawania metadanych, administrator otrzyma błąd.

    a. W polu tekstowym Adres URL metadanych wklej skopiowaną wartość adresu URL metadanych federacji aplikacji, a następnie kliknij przycisk Rozwiąż . Spowoduje to odczytanie adresu URL metadanych dostawcy tożsamości i wypełnienie wszystkich pól danymi.

    b. Skopiuj wartości Identyfikator, Adres URL odpowiedzi i Adres URL logowania, a następnie wklej je w polach tekstowych Identyfikator, Adres URL odpowiedzi i Adres URL logowania odpowiednio w sekcji Podstawowa konfiguracja protokołu SAML.

    c. W polu Nazwa przycisku logowania wpisz nazwę przycisku, która według Twojej organizacji ma być wyświetlana użytkownikom na ekranie logowania.

    d. W polu Lokalizacje identyfikatora użytkownika SAML wybierz opcję Identyfikator użytkownika znajduje się w elemencie NameIdentifier instrukcji Subject lub Identyfikator użytkownika znajduje się w elemencie Attribute. Ten identyfikator musi być identyfikatorem użytkownika JIRA. Jeśli identyfikator użytkownika nie jest zgodny, system nie zezwoli użytkownikom na logowanie.

    Uwaga

    Domyślna lokalizacja identyfikatora użytkownika SAML to element NameIdentifier. Można ją zmienić za pomocą opcji elementu Attribute, podając nazwę odpowiedniego atrybutu.

    e. Jeśli wybierzesz opcję Identyfikator użytkownika jest w opcji Atrybut, w polu tekstowym Nazwa atrybutu wpisz nazwę atrybutu, w którym oczekiwano identyfikatora użytkownika.

    f. Jeśli używasz domeny federacyjnej (na przykład usługi ADFS itp.) z identyfikatorem Entra firmy Microsoft, kliknij opcję Włącz odnajdywanie obszaru głównego i skonfiguruj nazwę domeny.

    g. W polu Nazwa domeny wpisz nazwę domeny w przypadku logowania za pomocą usług ADFS.

    h. Sprawdź opcję Włącz wylogowanie jednokrotne, jeśli chcesz wylogować się z usługi Microsoft Entra ID, gdy użytkownik wyloguje się z usługi JIRA.

    i. Kliknij przycisk Zapisz, aby zapisać ustawienia.

    Uwaga

    Aby uzyskać więcej informacji na temat instalacji i rozwiązywania problemów, odwiedź stronę MS JIRA SSO Połączenie or Administracja Guide (Przewodnik dotyczący logowania jednokrotnego MS JIRA Administracja), a także często zadawane pytania dotyczące twojej pomocy.

Tworzenie użytkownika testowego programu JIRA SAML SSO by Microsoft (V5.2)

Aby umożliwić użytkownikom firmy Microsoft Entra logowanie się do lokalnego serwera JIRA, należy ich aprowizować na serwerze lokalnym JIRA.

Aby aprowizować konto użytkownika, wykonaj następujące kroki:

  1. Zaloguj się do lokalnego serwera JIRA jako administrator.

  2. Zatrzymaj wskaźnik myszy nad ikoną koła zębatego i kliknij pozycję User management (Zarządzanie użytkownikami).

    Screenshot shows User management selected from the Settings menu.

  3. Nastąpi przekierowanie do strony dostępu administratora. Podaj wartość w polu Password (Hasło) i kliknij przycisk Confirm (Potwierdź).

    Screenshot shows Administrator Access page where you enter your credentials.

  4. W sekcji karty User management (Zarządzanie użytkownikami) kliknij pozycję create user (utwórz użytkownika).

    Screenshot shows the User management tab where you can Create user.

  5. Na stronie okna dialogowego „Create new user” (Tworzenie nowego użytkownika) wykonaj następujące kroki:

    Screenshot shows the Create new user dialog box where you can enter the information in this step.

    a. W polu tekstowym Email address (Adres e-mail) wpisz adres e-mail użytkownika, na przykład Brittasimon@contoso.com.

    b. W polu tekstowym Full Name (Imię i nazwisko) wpisz imię i nazwisko użytkownika, np. Britta Simon.

    c. W polu tekstowym Username (Nazwa użytkownika) wpisz adres e-mail użytkownika, na przykład Brittasimon@contoso.com.

    d. W polu tekstowym Password (Hasło) wpisz hasło użytkownika.

    e. Kliknij pozycję Create user (Utwórz użytkownika).

Testowanie logowania jednokrotnego

W tej sekcji przetestujesz konfigurację logowania jednokrotnego firmy Microsoft z następującymi opcjami.

  • Kliknij pozycję Przetestuj tę aplikację. Spowoduje to przekierowanie do adresu URL logowania jiRA SAML SSO by Microsoft (V5.2), w którym można zainicjować przepływ logowania.

  • Przejdź bezpośrednio do adresu URL logowania jednokrotnego SAML SAML firmy Microsoft (V5.2) i zainicjuj przepływ logowania z tego miejsca.

  • Możesz użyć usługi Microsoft Moje aplikacje. Po kliknięciu kafelka JIRA SAML SSO by Microsoft (V5.2) w Moje aplikacje nastąpi przekierowanie do adresu URL logowania JIRA SAML SSO by Microsoft (V5.2). Aby uzyskać więcej informacji na temat Moje aplikacje, zobacz Wprowadzenie do Moje aplikacje.

Następne kroki

Po skonfigurowaniu usługi JIRA SAML SSO by Microsoft (V5.2) możesz wymusić kontrolę sesji, która chroni eksfiltrację i infiltrację poufnych danych organizacji w czasie rzeczywistym. Kontrola sesji rozszerza się od dostępu warunkowego. Dowiedz się, jak wymusić kontrolę sesji za pomocą Microsoft Defender dla Chmury Apps.