Integracja Microsoft Entra SSO (logowanie jednokrotne) z uwierzytelnianiem SAML w RStudio Connect

Z tego artykułu dowiesz się, jak zintegrować uwierzytelnianie SAML programu RStudio Connect z identyfikatorem Entra firmy Microsoft. Po zintegrowaniu uwierzytelniania SAML programu RStudio Connect z identyfikatorem Entra firmy Microsoft można wykonywać następujące czynności:

• Kontroluj w usłudze Microsoft Entra ID, kto ma dostęp do uwierzytelniania SAML programu RStudio Connect.
• Zezwalaj swoim użytkownikom na automatyczne logowanie do programu RStudio Connect SAML Authentication przy użyciu kont Microsoft Entra.
• Zarządzaj kontami w jednej centralnej lokalizacji.

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

• Konto użytkownika Microsoft Entra z aktywną subskrypcją. Jeśli jeszcze go nie masz, możesz bezpłatnie utworzyć konto.
• Jedna z następujących ról:
  • Administrator aplikacji
  • Administrator aplikacji w chmurze
  • właściciel aplikacji.

• RStudio Connect SAML Authentication (Łączenie uwierzytelniania SAML za pomocą programu RStudio Connect). Istnieje 45-dniowa bezpłatna ocena.

Opis scenariusza

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

• Uwierzytelnianie SAML w RStudio Connect obsługuje inicjowanie logowania jednokrotnego (SSO) zarówno przez dostawcę usług (SP), jak i dostawcę tożsamości (IDP).

• Uwierzytelnianie SAML programu RStudio Connect obsługuje aprowizowanie użytkowników typu Just In Time .

Dodawanie uwierzytelniania SAML programu RStudio Connect z galerii

Aby skonfigurować integrację uwierzytelniania SAML programu RStudio Connect z identyfikatorem Entra firmy Microsoft, należy dodać uwierzytelnianie SAML programu RStudio Connect z galerii do listy zarządzanych aplikacji SaaS.

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.
2. Przejdź do Identity>Applications>Enterprise applications>New application.
3. W sekcji Dodawanie z galerii wpisz RStudio Connect SAML Authentication w polu wyszukiwania.
4. Wybierz opcję RStudio Connect SAML Authentication 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 usługi Microsoft Entra SSO dla RStudio Connect z uwierzytelnianiem SAML

Skonfiguruj i przetestuj Microsoft Entra SSO z RStudio Connect SAML Authentication przy użyciu użytkownika testowego o nazwie B.Simon. Aby SSO działało, należy nawiązać powiązanie między użytkownikiem Microsoft Entra a powiązanym użytkownikiem w RStudio Connect SAML Authentication.

Aby skonfigurować i przetestować Microsoft Entra SSO z uwierzytelnianiem SAML w RStudio Connect, wykonaj następujące kroki:

1. Skonfiguruj logowanie jednokrotne firmy Microsoft Entra — aby umożliwić użytkownikom korzystanie z tej funkcji.
   1. Utwórz testowego użytkownika Microsoft Entra - w celu przetestowania jednokrotnego logowania Microsoft Entra z Britta Simon.
   2. Przypisz testowego użytkownika Microsoft Entra — aby Britta Simon mogła korzystać z logowania jednokrotnego Microsoft Entra.
2. Skonfiguruj uwierzytelnianie SSO za pomocą SAML w RStudio Connect — aby skonfigurować ustawienia SSO po stronie aplikacji.
   1. Utwórz użytkownika testowego uwierzytelniania SAML dla RStudio Connect — aby mieć użytkownika odpowiadającego Britta Simon w uwierzytelnianiu SAML w RStudio Connect, powiązanego z reprezentacją użytkownika w Microsoft Entra.
3. Testowanie logowania jednokrotnego — aby sprawdzić, czy konfiguracja działa.

Konfigurowanie logowania jednokrotnego Microsoft Entra

Wykonaj następujące kroki, aby włączyć Microsoft Entra SSO.

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

2. Przejdź do Identity>Applications>Enterprise applications>Uwierzytelnianie SAML RStudio Connect>Jednokrotne logowanie.

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 dla Podstawowej konfiguracji protokołu SAML, aby edytować ustawienia.

   

5. W sekcji Podstawowa konfiguracja SAML, jeśli chcesz skonfigurować aplikację w trybie zainicjowanym przez IDP, wykonaj następujące kroki, zamieniając <example.com> na adres i port serwera uwierzytelniania SAML programu RStudio Connect:

   a. W polu tekstowym Identyfikator wpisz adres URL, korzystając z następującego wzorca: https://<example.com>/__login__/saml

   b. W polu tekstowym Adres URL odpowiedzi wpisz adres URL, korzystając z następującego wzorca: https://<example.com>/__login__/saml/acs

6. Kliknij przycisk Ustaw dodatkowe adresy URL i wykonaj następujący krok, jeśli chcesz skonfigurować aplikację w trybie inicjowania przez dostawcę usług:

   W polu tekstowym Adres URL logowania wpisz adres URL, korzystając z następującego wzorca: https://<example.com>/

   Uwaga

   Te wartości nie są prawdziwe. Należy je zastąpić rzeczywistymi wartościami identyfikatora, adresu URL odpowiedzi i adresu URL logowania. Są one określane na podstawie adresu serwera uwierzytelniania SAML programu RStudio Connect (https://example.com w powyższych przykładach). Jeśli masz problemy, skontaktuj się z zespołem pomocy technicznej aplikacji RStudio Connect SAML Authentication. Możesz również odwołać się do wzorców przedstawionych w sekcji Podstawowa konfiguracja protokołu SAML.

7. Aplikacja RStudio Connect SAML Authentication oczekuje asercji SAML w określonym formacie, co wymaga dodania niestandardowych mapowań atrybutów do konfiguracji atrybutów tokenu SAML. Poniższy zrzut ekranu przedstawia listę atrybutów domyślnych, gdzie nameidentifier jest mapowany na user.userprincipalname. Aplikacja uwierzytelniania SAML programu RStudio Connect oczekuje przypisania nameidentifier do user.mail, więc musisz edytować mapowanie atrybutów, klikając ikonę Edytuj, a następnie zmienić mapowanie.

   

8. 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.

   

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 co najmniej jako administrator użytkowników.
2. Przejdź do pozycji Tożsamość>Użytkownicy>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 wpisz B.Simon.
   2. W polu Nazwa głównego użytkownika wprowadź username@companydomain.extension. 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 umożliwisz B.Simon korzystanie z jednokrotnego logowania, udzielając dostępu do uwierzytelniania SAML w RStudio Connect.

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.
2. Przejdź do Identity>Applications>Enterprise applications>RStudio Connect SAML Authentication.
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.

Konfiguracja SSO uwierzytelniania SAML w RStudio Connect

Aby skonfigurować logowanie jednokrotne na potrzeby uwierzytelniania SAML programu RStudio Connect, należy użyć adresu URL metadanych federacji aplikacji oraz adresu serwera użytego powyżej. Odbywa się to w pliku konfiguracji uwierzytelniania SAML programu RStudio Connect pod adresem /etc/rstudio-connect.rstudio-connect.gcfg.

Jest to przykładowy plik konfiguracji:

[Server]
SenderEmail =

; Important! The user-facing URL of your RStudio Connect SAML Authentication server.
Address = 

[Http]
Listen = :3939

[Authentication]
Provider = saml

[SAML]
Logging = true

; Important! The URL where your IdP hosts the SAML metadata or the path to a local copy of it placed in the RStudio Connect SAML Authentication server.
IdPMetaData = 

IdPAttributeProfile = azure
SSOInitiated = IdPAndSP

Jeśli IdPAttributeProfile = azure profil ustawia parametr NameIDFormat na trwały, wraz z innymi ustawieniami, zastępując wszelkie inne określone atrybuty zdefiniowane w pliku konfiguracji.

Stanie się to problemem, jeśli chcesz utworzyć użytkownika przed upływem czasu przy użyciu interfejsu API programu RStudio Connect i zastosować uprawnienia przed zalogowaniem się użytkownika po raz pierwszy. Parametr NameIDFormat powinien być ustawiony na wartość emailAddress lub inny unikatowy identyfikator, ponieważ gdy jest ustawiony na persistent, wartość zostanie zhashowana i nie wiesz, jaka będzie wartość z góry. Korzystanie z interfejsu API nie będzie działać. Interfejs API do tworzenia użytkownika dla SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

W takiej sytuacji może być to konieczne w pliku konfiguracji:

[SAML]
NameIDFormat = emailAddress
UniqueIdAttribute = NameID
UsernameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
FirstNameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
LastNameAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
EmailAttribute = http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailAddress

Zapisz adres serwera pod wartością Server.Address, a URL metadanych federacji aplikacji pod wartością SAML.IdPMetaData. Należy pamiętać, że ta przykładowa konfiguracja korzysta z nieszyfrowanego połączenia HTTP, a identyfikator Entra firmy Microsoft wymaga użycia szyfrowanego połączenia HTTPS. Możesz użyć zwrotnego serwera proxy przed uwierzytelnianiem SAML programu RStudio Connect lub skonfigurować uwierzytelnianie SAML programu RStudio Connect, aby używać bezpośrednio protokołu HTTPS.

Jeśli masz problemy z konfiguracją, możesz przeczytać przewodnik administratora uwierzytelniania SAML programu RStudio Connect lub wysłać wiadomość e-mail do zespołu pomocy technicznej aplikacji RStudio, aby uzyskać pomoc.

Tworzenie użytkownika testowego uwierzytelniania SAML programu RStudio Connect

W tej sekcji w aplikacji RStudio Connect SAML Authentication jest tworzony użytkownik o nazwie Britta Simon. Uwierzytelnianie SAML programu RStudio Connect obsługuje aprowizację typu just in time, która jest domyślnie włączona. W tej sekcji nie musisz niczego robić. Jeśli użytkownik jeszcze nie istnieje w uwierzytelnianiu SAML RStudio Connect, nowy zostanie utworzony podczas próby dostępu do RStudio Connect SAML Authentication.

Testowanie logowania jednokrotnego

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

Inicjowane przez SP

• Kliknij Testuj tę aplikację, co spowoduje przekierowanie do adresu URL uwierzytelniania SAML RStudio Connect, gdzie można rozpocząć proces logowania.

• Przejdź bezpośrednio do adresu URL logowania SAML dla uwierzytelniania RStudio Connect i zainicjuj stamtąd proces logowania.

Inicjowane przez dostawcę tożsamości (IDP):

• Kliknij na Przetestuj tę aplikację, a powinno nastąpić automatyczne zalogowanie do uwierzytelniania SAML w RStudio Connect, dla którego skonfigurowano logowanie jednokrotne.

Możesz również użyć Moje aplikacje firmy Microsoft, aby przetestować aplikację w dowolnym trybie. Po kliknięciu kafelka Uwierzytelnianie SAML w RStudio Connect w sekcji Moje aplikacje, jeśli skonfigurowano w trybie SP, zostaniesz przekierowany do strony logowania aplikacji w celu zainicjowania przepływu logowania. Jeśli natomiast skonfigurowano w trybie IDP, nastąpi automatyczne zalogowanie do Uwierzytelnienia SAML w RStudio Connect, dla którego skonfigurowano logowanie jednokrotne (SSO). Aby uzyskać więcej informacji, zobacz Microsoft Entra Moje aplikacje.

Powiązana zawartość

Po skonfigurowaniu uwierzytelniania SAML programu RStudio Connect można 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 Aplikacji Chmurowych.