Tutorial: Integración del inicio de sesión único de Microsoft Entra con RStudio Connect SAML Authentication

Artículo
03/25/2024

En este tutorial, obtendrá información sobre cómo integrar RStudio Connect SAML Authentication con Microsoft Entra ID. Al integrar RStudio Connect SAML Authentication con Microsoft Entra ID, puede hacer lo siguiente:

Controlar en Microsoft Entra ID quién tiene acceso a RStudio Connect SAML Authentication.
Permitir que los usuarios puedan iniciar sesión automáticamente en RStudio Connect SAML Authentication con sus cuentas de Microsoft Entra.
Administre sus cuentas en una ubicación central.

Requisitos previos

Para configurar la integración de Microsoft Entra con RStudio Connect SAML Authentication, necesita los siguientes elementos:

Una suscripción a Microsoft Entra. Si no tiene un entorno de Microsoft Entra, puede obtener una cuenta gratuita.
RStudio Connect SAML Authentication. Hay una evaluación gratuita de 45 días.

Descripción del escenario

En este tutorial se configura y prueba el inicio de sesión único de Microsoft Entra en un entorno de prueba.

RStudio Connect SAML Authentication admite el inicio de sesión único iniciado por SP e IDP.
RStudio Connect SAML Authentication admite el aprovisionamiento de usuarios Just In Time.

Adición de RStudio Connect SAML Authentication desde la galería

Para configurar la integración de RStudio Connect SAML Authentication con Microsoft Entra ID, debe agregar RStudio Connect SAML Authentication desde la galería a la lista de aplicaciones SaaS administradas.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>Nueva aplicación.
En la sección Agregar desde la galería, escriba RStudio Connect SAML Authentication en el cuadro de búsqueda.
Seleccione RStudio Connect SAML Authentication del panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega al inquilino.

Si lo deseas, puedes usar también el asistente para la configuración de aplicaciones empresariales. En este asistente puedes agregar una aplicación al inquilino, agregar usuarios o grupos a la aplicación y asignar roles, así como recorrer la configuración de SSO. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra para RStudio Connect SAML Authentication

Configure y pruebe el inicio de sesión único de Microsoft Entra con RStudio Connect SAML Authentication usando un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es necesario establecer una relación de vínculo entre un usuario de Microsoft Entra y el usuario correspondiente de RStudio Connect SAML Authentication.

Para configurar y probar el inicio de sesión único de Microsoft Entra con RStudio Connect SAML Authentication, lleve a cabo los siguientes pasos:

Configuración del inicio de sesión único de Microsoft Entra, para que los usuarios puedan utilizar esta característica.
1. Cree un usuario de prueba de Microsoft Entra para probar el inicio de sesión único de Microsoft Entra con Britta Simon.
2. Asigne el usuario de prueba de Microsoft Entra para que Britta Simon pueda usar el inicio de sesión único de Microsoft Entra.
Configuración del inicio de sesión único en RStudio Connect SAML Authentication : para configurar el inicio de sesión único en la aplicación.
1. Cree un usuario de prueba en RStudio Connect SAML Authentication para tener un homólogo de Britta Simon en RStudio Connect SAML Authentication vinculado a la representación de usuario de Microsoft Entra.
Prueba del inicio de sesión único : para comprobar si la configuración funciona.

Configuración del inicio de sesión único de Microsoft Entra

Siga estos pasos para habilitar el SSO de Microsoft Entra.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>RStudio Connect SAML Authentication>Inicio de sesión único.
En la página Seleccione un método de inicio de sesión único, elija SAML.
En la página Configuración del inicio de sesión único con SAML, haga clic en el icono de lápiz de Configuración básica de SAML para editar la configuración.
En la sección Configuración básica de SAML, si desea configurar la aplicación en modo iniciado por IDP, realice los siguientes pasos, y sustituya <example.com> por el puerto y la dirección del servidor de RStudio Connect SAML Authentication:

a. En el cuadro de texto Identificador, escriba una dirección URL con el patrón siguiente: https://<example.com>/__login__/saml

b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://<example.com>/__login__/saml/acs
Haga clic en Establecer direcciones URL adicionales y siga este paso si desea configurar la aplicación en el modo iniciado por SP:

En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://<example.com>/

Nota:

Estos valores no son reales. Actualice estos valores con los valores reales de Identificador, URL de respuesta y URL de inicio de sesión. Se determinan a partir de la dirección del servidor de RStudio Connect SAML Authentication (https://example.com en los ejemplos anteriores). Póngase en contacto con el equipo de soporte técnico de RStudio Connect SAML Authentication si tiene algún problema. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML.
La aplicación RStudio Connect SAML Authentication espera las aserciones de SAML en un formato específico, lo cual requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token SAML. La siguiente captura de pantalla muestra la lista de atributos predeterminados, donde nameidentifier se asigna con user.userprincipalname. La aplicación RStudio Connect SAML Authentication espera que nameidentifier se corresponda con user.mail, por lo que debe editar la asignación de atributos; para ello, haga clic en el icono Edit (Editar) y cambie la asignación.
En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, haga clic en el botón de copia para copiar Dirección URL de metadatos de federación de aplicación y guárdela en su equipo.

Cree un usuario de prueba de Microsoft Entra

En esta sección, se crea un usuario llamado B.Simon.

Inicia sesión en el Centro de administración de Microsoft Entra al menos como Administrador de usuario.
Ve a Identidad>Usuarios>Todos los usuarios.
Selecciona Nuevo usuario>Crear nuevo usuario, en la parte superior de la pantalla.
En las propiedades del usuario, sigue estos pasos:
1. En el campo Nombre para mostrar, escribe B.Simon.
2. En el campo Nombre principal de usuario, escribe username@companydomain.extension. Por ejemplo, B.Simon@contoso.com.
3. Activa la casilla Mostrar contraseña y, después, anota el valor que se muestra en el cuadro Contraseña.
4. Selecciona Revisar + crear.
Selecciona Crear.

Asignación del usuario de prueba de Microsoft Entra

En esta sección va a permitir que B.Simon acceda a RStudio Connect SAML Authentication mediante el inicio de sesión único de Azure.

Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>RStudio Connect SAML Authentication.
En la página de información general de la aplicación, seleccione Usuarios y grupos.
Selecciona Agregar usuario o grupo y luego, en el cuadro de diálogo Agregar asignación, selecciona Usuarios y grupos.
1. En el cuadro de diálogo Usuarios y grupos, selecciona B.Simon de la lista de usuarios y haz clic en el botón Seleccionar de la parte inferior de la pantalla.
2. Si esperas que se asigne un rol a los usuarios, puedes seleccionarlo en la lista desplegable Seleccionar un rol. Si no se ha configurado ningún rol para esta aplicación, verás seleccionado el rol "Acceso predeterminado".
3. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

Configuración del inicio de sesión único en RStudio Connect SAML Authentication

Para configurar el inicio de sesión único en RStudio Connect SAML Authentication, necesita usar la dirección URL de metadatos de federación de aplicación y la dirección del servidor utilizadas anteriormente. Esto se hace en el archivo de configuración de RStudio Connect SAML Authentication de /etc/rstudio-connect.rstudio-connect.gcfg.

Este es un archivo de configuración de ejemplo:

[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, el perfil establece NameIDFormat en persistente, entre otros valores, e invalida los demás atributos especificados que se definen en el archivo de configuración.

Esto se convierte en un problema si quiere crear un usuario con antelación mediante la API de RStudio Connect y aplicar permisos antes de que el usuario inicie sesión por primera vez. NameIDFormat debe establecerse en emailAddress o en otro identificador único porque, cuando está establecido en persistente, se aplica un hash al valor y no se sabe cuál es el valor con antelación. Por lo tanto, la API no funcionará. API para crear un usuario para SAML: https://docs.rstudio.com/connect/api/#post-/v1/users.

Puede que le interese incluir esto en el archivo de configuración en esta situación:

[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

Almacene la Dirección del servidor en el valor Server.Address, y la Dirección URL de metadatos de federación de aplicación en el valor SAML.IdPMetaData. Tenga en cuenta que esta configuración de ejemplo usa una conexión HTTP sin cifrar, mientras que Microsoft Entra requiere el uso de una conexión HTTPS cifrada. Puede usar un proxy inverso delante de RStudio Connect SAML Authentication o configurar RStudio Connect para que use HTTPS directamente.

Si tiene problemas con la configuración, puede leer la guía del administrador de RStudio Connect SAML Authentication o enviar un correo electrónico al equipo de soporte técnico de RStudio para obtener ayuda.

Creación de un usuario de prueba en RStudio Connect SAML Authentication

En esta sección se crea un usuario llamado B.Simon en RStudio Connect SAML Authentication. RStudio Connect SAML Authentication admite el aprovisionamiento Just-In-Time, habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si el usuario no existe en la aplicación RStudio Connect SAML Authentication, se crea al intentar acceder a ella.

Prueba de SSO

En esta sección va a probar la configuración de inicio de sesión único de Microsoft Entra con las siguientes opciones.

Iniciado por SP:

Haga clic en Probar esta aplicación; esta acción le redirigirá a la dirección URL de inicio de sesión de autenticación RStudio Connect SAML, donde puede comenzar el flujo de inicio de sesión.
Vaya directamente a la dirección URL de inicio de sesión de RStudio Connect SAML Authentication e inicie el flujo de inicio de sesión desde allí.

Iniciado por IDP:

Haga clic en Probar esta aplicación en Azure Portal; debería iniciar sesión automáticamente en la instancia de autenticación RStudio Connect SAML para la que configuró el inicio de sesión único.

También puede usar Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al hacer clic en el icono de RStudio Connect SAML Authentication en Aplicaciones, si tiene la configuración del modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para iniciar el flujo de inicio de sesión y, si tiene la configuración del modo IDP, debería iniciar sesión automáticamente en la instancia de RStudio Connect SAML Authentication para la que configuró el inicio de sesión único. Para más información, vea Aplicaciones en Microsoft Entra.

Pasos siguientes

Una vez configurada la aplicación RStudio Connect SAML Authentication, podrá aplicar el control de sesión, que protege a su organización en tiempo real frente a la filtración e infiltración de información confidencial. El control de sesión procede del acceso condicional. Aprende a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.

Compartir a través de