Tutoriel : Intégration de Microsoft Entra SSO avec l'authentification SAML RStudio Connect

Article
03/25/2024

Dans ce didacticiel, vous apprendrez comment intégrer l'authentification SAML RStudio Connect avec Microsoft Entra ID. Lorsque vous intégrez l'authentification SAML RStudio Connect avec Microsoft Entra ID, vous pouvez :

Contrôlez dans Microsoft Entra ID qui a accès à l’authentification SAML RStudio Connect.
Permettez à vos utilisateurs d’être automatiquement connectés à l’authentification SAML RStudio Connect avec leurs comptes Microsoft Entra.
Gérer vos comptes à partir d’un emplacement central.

Prérequis

Pour configurer l'intégration de Microsoft Entra avec l'authentification SAML RStudio Connect, vous avez besoin des éléments suivants :

Une souscription Microsoft Entra. Si vous ne disposez pas d’un environnement Microsoft Entra, vous pouvez obtenir un compte gratuit.
RStudio Connect SAML Authentication. Il existe une évaluation gratuite de 45 jours.

Description du scénario

Dans ce didacticiel, vous configurez et testez l’authentification unique Microsoft Entra dans un environnement de test.

RStudio Connect SAML Authentication prend en charge l’authentification unique lancée par le fournisseur de services et le fournisseur d’identité.
RStudio Connect SAML Authentication prend en charge l’attribution d’utilisateurs juste-à-temps.

Ajouter RStudio Connect SAML Authentication à partir de la galerie

Pour configurer l'intégration de l'authentification SAML RStudio Connect dans Microsoft Entra ID, vous devez ajouter l'authentification SAML RStudio Connect depuis la galerie à votre liste d'applications SaaS gérées.

Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.
Dans la section Ajouter à partir de la galerie, tapez RStudio Connect SAML Authentication dans la zone de recherche.
Sélectionnez RStudio Connect SAML Authentication dans le volet de résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez également utiliser l’assistant Entreprise App Configuration. Dans cet assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, mais également parcourir la configuration de l’authentification unique. En savoir plus sur les assistants Microsoft 365.

Configurer et tester Microsoft Entra SSO pour l'authentification SAML RStudio Connect

Configurez et testez Microsoft Entra SSO avec l'authentification SAML RStudio Connect à l'aide d'un utilisateur test appelé B.Simon. Pour que SSO fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l'utilisateur associé dans l'authentification SAML RStudio Connect.

Pour configurer et tester Microsoft Entra SSO avec l'authentification SAML RStudio Connect, effectuez les étapes suivantes :

Configurer Microsoft Entra SSO – pour permettre à vos utilisateurs d'utiliser cette fonctionnalité.
1. Créer un utilisateur test Microsoft Entra – pour tester l'authentification unique Microsoft Entra avec Britta Simon.
2. Attribuez l’utilisateur de test Microsoft Entra pour permettre à Britta Simon d’utiliser l’authentification unique Microsoft Entra.
Configurer l’authentification unique RStudio Connect SAML Authentication pour configurer les paramètres de l’authentification unique côté application.
1. Créer un utilisateur de test d'authentification SAML RStudio Connect – pour avoir un homologue de Britta Simon dans l'authentification RStudio Connect SAML qui est liée à la représentation Microsoft Entra de l'utilisateur.
Tester l’authentification unique pour vérifier si la configuration fonctionne.

Configurer Microsoft Entra SSO

Effectuez ces étapes pour activer l’authentification unique Microsoft Entra.

Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
Accédez à Identité>Applications>Applications d’entreprise>RStudio Connect SAML Authentication>Authentification unique.
Dans la page Sélectionner une méthode d’authentification unique, sélectionnez SAML.
Dans la page Configurer l’authentification unique avec SAML, cliquez sur l’icône de crayon de Configuration SAML de base afin de modifier les paramètres.
Dans la section Configuration SAML de base, si vous souhaitez configurer l’application en mode lancé par le fournisseur d’identité, effectuez les étapes suivantes, en remplaçant <example.com> par l’adresse et le port de votre serveur RStudio Connect SAML Authentication :

a. Dans la zone de texte Identificateur, tapez une URL au format suivant : https://<example.com>/__login__/saml

b. Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://<example.com>/__login__/saml/acs
Si vous souhaitez configurer l’application en mode démarré par le fournisseur de services, cliquez sur Définir des URL supplémentaires, puis effectuez les étapes suivantes :

Dans la zone de texte URL de connexion, tapez une URL au format suivant : https://<example.com>/.

Remarque

Il ne s’agit pas de valeurs réelles. Mettez à jour ces valeurs avec l’identificateur, l’URL de réponse et l’URL de connexion réels. Elles sont déterminées à partir de l’adresse du serveur RStudio Connect SAML Authentication (https://example.com dans les exemples ci-dessus). Contactez l’équipe du support technique RStudio Connect SAML Authentication si vous rencontrez des problèmes. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.
Votre application RStudio Connect SAML Authentication s’attend à recevoir les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à votre configuration d’attributs de jeton SAML. La capture d’écran suivante montre la liste des attributs par défaut, où nameidentifier est mappé avec user.userprincipalname. L’application RStudio Connect SAML Authentication s’attend à ce que nameidentifier soit mappé sur user.mail. Vous devez donc changer le mappage d’attribut en cliquant sur l’icône Modifier.
Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, cliquez sur le bouton Copier pour copier l’URL des métadonnées de fédération d’application, puis enregistrez-la sur votre ordinateur.

Créer un utilisateur de test Microsoft Entra

Dans cette section, vous allez créer un utilisateur de test appelé B.Simon.

Connectez-vous au Centre d’administration de Microsoft Entra en tant qu’Administrateur de l’utilisateur.
Accédez à Identité>Utilisateurs>Tous les utilisateurs.
Sélectionnez Nouvel utilisateur>Créer un utilisateur dans la partie supérieure de l’écran.
Dans les propriétés Utilisateur, effectuez les étapes suivantes :
1. Dans le champ Nom d’affichage, entrez B.Simon.
2. Dans le champ Nom d’utilisateur principal, entrez username@companydomain.extension. Par exemple : B.Simon@contoso.com.
3. Cochez la case Afficher le mot de passe, puis notez la valeur affichée dans le champ Mot de passe.
4. Sélectionnez Revoir + créer.
Sélectionnez Create (Créer).

Attribuer l’utilisateur test Microsoft Entra

Dans cette section, vous autorisez B.Simon à utiliser l’authentification unique en lui accordant l’accès à RStudio Connect SAML Authentication.

Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
Accédez à Identité>Applications>Applications d’entreprise>RStudio Connect SAML Authentication.
Dans la page de présentation de l’application, sélectionnez Utilisateurs et groupes.
Sélectionnez Ajouter un utilisateur/groupe, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
1. Dans la boîte de dialogue Utilisateurs et groupes, sélectionnez B. Simon dans la liste Utilisateurs, puis cliquez sur le bouton Sélectionner au bas de l’écran.
2. Si vous attendez qu’un rôle soit attribué aux utilisateurs, vous pouvez le sélectionner dans la liste déroulante Sélectionner un rôle . Si aucun rôle n’a été configuré pour cette application, vous voyez le rôle « Accès par défaut » sélectionné.
3. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique RStudio Connect SAML Authentication

Pour configurer l’authentification unique pour RStudio Connect SAML Authentication, vous devez utiliser l’URL des métadonnées de fédération d’application et l’adresse du serveur utilisées ci-dessus. Cette opération est effectuée dans le fichier de configuration RStudio Connect SAML Authentication dans /etc/rstudio-connect.rstudio-connect.gcfg.

Voici un exemple de fichier de configuration :

[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

Si IdPAttributeProfile = azure, le profil définit nameIDFormat sur « persistent », entre autres paramètres et remplace tous les autres attributs spécifiés définis dans le fichier de configuration.

Cela devient un problème si vous souhaitez créer un utilisateur à l’avance à l’aide de l’API RStudio Connect et appliquer des autorisations avant la première connexion de l’utilisateur. NameIDFormat doit être défini sur emailAddress ou un autre identificateur unique, car lorsqu’il est défini sur « persistent », la valeur est hachée et vous ne pouvez pas la deviner à l’avance. Ainsi, l’utilisation de l’API ne fonctionnera pas. API pour la création d’un utilisateur pour SAML : https://docs.rstudio.com/connect/api/#post-/v1/users

Vous pouvez donc avoir ceci dans votre fichier de configuration dans ce cas :

[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

Stockez l’adresse du serveur dans la valeur Server.Address, et l’URL des métadonnées de fédération d'application dans la valeur SAML.IdPMetaData. Notez que cet exemple de configuration utilise une connexion HTTP non chiffrée, tandis que Microsoft Entra ID nécessite l'utilisation d'une connexion HTTPS chiffrée. Vous pouvez soit utiliser un proxy inverse devant RStudio Connect SAML Authentication, soit configurer RStudio Connect SAML Authentication pour une utilisation directe de HTTPS.

Si vous rencontrez des problèmes de configuration, vous pouvez lire le Guide de l’administrateur RStudio Connect SAML Authentication ou envoyer un e-mail à l’équipe du support technique de RStudio pour obtenir de l’aide.

Créer un utilisateur de test RStudio Connect SAML Authentication

Dans cette section, un utilisateur appelé Britta Simon est créé dans RStudio Connect SAML Authentication. RStudio Connect SAML Authentication prend en charge le provisionnement juste-à-temps, option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’y a pas déjà un utilisateur dans RStudio Connect SAML Authentication, un utilisateur est créé quand vous tentez d’y accéder.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

Lancée par le fournisseur de services :

Cliquez sur Tester cette application. Vous êtes alors redirigé vers l’URL de connexion à RStudio Connect SAML Authentication, d’où vous pouvez lancer le flux de connexion.
Accédez directement à l’URL de connexion RStudio Connect SAML Authentication pour lancer le flux de connexion.

Lancée par le fournisseur d’identité :

Cliquez sur Tester cette application, ce qui devrait vous connecter automatiquement à l’application RStudio Connect SAML Authentication pour laquelle vous avez configuré l’authentification unique.

Vous pouvez aussi utiliser Mes applications de Microsoft pour tester l’application dans n’importe quel mode. Quand vous cliquez sur la vignette RStudio Connect SAML Authentication dans Mes applications, si le mode Fournisseur de services est configuré, vous êtes redirigé vers la page d’authentification de l’application pour lancer le processus de connexion. Si le mode Fournisseur d’identité est configuré, vous êtes automatiquement connecté à l’application RStudio Connect SAML Authentication pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations, consultez Mes applications Microsoft Entra.

Étapes suivantes

Après avoir configuré RStudio Connect SAML Authentication, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.

Partager via