Samouczek: konfigurowanie usługi Atlassian Cloud na potrzeby automatycznej aprowizacji użytkowników
W tym samouczku opisano kroki, które należy wykonać zarówno w usłudze Atlassian Cloud, jak i w usłudze Microsoft Entra ID w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu identyfikator Entra firmy Microsoft automatycznie aprowizuje i anuluje aprowizowanie użytkowników i grup w usłudze Atlassian Cloud przy użyciu usługi aprowizacji firmy Microsoft. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi, sposobu jej działania i często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i anulowania aprowizacji aplikacji SaaS przy użyciu identyfikatora Entra firmy Microsoft.
Obsługiwane funkcje
- Tworzenie użytkowników w usłudze Atlassian Cloud
- Usuwanie użytkowników w usłudze Atlassian Cloud, gdy nie wymagają już dostępu
- Zachowywanie synchronizacji atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i usługą Atlassian Cloud
- Aprowizuj grupy i członkostwa w grupach w usłudze Atlassian Cloud
- Logowanie jednokrotne do usługi Atlassian Cloud (zalecane)
Wymagania wstępne
W scenariuszu opisanym w tym samouczku założono, że masz już następujące wymagania wstępne:
Dzierżawa firmy Microsoft Entra.
Konto użytkownika w usłudze Microsoft Entra ID z uprawnieniem do konfigurowania aprowizacji (na przykład application Administracja istrator, cloud application Administracja istrator lub właściciel aplikacji).
Upewnij się, że jesteś administratorem organizacji atlassian. Zobacz Administracja organizacji.
Sprawdź co najmniej jedną domenę w organizacji. Zobacz Weryfikacja domeny.
Zasubskrybuj dostęp Atlassian z organizacji. Zobacz Atlassian Access security policies and features (Zasady zabezpieczeń i funkcje usługi Atlassian Access).
Dzierżawa usługi Atlassian Cloud z subskrypcją usługi Atlassian Access.
Upewnij się, że jesteś administratorem co najmniej jednej witryny Jira lub Confluence, do której chcesz udzielić synchronizowanym użytkownikom dostępu.
Uwaga
Ta integracja jest również dostępna do użycia w środowisku microsoft Entra US Government Cloud. Tę aplikację można znaleźć w galerii aplikacji microsoft Entra US Government Cloud Application Gallery i skonfigurować ją w taki sam sposób, jak w przypadku chmury publicznej.
Krok 1. Planowanie wdrożenia aprowizacji
- Dowiedz się więcej na temat sposobu działania usługi aprowizacji.
- Określ, kto znajdzie się w zakresie aprowizacji.
- Ustal, jakie dane mają być mapowanie między identyfikatorem Entra firmy Microsoft i usługą Atlassian Cloud.
Krok 2. Konfigurowanie usługi Atlassian Cloud w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft
Przejdź do konsoli usługi Atlassian Administracja. Wybierz organizację, jeśli masz więcej niż jedną.
Wybierz pozycję Dostawcy tożsamości zabezpieczeń>.
Wybierz katalog dostawcy tożsamości.
Wybierz pozycję Skonfiguruj aprowizację użytkowników.
Skopiuj wartości podstawowego adresu URL i klucza interfejsu API SCIM. Będą one potrzebne podczas konfigurowania platformy Azure.
Zapisz konfigurację SCIM.
Uwaga
Upewnij się, że te wartości są przechowywane w bezpiecznym miejscu, ponieważ nie pokażemy ich ponownie.
Użytkownicy i grupy zostaną automatycznie aprowizowani w organizacji. Aby uzyskać więcej informacji na temat sposobu synchronizacji użytkowników i grup z organizacją, zobacz stronę aprowizacji użytkowników.
Krok 3. Dodawanie usługi Atlassian Cloud z galerii aplikacji Microsoft Entra
Dodaj usługę Atlassian Cloud z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w usłudze Atlassian Cloud. Jeśli wcześniej skonfigurowano usługę Atlassian Cloud dla logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecane jest jednak utworzenie osobnej aplikacji na potrzeby początkowych testów integracji. Więcej informacji o dodawaniu aplikacji z galerii znajdziesz tutaj.
Krok 4. Definiowanie, kto będzie w zakresie aprowizacji
Usługa aprowizacji firmy Microsoft umożliwia określanie zakresu, kto będzie aprowizować na podstawie przypisania do aplikacji lub na podstawie atrybutów użytkownika/grupy. Jeśli zdecydujesz się na określenie zakresu aprowizacji w aplikacji na podstawie przypisania, możesz skorzystać z następujących instrukcji w celu przypisania użytkowników i grup do aplikacji. Jeśli zdecydujesz się na określenie zakresu aprowizacji wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtra zakresu zgodnie z opisem zamieszczonym tutaj.
Zacznij od mniejszej skali. Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. W przypadku ustawienia zakresu aprowizacji na przypisanych użytkowników i grupy możesz w tym celu przypisać do aplikacji jednego czy dwóch użytkowników bądź jedną lub dwie grupy. W przypadku ustawienia zakresu na wszystkich użytkowników i wszystkie grupy, możesz określić filtrowanie zakresu na podstawie atrybutów.
Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji, aby dodać nowe role.
Krok 5. Konfigurowanie automatycznej aprowizacji użytkowników w usłudze Atlassian Cloud
Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w usłudze Atlassian Cloud na podstawie przypisań użytkowników i/lub grup w usłudze Microsoft Entra ID.
Aby skonfigurować automatyczną aprowizację użytkowników dla usługi Atlassian Cloud w usłudze Microsoft Entra ID:
Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji w chmurze.
Przejdź do sekcji Identity Applications Enterprise applications>>Atlassian Cloud ( Aplikacje dla>przedsiębiorstw Atlassian Cloud).
Na liście aplikacji wybierz pozycję Atlassian Cloud.
Wybierz kartę Aprowizacja.
Ustaw Tryb aprowizacji na Automatyczny.
W sekcji Administracja Credentials (Poświadczenia) wprowadź adres URL dzierżawy i token tajny pobrany wcześniej z konta usługi Atlassian Cloud. Kliknij pozycję Test Połączenie ion, aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z usługą Atlassian Cloud. Jeśli połączenie nie powiedzie się, upewnij się, że konto usługi Atlassian Cloud ma Administracja uprawnienia i spróbuj ponownie.
W polu Wiadomość e-mail z powiadomieniem wprowadź adres e-mail osoby lub grupy, która powinna otrzymywać powiadomienia o błędach aprowizacji, i zaznacz pole wyboru — Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.
Kliknij przycisk Zapisz.
W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników firmy Microsoft Entra z usługą Atlassian Cloud.
Przejrzyj atrybuty użytkownika synchronizowane z identyfikatora Entra firmy Microsoft do usługi Atlassian Cloud w sekcji Mapowanie atrybutów. Atrybut e-mail będzie używany do dopasowywania kont usługi Atlassian Cloud z kontami microsoft Entra. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.
Atrybut Typ userName String aktywne Wartość logiczna name.familyName String name.givenName String emails[type eq "work"].value String W sekcji Mapowania wybierz pozycję Synchronizuj grupy firmy Microsoft z usługą Atlassian Cloud.
Przejrzyj atrybuty grupy, które są synchronizowane z identyfikatora Entra firmy Microsoft do usługi Atlassian Cloud w sekcji Mapowanie atrybutów. Atrybut nazwy wyświetlanej będzie używany do dopasowywania grup usługi Atlassian Cloud do grup firmy Microsoft Entra. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.
Atrybut Typ displayName String externalId String członkowie Odwołanie Aby skonfigurować filtry zakresu, skorzystaj z instrukcji przedstawionych w samouczku dotyczącym filtrów zakresu.
Aby włączyć usługę aprowizacji firmy Microsoft dla usługi Atlassian Cloud, zmień stan aprowizacji na Wł. w sekcji Ustawienia.
Zdefiniuj użytkowników i/lub grupy, które chcesz aprowizować w usłudze Atlassian Cloud, wybierając żądane wartości w sekcji Zakres w sekcji Ustawienia.
Gdy wszystko będzie gotowe do rozpoczęcia aprowizacji, kliknij pozycję Zapisz.
Ta operacja rozpoczyna początkową synchronizację wszystkich użytkowników i/lub grup zdefiniowanych w sekcji Zakres w sekcji Ustawienia. Synchronizacja początkowa trwa dłużej niż kolejne synchronizacje, które są wykonywane co około 40 minut, o ile usługa aprowizacji firmy Microsoft jest uruchomiona.
Krok 6. Monitorowanie wdrożenia
Po skonfigurowaniu aprowizacji możesz skorzystać z następujących zasobów, aby monitorować wdrożenie:
- Użyj dzienników aprowizacji, aby określić, których użytkowników udało się lub nie udało aprowizować
- Sprawdź pasek postępu, aby zapoznać się ze stanem cyklu aprowizacji i czasem pozostałym do jego zakończenia
- Jeśli konfiguracja aprowizacji jest w złej kondycji, aplikacja przejdzie w stan kwarantanny. Więcej informacji o stanach kwarantanny znajdziesz tutaj.
Ograniczenia Połączenie or
- Usługa Atlassian Cloud obsługuje tylko aktualizacje aprowizacji dla użytkowników ze zweryfikowanymi domenami. Zmiany wprowadzone dla użytkowników z nieweryfikowanej domeny nie zostaną wypchnięte do usługi Atlassian Cloud. Dowiedz się więcej o zweryfikowanych domenach atlassian tutaj.
- Usługa Atlassian Cloud nie obsługuje obecnie zmian nazw grup. Oznacza to, że wszelkie zmiany w displayName grupy w identyfikatorze Entra firmy Microsoft nie zostaną zaktualizowane i odzwierciedlone w usłudze Atlassian Cloud.
- Wartość atrybutu użytkownika poczty w identyfikatorze Entra firmy Microsoft jest wypełniana tylko wtedy, gdy użytkownik ma skrzynkę pocztową programu Microsoft Exchange. Jeśli użytkownik go nie ma, zaleca się mapowania innego żądanego atrybutu na atrybut wiadomości e-mail w usłudze Atlassian Cloud.
Dziennik zmian
- 06/15/2020 — Dodano obsługę poprawki wsadowej DLA grup.
- 2021-04-21 — dodano obsługę odnajdywania schematów.
- 10/14/2022 — Zaktualizowane ograniczenia Połączenie or.
Dodatkowe zasoby
- Zarządzanie aprowizacją kont użytkowników w aplikacjach dla przedsiębiorstw
- Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?