Freigeben über

Tutorial: Microsoft Entra-SSO-Integration in RStudio Connect SAML Authentication

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie RStudio Connect SAML Authentication in Microsoft Entra ID integrieren. Wenn Sie RStudio Connect SAML Authentication in Microsoft Entra ID integrieren, ist Folgendes möglich:

  • Steuern Sie in Microsoft Entra ID, wer Zugriff auf RStudio Connect SAML Authentication besitzt.
  • Ermöglichen Sie es Ihren Benutzern, sich mit ihren Microsoft Entra-Konten automatisch bei RStudio Connect SAML Authentication anzumelden.
  • Verwalten Sie Ihre Konten an einem zentralen Ort.

Voraussetzungen

Um die Microsoft Entra-Integration mit RStudio Connect SAML Authentication konfigurieren zu können, benötigen Sie Folgendes:

Beschreibung des Szenarios

In diesem Tutorial konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra in einer Testumgebung.

  • RStudio Connect SAML Authentication unterstützt SP- und IDP-initiiertes einmaliges Anmelden.

  • Für RStudio Connect SAML Authentication wird Just-In-Time-Benutzerbereitstellung unterstützt.

Um die Integration von RStudio Connect SAML Authentication in Microsoft Entra ID zu konfigurieren, müssen Sie RStudio Connect SAML Authentication über den Katalog der Liste mit den verwalteten SaaS-Apps hinzufügen.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.
  3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff RStudio Connect SAML Authentication in das Suchfeld ein.
  4. Wählen Sie RStudio Connect SAML Authentication im Ergebnisbereich aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird.

Alternativ können Sie auch den Enterprise App Configuration Wizard verwenden. Mit diesem Assistenten können Sie Ihrem Mandanten eine Anwendung hinzufügen, der App Benutzer/Gruppen hinzufügen, Rollen zuweisen sowie die SSO-Konfiguration durchlaufen. Erfahren Sie mehr über Microsoft 365-Assistenten.

Konfigurieren und Testen des einmaligen Anmeldens von Microsoft Entra für RStudio Connect SAML Authentication

Konfigurieren und testen Sie das einmalige Anmelden von Microsoft Entra mit RStudio Connect SAML Authentication mithilfe einer Testbenutzerin mit dem Namen B. Simon. Damit einmaliges Anmelden funktioniert, muss eine Linkbeziehung zwischen einem Microsoft Entra-Benutzer und dem entsprechenden Benutzer in RStudio Connect SAML Authentication eingerichtet werden.

Führen Sie die folgenden Schritte aus, um das einmalige Anmelden von Microsoft Entra für RStudio Connect SAML Authentication zu konfigurieren und zu testen:

  1. Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra, um Ihren Benutzer*innen die Verwendung dieses Features zu ermöglichen.
    1. Erstellen von Microsoft Entra-Testbenutzer*in, um das einmalige Anmelden von Microsoft Entra mit der Testbenutzerin Britta Simon zu testen.
    2. Zuweisen von Microsoft Entra-Testbenutzerin, um Britta Simon die Verwendung des einmaligen Anmeldens von Microsoft Entra zu ermöglichen.
  2. Konfigurieren des einmaligen Anmeldens für RStudio Connect SAML Authentication , um die Einstellungen für einmaliges Anmelden auf der Anwendungsseite zu konfigurieren.
    1. Erstellen einer RStudio Connect SAML Authentication-Testbenutzerin, um in RStudio Connect SAML Authentication eine Entsprechung von Britta Simon zu erhalten, die mit der Benutzerdarstellung in Microsoft Entra verknüpft ist.
  3. Testen des einmaligen Anmeldens , um zu überprüfen, ob die Konfiguration funktioniert

Konfigurieren des einmaligen Anmeldens (SSO) von Microsoft Entra

Gehen Sie wie folgt vor, um das einmalige Anmelden von Microsoft Entra zu aktivieren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>RStudio Connect SAML Authentication>Einmaliges Anmelden.

  3. Wählen Sie auf der Seite SSO-Methode auswählen die Methode SAML aus.

  4. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten auf das Stiftsymbol für Grundlegende SAML-Konfiguration, um die Einstellungen zu bearbeiten.

    Edit Basic SAML Configuration

  5. Führen Sie im Abschnitt Grundlegende SAML-Konfiguration die folgenden Schritte aus, wenn Sie die Anwendung im IDP-initiierten Modus konfigurieren möchten, und ersetzen Sie dabei <example.com> durch die Serveradresse und den Port von RStudio Connect SAML Authentication:

    a. Geben Sie im Textfeld Bezeichner eine URL im folgenden Format ein: https://<example.com>/__login__/saml

    b. Geben Sie im Textfeld Antwort-URL eine URL im folgenden Format ein: https://<example.com>/__login__/saml/acs

  6. Klicken Sie auf Zusätzliche URLs festlegen, und führen Sie den folgenden Schritt aus, wenn Sie die Anwendung im SP-initiierten Modus konfigurieren möchten:

    Geben Sie im Textfeld Anmelde-URL eine URL im folgenden Format ein: https://<example.com>/

    Hinweis

    Hierbei handelt es sich um Beispielwerte. Sie müssen diese Werte mit dem tatsächlichen Bezeichner, der Antwort-URL und der Anmelde-URL aktualisieren. Diese Angaben werden durch die Serveradresse von RStudio Connect SAML Authentication (in den Beispielen oben https://example.com) bestimmt. Wenden Sie sich bei Problemen an das Supportteam von RStudio Connect SAML Authentication. Sie können sich auch die Muster im Abschnitt Grundlegende SAML-Konfiguration ansehen.

  7. Die RStudio Connect SAML Authentication-Anwendung erwartet die SAML-Assertionen in einem bestimmten Format. Daher müssen Sie Ihrer Konfiguration der SAML-Tokenattribute benutzerdefinierte Attributzuordnungen hinzufügen. Der folgende Screenshot zeigt die Liste der Standardattribute. nameidentifier ist hier user.userprincipalname zugeordnet. Die RStudio Connect SAML Authentication-Anwendung erwartet, dass nameidentifier der Wert user.mail zugeordnet ist. Sie müssen die Attributzuordnung daher entsprechend ändern, indem Sie auf das Symbol Bearbeiten klicken.

    image

  8. Klicken Sie auf der Seite Einmaliges Anmelden (SSO) mit SAML einrichten im Abschnitt SAML-Signaturzertifikat auf die Schaltfläche „Kopieren“, um die App-Verbundmetadaten-URL zu kopieren, und speichern Sie sie auf Ihrem Computer.

    The Certificate download link

Erstellen einer Microsoft Entra-Testbenutzerin

In diesem Abschnitt erstellen Sie einen Testbenutzer mit dem Namen B. Simon.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Benutzeradministrator an.
  2. Browsen Sie zu Identität>Benutzer>Alle Benutzer.
  3. Wählen Sie oben auf dem Bildschirm Neuer Benutzer>Neuen Benutzer erstellen aus.
  4. Führen Sie unter den Eigenschaften für Benutzer die folgenden Schritte aus:
    1. Geben Sie im Feld Anzeigename den Namen B.Simon ein.
    2. Geben Sie im Feld Benutzerprinzipalname ein username@companydomain.extension. Beispiel: B.Simon@contoso.com.
    3. Aktivieren Sie das Kontrollkästchen Kennwort anzeigen, und notieren Sie sich den Wert aus dem Feld Kennwort.
    4. Klicken Sie auf Überprüfen + erstellen.
  5. Klicken Sie auf Erstellen.

Zuweisen der Microsoft Entra-Testbenutzerin

In diesem Abschnitt ermöglichen Sie B. Simon die Verwendung des einmaligen Anmeldens, indem Sie ihr Zugriff auf RStudio Connect SAML Authentication gewähren.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>RStudio Connect SAML Authentication.
  3. Wählen Sie auf der Übersichtsseite der App Benutzer und Gruppen aus.
  4. Wählen Sie Benutzer/Gruppe hinzufügen und anschließend im Dialogfeld Zuweisung hinzufügen die Option Benutzer und Gruppen aus.
    1. Wählen Sie im Dialogfeld Benutzer und Gruppen in der Liste „Benutzer“ den Eintrag B. Simon aus, und klicken Sie dann unten auf dem Bildschirm auf die Schaltfläche Auswählen.
    2. Wenn den Benutzern eine Rolle zugewiesen werden soll, können Sie sie im Dropdownmenü Rolle auswählen auswählen. Wurde für diese App keine Rolle eingerichtet, ist die Rolle „Standardzugriff“ ausgewählt.
    3. Klicken Sie im Dialogfeld Zuweisung hinzufügen auf die Schaltfläche Zuweisen.

Konfigurieren des einmaligen Anmeldens für RStudio Connect SAML Authentication

Um das einmalige Anmelden für RStudio Connect SAML Authentication zu konfigurieren, müssen Sie die Verbundmetadaten-URL der App und die Serveradresse verwenden, die oben bereits verwendet wurden. Dies erfolgt in der Konfigurationsdatei für RStudio Connect SAML Authentication unter /etc/rstudio-connect.rstudio-connect.gcfg.

Im Folgenden eine Beispielkonfigurationsdatei:

[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

Bei IdPAttributeProfile = azure legt das Profil „NameIDFormat“ neben anderen Einstellungen auf „Beständig“ fest und setzt alle in der Konfigurationsdatei definierten anderen Attribute außer Kraft.

Dies wird zu einem Problem, wenn Sie einen Benutzer vorab mithilfe der RStudio Connect-API erstellen und Berechtigungen vor der ersten Anmeldung des Benutzers anwenden möchten. Das Namens-ID-Format (NameIDFormat) sollte auf emailAddress oder einen anderen eindeutigen Bezeichner festgelegt werden. Wenn es auf „Beständig“ festgelegt ist, wird ein Hashwert erstellt, und Sie wissen vorab nicht, wie der Wert lautet. Die Verwendung der API funktioniert also nicht. API zum Erstellen von Benutzern für SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

In dieser Situation sollte Ihre Konfigurationsdatei also Folgendes enthalten:

[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

Speichern Sie die Serveradresse im Server.Address-Wert und die Verbundmetadaten-URL der App im SAML.IdPMetaData-Wert. Beachten Sie, dass in dieser Beispielkonfiguration eine unverschlüsselte HTTP-Verbindung verwendet wird, Microsoft Entra ID jedoch die Verwendung einer verschlüsselten HTTPS-Verbindung erfordert. Sie können entweder einen vorgeschalteten Reverseproxy für RStudio Connect SAML Authentication verwenden oder RStudio Connect SAML Authentication für die direkte Verwendung von HTTPS konfigurieren.

Falls Probleme bei der Konfiguration auftreten, können Sie das Administratorhandbuch zu RStudio Connect SAML Authentication lesen oder das RStudio-Supportteam per E-Mail um Unterstützung bitten.

Erstellen eines RStudio Connect SAML Authentication-Testbenutzers

In diesem Abschnitt wird in RStudio Connect SAML Authentication ein Benutzer namens Britta Simon erstellt. RStudio Connect SAML Authentication unterstützt die Just-In-Time-Benutzerbereitstellung (standardmäßig aktiviert). Für Sie steht in diesem Abschnitt kein Aktionselement zur Verfügung. Falls ein Benutzer nicht bereits in RStudio Connect SAML Authentication vorhanden ist, wird beim Versuch, auf RStudio Connect SAML Authentication zuzugreifen, ein neuer Benutzer erstellt.

Testen des einmaligen Anmeldens

In diesem Abschnitt testen Sie die Microsoft Entra-Konfiguration für einmaliges Anmelden mit den folgenden Optionen.

SP-initiiert:

  • Klicken Sie auf Diese Anwendung testen. Dadurch werden Sie zur Anmelde-URL von RStudio Connect SAML weitergeleitet, wo Sie den Anmeldeflow initiieren können.

  • Navigieren Sie direkt zur Anmelde-URL von RStudio Connect SAML Authentication, und initiieren Sie den Anmeldeablauf auf dieser Seite.

IDP-initiiert:

  • Klicken Sie auf Diese Anwendung testen. Dadurch sollten Sie automatisch bei der Instanz von RStudio Connect SAML Authentication angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben.

Sie können auch den Microsoft-Bereich „Meine Apps“ verwenden, um die Anwendung in einem beliebigen Modus zu testen. Beim Klicken auf die Kachel „RStudio Connect SAML Authentication“ in „Meine Apps“ passiert Folgendes: Wenn Sie den SP-Modus konfiguriert haben, werden Sie zum Initiieren des Anmeldeablaufs zur Anmeldeseite der Anwendung weitergeleitet, und wenn Sie den IDP-Modus konfiguriert haben, sollten Sie automatisch bei der RStudio Connect SAML Authentication-Instanz angemeldet werden, für die Sie einmaliges Anmelden eingerichtet haben. Weitere Informationen finden Sie unter „Meine Apps“ in Microsoft Entra.

Nächste Schritte

Nach dem Konfigurieren von RStudio Connect SAML Authentication können Sie die Sitzungssteuerung erzwingen, die in Echtzeit vor der Exfiltration und Infiltration vertraulicher Unternehmensdaten schützt. Die Sitzungssteuerung basiert auf bedingtem Zugriff. Erfahren Sie, wie Sie die Sitzungssteuerung mit Microsoft Defender for Cloud Apps erzwingen.