Share via

Zelfstudie: Integratie van eenmalige aanmelding van Microsoft Entra met RStudio Connect SAML Authentication

  • Artikel

In deze zelfstudie 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

Voor het configureren van Microsoft Entra-integratie met RStudio Connect SAML Authentication hebt u het volgende nodig:

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

  • RStudio Connect SAML Authentication ondersteunt met SP en IDP geïnitieerde eenmalige aanmelding.

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

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 als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ in het gedeelte Toevoegen uit de galerie RStudio Connect SAML Authentication in het zoekvak.
  4. Selecteer RStudio Connect SAML Authentication in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden tot de app aan de tenant is toegevoegd.

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

Eenmalige aanmelding van Microsoft Entra voor RStudio Connect SAML Authentication configureren en testen

Configureer en test eenmalige aanmelding van Microsoft Entra met RStudio Connect SAML Authentication met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in RStudio Connect SAML Authentication.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra 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. Eenmalige aanmelding voor RStudio Connect SAML Authentication configureren: om de instellingen voor eenmalige aanmelding aan de toepassingszijde 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.

Eenmalige aanmelding voor Microsoft Entra configureren

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

  1. Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.

  2. Blader naar Identity>Applications Enterprise-toepassingen>>RStudio Connect SAML Authentication>Eenmalige aanmelding.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

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

    Standaard SAML-configuratie bewerken

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

    a. In het tekstvak Id typt u een URL met het volgende patroon: https://<example.com>/__login__/saml

    b. In het tekstvak Antwoord-URL typt u een URL met de volgende notatie: https://<example.com>/__login__/saml/acs

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

    In het tekstvak Aanmeldings-URL typt u een URL met het volgende patroon: https://<example.com>/

    Notitie

    Dit zijn geen echte waarden. 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. Op de volgende schermafbeelding ziet u de lijst met standaardkenmerken, waarbij nameidentifier is toegewezen aan user.userprincipalname. In de RStudio Connect SAML Authentication-toepassing wordt verwacht dat nameidentifier is toegewezen aan user.mail. Daarom moet u de kenmerktoewijzing bewerken door op het pictogram Bewerken te klikken en de kenmerktoewijzing te wijzigen.

    image

  8. Op de pagina Eenmalige aanmelding met SAML instellen in het gedeelte SAML-handtekeningcertificaat klikt u op de kopieerknop om de URL voor federatieve metagegevens van de app te kopiëren en slaat u deze op uw computer op.

    De link om het certificaat te downloaden

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruikersbeheerder.
  2. Blader naar Identiteit>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. Bijvoorbeeld: B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Controleren + maken.
  5. Selecteer Maken.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot RStudio Connect SAML Authentication.

  1. Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
  2. Blader naar Bedrijfstoepassingen voor Identiteitstoepassingen>>>RStudio Connect SAML Authentication.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

Eenmalige aanmelding in RStudio Connect SAML Authentication configureren

Als u eenmalige aanmelding wilt configureren voor RStudio Connect SAML Authentication, moet u de App-URL voor federatieve metagegevens en het Serveradres gebruiken die hierboven zijn 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, bijvoorbeeld, IdPAttributeProfile = azurehet profiel de NameIDFormat instelt op persistent, onder andere instellingen en eventuele andere opgegeven kenmerken overschrijft 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 emailAddress of een andere unieke id, omdat als deze is ingesteld op permanent, de waarde wordt gehasht en u niet weet wat de waarde van tevoren is. 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 waarde Server.Address en de App-URL voor federatieve metagegevens in de waarde SAML.IdPMetaData. 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 gebruiken vóór RStudio Connect SAML Authentication of RStudio Connect SAML Authentication configureren om HTTPS direct te gebruiken.

Als u problemen ondervindt met de configuratie, kunt u de beheerdershandleiding voor RStudio Connect SAML Authentication lezen of een e-mail sturen aan het ondersteuningsteam van RStudio 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-inrichting van gebruikers. Deze functie is standaard ingeschakeld. Er is geen actie-item voor u in deze sectie. Als een gebruiker nog niet bestaat in RStudio Connect SAML Authentication, wordt er een nieuwe gemaakt wanneer u RStudio Connect SAML Authentication opent.

Eenmalige aanmelding testen

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

Met SP geïnitieerd:

  • Klik op Deze toepassing testen. U wordt 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.

Met IDP geïnitieerd:

  • Klik op Deze toepassing testen en u wordt automatisch aangemeld bij het exemplaar van RStudio Connect SAML Authentication waarvoor u eenmalige aanmelding hebt ingesteld.

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u op de tegel van RStudio Connect SAML Authentication in Mijn apps klikt en 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 de instantie van RStudio Connect SAML Authentication waarvoor u eenmalige aanmelding hebt ingesteld. Zie Microsoft Entra Mijn apps voor meer informatie.

Volgende stappen

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.