Dela via

Självstudie: Microsoft Entra SSO-integrering med RStudio Connect SAML-autentisering

  • Artikel

I den här självstudien lär du dig att integrera RStudio Connect SAML-autentisering med Microsoft Entra-ID. När du integrerar RStudio Connect SAML-autentisering med Microsoft Entra-ID kan du:

  • Kontroll i Microsoft Entra-ID som har åtkomst till RStudio Connect SAML-autentisering.
  • Gör så att dina användare automatiskt loggas in på RStudio Connect SAML-autentisering med sina Microsoft Entra-konton.
  • Hantera dina konton på en central plats.

Förutsättningar

För att konfigurera Microsoft Entra-integrering med RStudio Connect SAML-autentisering behöver du följande:

Beskrivning av scenario

I den här självstudien konfigurerar och testar du enkel inloggning med Microsoft Entra i en testmiljö.

  • RStudio Connect SAML-autentisering stöder SP- och IDP-initierad enkel inloggning.

  • RStudio Connect SAML-autentisering stöder just-in-time-användaretablering .

För att konfigurera integreringen av RStudio Connect SAML-autentisering i Microsoft Entra-ID måste du lägga till RStudio Connect SAML-autentisering från galleriet i din lista över hanterade SaaS-appar.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
  2. Bläddra till Identity>Applications Enterprise-program>>Nytt program.
  3. I avsnittet Lägg till från galleriet skriver du RStudio Connect SAML-autentisering i sökrutan.
  4. Välj RStudio Connect SAML Authentication från resultatpanelen och lägg sedan till appen. Vänta några sekunder medan appen läggs till i din klientorganisation.

Du kan också använda guiden Konfiguration av företagsappar. I den här guiden kan du lägga till ett program i din klientorganisation, lägga till användare/grupper i appen, tilldela roller samt gå igenom SSO-konfigurationen. Läs mer om Microsoft 365-guider.

Konfigurera och testa Microsoft Entra SSO för RStudio Connect SAML-autentisering

Konfigurera och testa Microsoft Entra SSO med RStudio Connect SAML-autentisering med hjälp av en testanvändare med namnet B.Simon. För att enkel inloggning ska fungera måste du upprätta en länkrelation mellan en Microsoft Entra-användare och den relaterade användaren i RStudio Connect SAML-autentisering.

Utför följande steg för att konfigurera och testa Microsoft Entra SSO med RStudio Connect SAML-autentisering:

  1. Konfigurera Microsoft Entra SSO – så att användarna kan använda den här funktionen.
    1. Skapa en Microsoft Entra-testanvändare – för att testa enkel inloggning med Microsoft Entra med Britta Simon.
    2. Tilldela Microsoft Entra-testanvändaren – för att göra det möjligt för Britta Simon att använda enkel inloggning med Microsoft Entra.
  2. Konfigurera SSO för RStudio Connect SAML-autentisering – för att konfigurera inställningarna för enkel inloggning på programsidan.
    1. Skapa RStudio Connect SAML Authentication-testanvändare – för att ha en motsvarighet till Britta Simon i RStudio Connect SAML-autentisering som är länkad till Microsoft Entra-representationen av användaren.
  3. Testa enkel inloggning – för att kontrollera om konfigurationen fungerar.

Konfigurera enkel inloggning med Microsoft Entra

Följ de här stegen för att aktivera Enkel inloggning i Microsoft Entra.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications Enterprise-program>> RStudio Connect SAML Authentication>Enkel inloggning.

  3. På sidan Välj en enkel inloggningsmetod väljer du SAML.

  4. På sidan Konfigurera enkel inloggning med SAML klickar du på pennikonen för Grundläggande SAML-konfiguration för att redigera inställningarna.

    Redigera grundläggande SAML-konfiguration

  5. Om du vill konfigurera programmet i IDP-initierat läge i avsnittet Grundläggande SAML-konfiguration utför du följande steg och ersätter <example.com> med din RStudio Connect SAML-autentiseringsserveradress och port:

    a. I textrutan Identifierare skriver du en URL med följande mönster: https://<example.com>/__login__/saml

    b. Skriv en URL med följande mönster i textrutan Svars-URL: https://<example.com>/__login__/saml/acs

  6. Klicka på Ange ytterligare URL:er och gör följande om du vill konfigurera appen i SP-initierat läge:

    I textrutan Inloggnings-URL skriver du in en URL med följande mönster: https://<example.com>/

    Kommentar

    Dessa värden är inte verkliga. Uppdatera värdena med den faktiska identifieraren, svars-URL och inloggnings-URL. De bestäms från RStudio Connect SAML-autentiseringsserveradressen (https://example.com i exemplen ovan). Kontakta supportteamet för RStudio Connect SAML-autentisering om du har problem. Du kan också referera till de mönster som visas i avsnittet Grundläggande SAML-konfiguration .

  7. Ditt RStudio Connect SAML-autentiseringsprogram förväntar sig SAML-försäkran i ett visst format, vilket kräver att du lägger till anpassade attributmappningar i konfigurationen av SAML-tokenattribut. Följande skärmbild visar listan med standardattribut, medan nameidentifier mappas med user.userprincipalname. RStudio Connect SAML Authentication-programmet förväntar sig att namnidentifieraren mappas med user.mail, så du måste redigera attributmappningen genom att klicka på ikonen Redigera och ändra attributmappningen.

    bild

  8. Klicka på kopieringsknappen i avsnittet SAML-signeringscertifikat på sidan Konfigurera enkel inloggning med SAML om du vill kopiera URL:en för federationsmetadata och spara den på datorn.

    Länk för nedladdning av certifikatet

Skapa en Microsoft Entra-testanvändare

I det här avsnittet skapar du en testanvändare med namnet B.Simon.

  1. Logga in på administrationscentret för Microsoft Entra som minst användaradministratör.
  2. Gå till Identitet>Användare>Alla användare.
  3. Välj Ny användare>Skapa ny användare överst på skärmen.
  4. Följ dessa steg i användaregenskaperna :
    1. I fältet Visningsnamn anger du B.Simon.
    2. I fältet Användarens huvudnamn anger du username@companydomain.extension. Exempel: B.Simon@contoso.com
    3. Markera kryssrutan Visa lösenord och skriv sedan ned det värde som visas i rutan Lösenord.
    4. Välj Granska + skapa.
  5. Välj Skapa.

Tilldela Microsoft Entra-testanvändaren

I det här avsnittet gör du det möjligt för B.Simon att använda enkel inloggning genom att ge åtkomst till RStudio Connect SAML-autentisering.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
  2. Bläddra till Identity>Applications Enterprise-program>>RStudio Connect SAML-autentisering.
  3. På appens översiktssida väljer du Användare och grupper.
  4. Välj Lägg till användare/grupp och välj sedan Användare och grupper i dialogrutan Lägg till tilldelning .
    1. I dialogrutan Användare och grupper väljer du B.Simon i listan Användare och klickar sedan på knappen Välj längst ned på skärmen.
    2. Om du förväntar dig att en roll ska tilldelas till användarna kan du välja den i listrutan Välj en roll . Om ingen roll har konfigurerats för den här appen visas rollen "Standardåtkomst" markerad.
    3. I dialogrutan Lägg till tilldelning klickar du på knappen Tilldela.

Konfigurera enkel inloggning för RStudio Connect SAML-autentisering

För att konfigurera enkel inloggning för RStudio Connect SAML-autentisering måste du använda url:en för appfederationsmetadata och serveradressen som används ovan. Detta görs i konfigurationsfilen för RStudio Connect SAML-autentisering på /etc/rstudio-connect.rstudio-connect.gcfg.

Det här är en exempelkonfigurationsfil:

[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

Om IdPAttributeProfile = azureanger profilen NameIDFormat till beständig, bland annat inställningar och åsidosätter andra angivna attribut som definierats i konfigurationsfilen.

Detta blir ett problem om du vill skapa en användare i förväg med hjälp av RStudio Connect-API:et och tillämpa behörigheter innan användaren loggar in första gången. NameIDFormat ska anges till emailAddress eller någon annan unik identifierare, eftersom när det är inställt på beständiga, så hashas värdet och du vet inte vad värdet är i förväg. Så att använda API:et fungerar inte. API för att skapa användare för SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

Så du kanske vill ha detta i konfigurationsfilen i den här situationen:

[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

Lagra serveradressen Server.Address i värdet och url:en för appfederationsmetadata i SAML.IdPMetaData värdet. Observera att den här exempelkonfigurationen använder en okrypterad HTTP-anslutning, medan Microsoft Entra-ID kräver användning av en krypterad HTTPS-anslutning. Du kan antingen använda en omvänd proxy framför RStudio Connect SAML-autentisering eller konfigurera RStudio Connect SAML-autentisering för att använda HTTPS direkt.

Om du har problem med konfigurationen kan du läsa administrationsguiden för RStudio Connect SAML-autentisering eller skicka ett e-postmeddelande till RStudio-supportteamet om du behöver hjälp.

Skapa testanvändare för RStudio Connect SAML-autentisering

I det här avsnittet skapas en användare med namnet Britta Simon i RStudio Connect SAML Authentication. RStudio Connect SAML-autentisering stöder just-in-time-etablering, vilket är aktiverat som standard. Det finns inget åtgärdsobjekt för dig i det här avsnittet. Om en användare inte redan finns i RStudio Connect SAML-autentisering skapas en ny när du försöker komma åt RStudio Connect SAML-autentisering.

Testa enkel inloggning

I det här avsnittet testar du konfigurationen av enkel inloggning med Microsoft Entra med följande alternativ.

SP-initierad:

  • Klicka på Testa det här programmet. Detta omdirigeras till RStudio Connect SAML Authentication Sign on URL där du kan initiera inloggningsflödet.

  • Gå till RStudio Connect SAML Authentication Sign-on URL direkt och initiera inloggningsflödet därifrån.

IDP-initierad:

  • Klicka på Testa det här programmet så bör du automatiskt loggas in på RStudio Connect SAML-autentisering som du har konfigurerat enkel inloggning för.

Du kan också använda Microsoft Mina appar för att testa programmet i valfritt läge. När du klickar på panelen RStudio Connect SAML Authentication i Mina appar omdirigeras du om du konfigureras i SP-läge till sidan för programinloggning för att initiera inloggningsflödet och om det konfigureras i IDP-läge bör du automatiskt loggas in på RStudio Connect SAML-autentiseringen som du har konfigurerat enkel inloggning för. Mer information finns i Microsoft Entra Mina appar.

Nästa steg

När du har konfigurerat RStudio Connect SAML-autentisering kan du framtvinga sessionskontroll, vilket skyddar exfiltrering och infiltration av organisationens känsliga data i realtid. Sessionskontrollen utökas från villkorlig åtkomst. Lär dig hur du framtvingar sessionskontroll med Microsoft Defender för molnet Apps.