Condividi tramite


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

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

  • Controllare in Microsoft Entra ID chi può accedere a TextMagic.
  • Consenti ai tuoi utenti di accedere automaticamente a TextMagic 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 TextMagic con Single Sign-On (SSO) abilitato.

Descrizione dello scenario

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

  • TextMagic supporta l'SSO avviato dal IDP.

  • TextMagic supporta il provisioning utenti Just In Time.

Nota

Dal momento che l'identificatore di questa applicazione è un valore stringa fisso, è possibile configurare una sola istanza in un solo tenant.

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

  1. Accedi al Centro di amministrazione di Microsoft Entra almeno come Amministratore delle applicazioni cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare TextMagic nella casella di ricerca.
  4. Selezionare TextMagic nel pannello dei risultati e quindi aggiungere l'app. Attendere pazientemente alcuni secondi affinché l'app venga aggiunta al tuo tenant.

In alternativa, è anche possibile usare Configurazione guidata dell'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 TextMagic

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

Per configurare e testare l'accesso SSO di Microsoft Entra con TextMagic, 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 B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra per abilitare B.Simon ad utilizzare l'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di TextMagic: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare un utente di test in TextMagic - per creare una controparte di B.Simon in TextMagic che sia collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare il Single Sign-On (SSO) di Microsoft Entra

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

  1. Accedere al Centro amministrativo di Microsoft Entra come almeno un Amministratore Applicazioni Cloud.

  2. Passare ad Identità>Applicazioni>Applicazioni aziendali>TextMagic>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 eseguire il passaggio seguente:

    Nella casella di testo Identificatore digitare l'URL: https://my.textmagic.com/saml/metadata

  6. L'applicazione TextMagic 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 TextMagic prevede che nameidentifier sia associato a user.mail, di conseguenza è necessario modificare il mapping dell'attributo. A questo scopo, fare clic sull'icona Modifica e cambiare il mapping.

    image

  7. Oltre quelli elencati in precedenza, l'applicazione TextMagic prevede il passaggio di altri attributi nella risposta SAML. Tali attributi sono indicati di seguito. Anche questi attributi vengono precompilati, ma è possibile esaminarli in base alle tue esigenze.

    Nome Attributo di origine Namespace
    azienda user.companyname https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    nome nome.utente https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    lastName utente.cognome https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    telefono utente.numeroDiTelefono https://schemas.xmlsoap.org/ws/2005/05/identity/claims
  8. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare Certificato (Base64) e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    Link per il download del certificato

  9. Nella sezione Configura TextMagic 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. 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 principale utente, inserire 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, permetterai a B.Simon di utilizzare il single sign-on concedendole l'accesso a TextMagic.

  1. Accedi al centro di amministrazione di Microsoft Entra con almeno il ruolo di Amministratore di applicazioni cloud.
  2. Passare a Identità>Applicazioni>Applicazioni aziendali>TextMagic.
  3. Nella pagina di panoramica dell'app trovare la sezione Gestione e selezionare Utenti e gruppi.
  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.
  5. 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.
  6. Se si prevede un valore di ruolo nell'asserzione SAML, nella finestra di dialogo Selezionare un ruolo selezionare il ruolo appropriato per l'utente dall'elenco e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.
  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'autenticazione Single Sign-On di TextMagic

  1. In un'altra finestra del Web browser accedere al sito aziendale di TextMagic come amministratore

  2. Selezionare Account settings (Impostazioni account) sotto il nome utente.

    Screenshot che mostra l'opzione Impostazioni dell'account selezionata dall'utente.

  3. Fare clic sulla scheda Single Sign-On (SSO) e completare i campi seguenti:

    Screenshot che mostra la scheda Single Sign-On in cui è possibile immettere i valori indicati.

    a. Nella casella di testo Identity provider Entity ID: incollare il valore dell'Identificatore di Microsoft Entra.

    b. Nella casella di testo "Identity provider SSO URL": incollare il valore di Login URL.

    c. Nella casella di testo Identity provider SLO URL (URL SLO provider di identità): incollare il valore di URL di disconnessione.

    d. Aprire nel Blocco note il certificato con codifica Base 64 scaricato dal portale di Azure, copiarne il contenuto negli Appunti e incollarlo nella casella di testo Public x509 certificate (Certificato X509 pubblico).

    e. Fare clic su Salva.

Creare l'utente di test di TextMagic

In questa sezione viene creato un utente di nome B.Simon in TextMagic. TextMagic supporta il provisioning utente just-in-time, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in TextMagic, 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.

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

  • È possibile usare App personali Microsoft. Quando fai clic sul riquadro di TextMagic nelle App personali, dovresti essere automaticamente connesso a TextMagic per cui hai configurato l'SSO. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Dopo aver configurato TextMagic, è 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.