Condividi tramite

Esercitazione: Integrazione dell'accesso SSO di Microsoft Entra con RStudio Connect SAML Authentication

  • Articolo

Questa esercitazione descrive come integrare RStudio Connect SAML Authentication con Microsoft Entra ID. Integrando RStudio Connect SAML Authentication con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a RStudio Connect SAML Authentication.
  • Abilitare gli utenti per l'accesso automatico a RStudio Connect SAML Authentication con gli account Microsoft Entra personali.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Per configurare l'integrazione di Microsoft Entra con RStudio Connect SAML Authentication, sono necessari gli elementi seguenti:

Descrizione dello scenario

In questa esercitazione, viene configurato e testato l'accesso Single Sign-On di Microsoft Entra in un ambiente di testing.

  • RStudio Connect SAML Authentication supporta l'accesso SSO avviato da SP e IDP .

  • RStudio Connect SAML Authentication supporta il provisioning utenti JIT .

Per configurare l'integrazione di RStudio Connect SAML Authentication in Microsoft Entra ID, è necessario aggiungere RStudio Connect SAML Authentication dalla raccolta all'elenco di app SaaS gestite.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare RStudio Connect SAML Authentication nella casella di ricerca.
  4. Selezionare RStudio Connect SAML Authentication nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare Configurazione guidata app aziendali. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per RStudio Connect SAML Authentication

Configurare e testare l'accesso SSO di Microsoft Entra con RStudio Connect SAML Authentication usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in RStudio Connect SAML Authentication.

Per configurare e testare l'accesso SSO di Microsoft Entra con RStudio Connect SAML Authentication, seguire questa procedura:

  1. Configurare l'accesso Single Sign-On di Microsoft Entra per consentire agli utenti di usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra: per testare l'accesso Single Sign-On di Microsoft Entra con Britta Simon.
    2. Assegnare l'utente di test di Microsoft Entra: per abilitare Britta Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di RStudio Connect SAML Authentication: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di RStudio Connect SAML Authentication: per avere una controparte di Britta Simon in RStudio Connect SAML Authentication collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>RStudio Connect SAML Authentication>Single Sign-On.

  3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

  4. Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita per modificare le impostazioni di Configurazione SAML di base.

    Modificare la configurazione SAML di base

  5. Nella sezione Configurazione SAML di base seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da IDP, sostituendo <example.com> con l'indirizzo e la porta del proprio server RStudio Connect SAML Authentication:

    a. Nella casella di testo Identificatore digitare un URL nel formato seguente: https://<example.com>/__login__/saml

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://<example.com>/__login__/saml/acs

  6. Fare clic su Impostare URL aggiuntivi e seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da SP:

    Nella casella di testo URL accesso digitare un URL nel formato seguente: https://<example.com>/

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Tali valori si possono ricavare dall'indirizzo del server RStudio Connect SAML Authentication (https://example.com negli esempi precedenti). Per eventuali problemi, contattare il team di supporto di RStudio Connect SAML Authentication. È anche possibile fare riferimento ai criteri di cui alla sezione Configurazione SAML di base.

  7. L'applicazione RStudio Connect SAML Authentication prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Lo screenshot seguente illustra l'elenco degli attributi predefiniti in cui nameidentifier è associato a user.userprincipalname. L'applicazione RStudio Connect SAML Authentication prevede il mapping di nameidentifier a user.mail, di conseguenza per modificare il mapping degli attributi, è necessario fare clic sull'icona Modifica.

    image

  8. Nella pagina Configura l'accesso Single Sign-On con SAML, nella sezione Certificato di firma SAML, fare clic sul pulsante Copia per copiare l'URL dei metadati di federazione dell'app e salvarlo nel computer.

    Collegamento di download del certificato

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno come Amministratore utenti.
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente>Crea nuovo utente nella parte superiore della schermata.
  4. In Proprietà utente seguire questa procedura:
    1. Nel campo Nome visualizzato inserire B.Simon.
    2. Nel campo Nome entità utente, immettere username@companydomain.extension. Ad esempio: B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On concedendole l'accesso a RStudio Connect SAML Authentication.

  1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>RStudio Connect SAML Authentication.
  3. Nella pagina della panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
    1. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
    2. Se si prevede che agli utenti venga assegnato un ruolo, è possibile selezionarlo nell'elenco a discesa Selezionare un ruolo. Se per questa app non è stato configurato alcun ruolo, il ruolo selezionato è "Accesso predefinito".
    3. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di RStudio Connect SAML Authentication

Per configurare l'accesso Single Sign-On per RStudio Connect SAML Authentication, è necessario usare l'URL dei metadati di federazione dell'app e l'indirizzo del server usati sopra. Questa operazione viene effettuata nel file di configurazione di RStudio Connect SAML Authentication in /etc/rstudio-connect.rstudio-connect.gcfg.

Ecco un file di configurazione di esempio:

[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

Se IdPAttributeProfile = azure, il profilo imposta NameIDFormat su permanente, tra le altre impostazioni e sostituisce gli altri attributi specificati definiti nel file di configurazione.

Questo diventa un problema se si vuole creare un utente in anticipo usando l'API RStudio Connect e applicare le autorizzazioni prima dell'accesso dell'utente alla prima volta. NameIDFormat deve essere impostato su emailAddress o su un altro identificatore univoco perché quando è impostato su permanente, il valore viene sottoposto a hashing e non si sa quale valore è in anticipo. Pertanto, l'uso dell'API non funzionerà. API per la creazione di un utente per SAML: https://docs.rstudio.com/connect/api/#post-/v1/users

È quindi consigliabile avere questo valore nel file di configurazione in questa situazione:

[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

Archiviare l'indirizzo del server nel valore Server.Address e l'URL dei metadati di federazione dell'app nel valore SAML.IdPMetaData. Si noti che questa configurazione di esempio usa una connessione HTTP non crittografata, mentre Microsoft Entra ID richiede l'uso di una connessione HTTPS crittografata. È possibile usare un proxy inverso prima di RStudio Connect SAML Authentication o configurare RStudio Connect SAML Authentication in modo da usare direttamente HTTPS.

In caso di problemi con la configurazione, è possibile vedere RStudio Connect SAML Authentication Admin Guide (Guida dell'amministratore di RStudio Connect SAML Authentication) o inviare un messaggio di posta elettronica al team di supporto di RStudio per richiedere assistenza.

Creare l'utente di test di RStudio Connect SAML Authentication

In questa sezione viene creato un utente di nome Britta Simon in RStudio Connect SAML Authentication. RStudio Connect SAML Authentication supporta il provisioning utenti JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in RStudio Connect SAML Authentication, ne viene creato uno nuovo quando si prova ad accedere a RStudio Connect SAML Authentication.

Testare l'accesso SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

Avviato da SP:

  • Fare clic su Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso di RStudio Connect SAML Authentication , in cui è possibile avviare il flusso di accesso.

  • Passare direttamente all'URL di accesso di RStudio Connect SAML Authentication e avviare il flusso di accesso da questa posizione.

Avviato da IDP:

  • Fare clic su Test this application (Testa questa applicazione) e si dovrebbe accedere automaticamente all'istanza di RStudio Connect SAML Authentication per cui si è configurato l'accesso SSO.

È anche possibile usare App personali Microsoft per testare l'applicazione in qualsiasi modalità. Quando si fa clic sul riquadro di RStudio Connect SAML Authentication nel App personali, se configurato in modalità SP, si dovrebbe essere reindirizzati alla pagina di accesso dell'applicazione per avviare il flusso di accesso e, se configurato in modalità IDP, si dovrebbe accedere automaticamente all'autenticazione SAML di RStudio Connect per cui si è configurato l'accesso SSO. Per altre informazioni vedere App personali di Microsoft Entra.

Passaggi successivi

Dopo aver configurato RStudio Connect SAML Authentication, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo della sessione con Microsoft Defender for Cloud Apps.