Condividi tramite


Integrazione Single Sign-On (SSO) di Microsoft Entra con Onshape

In questo articolo si apprenderà come integrare Onshape con Microsoft Entra ID. Integrando Onshape con Microsoft Entra ID, è possibile:

  • Controllare in Microsoft Entra ID chi può accedere a Onshape.
  • Consenti agli utenti di accedere automaticamente a Onshape con i loro account Microsoft Entra.
  • Gestire gli account in un'unica posizione centrale.

Prerequisiti

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

  • Abbonamento SSO abilitato per Onshape.

Descrizione dello scenario

In questo articolo viene configurato e testato l'accesso SSO di Microsoft Entra in un ambiente di test.

  • Onshape supporta SSO avviato da SP e IDP
  • Onshape supporta provisioning utenti JIT

Nota

L'identificatore di questa applicazione è un valore stringa fisso, quindi è possibile configurare una sola istanza in un tenant.

Per configurare l'integrazione di Onshape in Microsoft Entra ID, è necessario aggiungere Onshape dalla raccolta al proprio elenco di app SaaS gestite.

  1. Collegati al centro di amministrazione di Microsoft Entra come almeno un Amministratore di applicazioni cloud.
  2. Passare a Identity>Applications>Enterprise applications>New application.
  3. Nella sezione Aggiungi dalla raccolta digita Onshape nella casella di ricerca.
  4. Selezionare Onshape nel pannello dei risultati e quindi aggiungere l'app. Attendere qualche secondo mentre l'app viene aggiunta nel tenant.

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

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Onshape

Configurare e testare l'accesso SSO di Microsoft Entra con Onshape 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 Onshape.

Per configurare e testare l'accesso SSO di Microsoft Entra con Onshape, seguire questa procedura:

  1. Configura Microsoft Entra SSO: 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 B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra - per consentire a B.Simon di utilizzare il single sign-on di Microsoft Entra.
  2. Configure Onshape SSO : per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. utente di test di Create Onshape: per avere una controparte di B.Simon in Onshape collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare SSO: per verificare se la configurazione funziona.

Configurare Single Sign-On di Microsoft Entra

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

  1. Accedere al centro di amministrazione di Microsoft Entra come almeno un Amministratore di Applicazioni Cloud .

  2. Passare a Identity>Applications>Enterprise applications>Onshape>Single Sign-On.

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

  4. Se viene richiesto di salvare l'impostazione di Single Sign-On, selezionare .

  5. L'applicazione Onshape 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 mostra l'elenco degli attributi predefiniti.

    immagine

  6. Oltre a quanto sopra, l'applicazione Onshape prevede il passaggio di altri attributi indicati di seguito nella risposta SAML. Questi attributi sono anche pre-popolati, ma è possibile esaminarli in base alle tue esigenze.

    Nome Attributo di origine
    nome utente.nomeData
    lastName user.surname
    companyName <COMPANY_NAME>

    Nota

    È necessario modificare il valore dell'attributo companyName al prefisso di dominio dell'organizzazione Onshape. Ad esempio, se si accede all'applicazione Onshape usando un URL come https://acme.onshape.com, il prefisso di dominio è acme. Il valore dell'attributo deve essere solo il prefisso, non l'intero nome DNS.

  7. Nella pagina Configurare l'accesso Single Sign-On con SAML, nella sezione Certificato di firma SAML, individuare Metadati Federazione XML e selezionare Download per scaricare il certificato e salvarlo nel computer.

    Collegamento di download del certificato

  8. Nella sezione Configura Onshape copiare gli URL appropriati in base alle esigenze.

    Copiare gli URL di configurazione

Creare un utente di test di Microsoft Entra

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

  1. Accedi al centro di amministrazione di Microsoft Entra come almeno un utente amministratore .
  2. Passare a Identità>Utenti>Tutti gli utenti.
  3. Selezionare Nuovo utente>Crea nuovo utente, nella parte superiore della schermata.
  4. Nelle proprietà User seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo Nome principale utente, immettere il username@companydomain.extension. Ad esempio, B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi annotare il valore visualizzato nella casella Password.
    4. Seleziona Rivedi e crea.
  5. Selezionare Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione abiliterai B.Simon a usare il Single Sign-On concedendogli l'accesso a Onshape.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra almeno un amministratore di applicazioni cloud .
  2. Passare a Identity>Applications>Enterprise applications>Onshape.
  3. Nella pagina di panoramica dell'app selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente/gruppo, quindi selezionare Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
    1. Nella finestra di dialogo utenti e gruppi selezionare B.Simon dall'elenco Utenti, quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
    2. Se si prevede che un ruolo venga assegnato agli utenti, è possibile selezionarlo dall'elenco a discesa Selezionare un ruolo. Se non è stato configurato alcun ruolo per questa app, viene visualizzato il ruolo "Accesso predefinito" selezionato.
    3. Nella finestra di dialogo Aggiungi assegnazione, fare clic sul pulsante Assegna.

Configurare l'SSO di Onshape

Per informazioni su come configurare l'accesso Single Sign-On nel sistema Onshape, consultare Integrazione con Microsoft Entra ID.

Creare l'utente di test di Onshape

In questa sezione viene creato un utente di nome Britta Simon in Onshape. Onshape supporta il provisioning just-in-time degli utenti, abilitato per impostazione predefinita. In questa sezione non è presente alcun elemento di azione. Se non esiste già un utente in Onshape, ne viene creato uno nuovo dopo l'autenticazione.

Test 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 Prova questa applicazione, verrai reindirizzato all'URL di accesso Onshape per avviare il flusso di login.

  • Passare direttamente all'URL di accesso di Onshape e avviare il flusso di accesso da questa posizione.

IDP avviato:

  • Fare clic su Prova questa applicazionee dovresti accedere automaticamente a Onshape per cui hai configurato il Single Sign-On.

È anche possibile usare Microsoft My Apps per testare l'applicazione in qualsiasi modalità. Quando fai clic sul riquadro Onshape nelle App personali, se è configurato in modalità SP, verrai reindirizzato alla pagina di accesso dell'applicazione per avviare il flusso di accesso. Se è configurato in modalità IDP, accederai automaticamente all'istanza di Onshape per cui hai configurato l'accesso SSO. Per altre informazioni sulle app personali, vedere Introduzione alle app personali.

Dopo aver configurato Onshape, è 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 si estende dall'accesso condizionale. Informazioni su come applicare il controllo sessione con Microsoft Defender for Cloud Apps.