RStudio Connect SAML Authentication configureren voor eenmalige aanmelding met Microsoft Entra ID

In dit artikel leert u hoe u RStudio Connect SAML Authentication integreert met Microsoft Entra ID. Wanneer u RStudio Connect SAML Authentication integreert met Microsoft Entra ID, kunt u het volgende doen:

• In Microsoft Entra ID beheren wie toegang heeft tot RStudio Connect SAML Authentication.
• Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij RStudio Connect SAML Authentication.
• Beheer uw accounts op één centrale locatie.

Vereisten

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

• Een Microsoft Entra-gebruikersaccount met een actief abonnement. Als u nog geen account hebt, kunt u gratis een account maken.
• Een van de volgende rollen:
  • Toepassingsbeheerder
  • Cloudtoepassingsbeheerder
  • Toepassingseigenaar.

• RStudio Connect SAML-authenticatie Er is een gratis evaluatieversie van 45 dagen.

Beschrijving van scenario

In dit artikel configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

• RStudio Connect SAML Authentication ondersteunt SP en IDP-geïnitieerde Single Sign-On.

• RStudio Connect SAML Authentication biedt ondersteuning voor Just-In-Time-inrichting van gebruikers.

RStudio Connect SAML Authentication toevoegen vanuit galerie

Als u de integratie van RStudio Connect SAML Authentication in Microsoft Entra ID wilt configureren, moet u RStudio Connect SAML Authentication vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

1. Meld u aan bij het Microsoft Entra-beheercentrum als minimaal een Cloudtoepassingsbeheerder.
2. Blader naar Entra ID>Enterprise-apps>Nieuwe toepassing.
3. Typ in de sectie Toevoegen uit de galerieRStudio Connect SAML Authentication in het zoekvak.
4. Selecteer RStudio Connect SAML Authentication in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden terwijl de app aan uw tenant wordt toegevoegd.

Als alternatief kunt u ook de Enterprise App Configuration Wizard gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Microsoft Entra SSO voor RStudio Connect "SAML Authentication" configureren en testen

Configureer en test Microsoft Entra SSO met RStudio Connect SAML-authenticatie, door een testgebruiker genaamd B.Simon te gebruiken. Voor SSO om te werken, moet u een koppelingsrelatie tot stand brengen tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in RStudio Connect SAML Authentication.

Voer de volgende stappen uit om Microsoft Entra SSO met RStudio Connect SAML Authentication te configureren en te testen:

1. Configureer eenmalige aanmelding van Microsoft Entra - zodat uw gebruikers deze functie kunnen gebruiken.
   1. Maak een Microsoft Entra-testgebruiker om eenmalige aanmelding van Microsoft Entra te testen met Britta Simon.
   2. Wijs de Microsoft Entra-testgebruiker toe : om Britta Simon in staat te stellen gebruik te maken van eenmalige aanmelding van Microsoft Entra.
2. Single Sign-On voor RStudio Connect SAML Authentication configureren om de Single Sign-On-instellingen aan de toepassingskant te configureren.
   1. Testgebruiker voor RStudio Connect SAML Authentication maken : als u een tegenhanger van Britta Simon in RStudio Connect SAML Authentication wilt hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
3. Eenmalige aanmelding testen : om te controleren of de configuratie werkt.

Microsoft Entra SSO configureren

Volg deze stappen om eenmalige aanmelding (SSO) van Microsoft Entra in te schakelen.

1. Meld u aan bij het Microsoft Entra-beheercentrum als minimaal een Cloudtoepassingsbeheerder.

2. Blader naar Entra ID>Enterprise-apps>RStudio Connect SAML Authentication>Eenmalige aanmelding.

3. Selecteer SAML op de pagina Een methode voor eenmalige aanmelding selecteren.

4. Selecteer op de pagina Eenmalige aanmelding instellen met SAML het potloodpictogram voor Standaard SAML-configuratie om de instellingen te bewerken.

   

5. Als u de toepassing in de door IDP geïnitieerde modus wilt configureren, voert u in de sectie Standaard SAML-configuratie de volgende stappen uit, waarbij <example.com> u het adres en de poort van uw RStudio Connect SAML Authentication-server vervangt:

   een. Typ in het tekstvak Id een URL met het volgende patroon: https://<example.com>/__login__/saml

   b. Typ in het tekstvak Antwoord-URL een URL met het volgende patroon: https://<example.com>/__login__/saml/acs

6. Selecteer Extra URL's instellen en voer de volgende stap uit als u de toepassing in de door SP geïnitieerde modus wilt configureren:

   Typ in het tekstvak Aanmeldings-URL een URL met het volgende patroon: https://<example.com>/

   Notitie

   Deze waarden zijn niet echt. Werk deze waarden bij met de werkelijke-id, de antwoord-URL en de aanmeldings-URL. Deze worden bepaald op basis van het RStudio Connect SAML Authentication-serveradres (https://example.com in de bovenstaande voorbeelden). Neem contact op met het ondersteuningsteam van RStudio Connect SAML Authentication als u problemen ondervindt. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

7. Uw RStudio Connect SAML Authentication-toepassing verwacht de SAML-asserties in een specifieke indeling, waarvoor u aangepaste kenmerktoewijzingen moet toevoegen aan de configuratie van de SAML-tokenkenmerken. In de volgende schermopname ziet u de lijst met standaardkenmerken, terwijl nameidentifier is toegewezen aan user.userprincipalname. In de RStudio Connect SAML Authentication-toepassing wordt verwacht dat nameidentifier wordt toegewezen aan user.mail. Daarom moet u de kenmerktoewijzing bewerken door het pictogram Bewerken te selecteren en de kenmerktoewijzing te wijzigen.

   

8. Selecteer op de pagina Single Sign-On instellen met SAML in de sectie SAML-handtekeningcertificaat de knop Kopiëren om de URL voor federatieve metagegevens van de app te kopiëren en op uw computer op te slaan.

   

Microsoft Entra-testgebruiker maken en toewijzen

Volg de richtlijnen in de quickstart voor het maken en toewijzen van een gebruikersaccount om een testgebruikersaccount met de naam B.Simon te maken.

RStudio Connect SAML-authenticatie SSO configureren

Als u eenmalige aanmelding wilt configureren voor RStudio Connect SAML Authentication, moet u de app-URL voor federatieve metagegevens en het serveradres gebruiken dat hierboven wordt gebruikt. Dit doet u in het RStudio Connect SAML Authentication-configuratiebestand in /etc/rstudio-connect.rstudio-connect.gcfg.

Dit is een voorbeeld van een configuratiebestand:

[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

Als IdPAttributeProfile = azurehet profiel de NameIDFormat instelt op persistent, worden onder andere instellingen en eventuele andere opgegeven kenmerken overschreven die zijn gedefinieerd in het configuratiebestand.

Dat wordt een probleem als u van tevoren een gebruiker wilt maken met de RStudio Connect-API en machtigingen wilt toepassen voordat de gebruiker zich de eerste keer aanmeldt. De NameIDFormat moet worden ingesteld op e-mailadres of een andere unieke id, omdat wanneer deze op persistent is ingesteld, de waarde wordt gehasht en u niet weet wat de waarde van tevoren zal zijn. Het gebruik van de API werkt dus niet. Een API voor het maken van een gebruiker voor SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

Mogelijk wilt u dat in uw configuratiebestand in deze situatie hebben:

[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

Sla uw serveradres op in de Server.Address waarde en de APP-URL voor federatieve metagegevens in de SAML.IdPMetaData waarde. Houd er rekening mee dat voor deze voorbeeldconfiguratie een niet-versleutelde HTTP-verbinding wordt gebruikt, terwijl Microsoft Entra-id het gebruik van een versleutelde HTTPS-verbinding vereist. U kunt een omgekeerde proxy voor RStudio Connect SAML Authentication gebruiken of RStudio Connect SAML Authentication configureren om HTTPS rechtstreeks te gebruiken.

Als u problemen hebt met de configuratie, kunt u de beheerhandleiding voor RStudio Connect SAML Authentication lezen of het ondersteuningsteam van RStudio e-mailen voor hulp.

Testgebruiker voor RStudio Connect SAML Authentication maken

In deze sectie wordt een gebruiker met de naam Britta Simon gemaakt in RStudio Connect SAML Authentication. RStudio Connect SAML Authentication biedt ondersteuning voor just-in-time-provisioning, wat standaard is ingeschakeld. Deze sectie bevat geen actie-item voor u. Als een gebruiker nog niet bestaat in RStudio Connect SAML Authentication, wordt er een nieuwe gemaakt wanneer u RStudio Connect SAML Authentication opent.

Testen van Single Sign-On (SSO)

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

SP gestart:

• Selecteer Deze toepassing testen. Met deze optie wordt u omgeleid naar de aanmeldings-URL van RStudio Connect SAML Authentication, waar u de aanmeldingsstroom kunt initiëren.

• Ga rechtstreeks naar de aanmeldings-URL van RStudio Connect SAML Authentication om de aanmeldingsstroom daar te initiëren.

IDP gestart:

• Selecteer Test deze applicatie en u wordt automatisch aangemeld bij RStudio Connect SAML Authentication waarvoor u SSO hebt ingesteld.

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u de tegel RStudio Connect SAML Authentication selecteert in Mijn apps, als deze is geconfigureerd in de SP-modus, wordt u omgeleid naar de aanmeldingspagina van de toepassing voor het initiëren van de aanmeldingsstroom. Als deze is geconfigureerd in de IDP-modus, wordt u automatisch aangemeld bij het exemplaar van RStudio Connect SAML Authentication waarvoor u eenmalige aanmelding hebt ingesteld. Zie Microsoft Entra My Apps voor meer informatie.

Verwante inhoud

Zodra u RStudio Connect SAML Authentication hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.