Samouczek: integracja aplikacji Microsoft Entra SSO z uwierzytelnianiem SAML programu RStudio Connect

Z tego samouczka 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

Aby skonfigurować integrację firmy Microsoft Entra z uwierzytelnianiem SAML programu RStudio Connect, potrzebne są następujące elementy:

• Subskrypcja firmy Microsoft Entra. Jeśli nie masz środowiska Microsoft Entra, możesz uzyskać bezpłatne konto.
• RStudio Connect SAML Authentication (Łączenie uwierzytelniania SAML za pomocą programu RStudio Connect). Istnieje 45-dniowa bezpłatna ocena.

Opis scenariusza

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

• Uwierzytelnianie SAML programu RStudio Connect obsługuje logowanie jednokrotne inicjowane przez dostawcę usług i dostawcę tożsamości.

• 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 sekcji Identity Applications Enterprise applications>New application (Aplikacje dla przedsiębiorstw w aplikacji> dla>przedsiębiorstw).
3. W sekcji Dodawanie z galerii wpisz RStudio Connect SAML Authentication w polu wyszukiwania.
4. Wybierz pozycję RStudio Connect SAML Authentication (Połącz uwierzytelnianie SAML) 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 firmy Microsoft dla programu RStudio Connect SAML Authentication

Skonfiguruj i przetestuj logowanie jednokrotne firmy Microsoft za pomocą programu RStudio Connect SAML Authentication przy użyciu użytkownika testowego O nazwie B.Simon. Aby logowanie jednokrotne działało, należy ustanowić relację połączenia między użytkownikiem firmy Microsoft Entra i powiązanym użytkownikiem w programie RStudio Connect SAML Authentication.

Aby skonfigurować i przetestować logowanie jednokrotne firmy Microsoft przy użyciu uwierzytelniania SAML programu RStudio Connect, 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 uwierzytelniania SAML programu RStudio Connect — aby skonfigurować ustawienia logowania jednokrotnego po stronie aplikacji.
   1. Tworzenie użytkownika testowego uwierzytelniania SAML connect RStudio Connect — aby mieć w aplikacji RStudio Connect SAML Authentication 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

Wykonaj następujące kroki, aby włączyć logowanie jednokrotne firmy Microsoft.

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

2. Przejdź do sekcji Identity Applications Enterprise applications>>RStudio Connect SAML Authentication Single sign-on (Logowanie>jednokrotne uwierzytelniania>SAML Connect).

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.

   

5. W sekcji Podstawowa konfiguracja protokołu SAML, jeśli chcesz skonfigurować aplikację w trybie zainicjowanym przez dostawcę tożsamości , wykonaj następujące kroki, zastępując <example.com> element adresem i portem 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 mapowań atrybutów niestandardowych do konfiguracji atrybutów tokenu JĘZYKA SAML. Poniższy zrzut ekranu przedstawia listę atrybutów domyślnych, natomiast atrybut nameidentifier jest mapowany na user.userprincipalname. Aplikacja uwierzytelniania SAML programu RStudio Connect oczekuje mapowania atrybutu nameidentifier z atrybutem user.mail, dlatego należy edytować mapowanie atrybutów, klikając ikonę Edytuj i zmieniając mapowanie atrybutów.

   

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 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 aplikację B.Simon, aby korzystać z logowania jednokrotnego, udzielając dostępu do uwierzytelniania SAML programu RStudio Connect.

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

Konfigurowanie logowania jednokrotnego uwierzytelniania SAML programu RStudio Connect

Aby skonfigurować logowanie jednokrotne na potrzeby uwierzytelniania SAML programu RStudio Connect, należy użyć adresu URL metadanych federacji aplikacji i 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 = azureprofil ustawi parametr NameIDFormat na trwały, między innymi ustawieniami i zastępuje 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 trwały, wartość zostanie skrócona i nie wiesz, jaka wartość jest wcześniejsza. Korzystanie z interfejsu API nie będzie działać. Interfejs API do tworzenia użytkownika dla języka 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 w Server.Address wartości i adres URL metadanych federacji aplikacji w SAML.IdPMetaData wartości . 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 w celu bezpośredniego używania 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 programie RStudio Connect SAML Authentication, zostanie utworzony podczas próby uzyskania dostępu do uwierzytelniania SAML programu RStudio Connect.

Testowanie logowania jednokrotnego

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

Inicjowane przez dostawcę usług:

• Kliknij pozycję Przetestuj tę aplikację. Spowoduje to przekierowanie do adresu URL logowania za pomocą uwierzytelniania SAML programu RStudio Connect, w którym można zainicjować przepływ logowania.

• Przejdź bezpośrednio do adresu URL logowania saml uwierzytelniania programu RStudio Connect i zainicjuj przepływ logowania z tego miejsca.

Inicjowane przez dostawcę tożsamości:

• Kliknij pozycję Przetestuj tę aplikację i powinno nastąpić automatyczne zalogowanie do uwierzytelniania SAML programu 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 programu RStudio Connect w Moje aplikacje, jeśli skonfigurowano go w trybie SP, nastąpi przekierowanie do strony logowania aplikacji w celu zainicjowania przepływu logowania i skonfigurowania w trybie dostawcy tożsamości powinno nastąpić automatyczne zalogowanie do uwierzytelniania SAML programu RStudio Connect, dla którego skonfigurowano logowanie jednokrotne. Aby uzyskać więcej informacji, zobacz Microsoft Entra Moje aplikacje.

Następne kroki

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 Chmury Apps.