Condividi tramite

Integrazione di Microsoft Entra SSO con FTAPI

  • Articolo

Questa esercitazione descrive come integrare FTAPI con Microsoft Entra ID. Integrando FTAPI con Microsoft Entra ID, è possibile:

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

Prerequisiti

Per integrare Microsoft Entra ID con FTAPI, è necessario:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di FTAPI abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

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

  • FTAPI supporta l'accesso SSO avviato da SP .
  • FTAPI supporta il provisioning utenti JIT .

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

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare FTAPI nella casella di ricerca.
  4. Selezionare FTAPI nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app, assegnare ruoli e seguire anche 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 FTAPI

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

Per configurare e testare l'accesso SSO di Microsoft Entra con FTAPI, 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 ID : per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra ID : per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di FTAPI: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di FTAPI: per avere una controparte di B.Simon in FTAPI collegata alla rappresentazione dell'ID Di Microsoft Entra dell'utente.
  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 Microsoft Entra SSO nell'interfaccia di amministrazione di Microsoft Entra.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare a Applicazioni di identità>Applicazioni>aziendali>FTAPI>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.

    Screenshot shows how to edit Basic SAML Configuration.

  5. Nella sezione Configurazione SAML di base seguire questa procedura:

    a. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    b. Nella casella di testo URL di risposta digitare un URL nel formato seguente: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    c. Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    Nota

    Poiché questi non sono i valori reali, è necessario aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Per ottenere questi valori, contattare il team di supporto di FTAPI. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base nell'interfaccia di amministrazione di Microsoft Entra.

  6. L'applicazione FTAPI 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.

    image

  7. Oltre a quanto sopra, l'applicazione FTAPI prevede il passaggio di altri attributi nella risposta SAML, come illustrato di seguito. Anche questi attributi vengono prepopolati, ma è possibile esaminarli in base ai requisiti.

    Nome Attributo di origine
    phonenumber user.telephonenumber
    companyname user.companyname
    ruolo user.assignedroles

    Nota

    Fare clic qui per sapere come configurare il ruolo in Microsoft Entra ID.

  8. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare il file XML dei metadati della federazione e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    Screenshot shows the Certificate download link.

  9. Nella sezione Configura FTAPI copiare gli URL appropriati in base alle esigenze.

    Screenshot shows to copy configuration URLs.

Creare un utente di test di Microsoft Entra ID

In questa sezione verrà creato un utente di test nell'interfaccia di amministrazione di Microsoft Entra di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un utente Amministrazione istrator.
  2. Passare a Utenti>identità>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle proprietà Utente seguire questa procedura:
    1. Nel campo Nome visualizzato immettere 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 ID

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra concedendole l'accesso a FTAPI.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>FTAPI.
  3. Nella pagina di 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 FTAPI

Per configurare l'accesso Single Sign-On sul lato FTAPI, è necessario inviare il file XML metadati federazione scaricato e gli URL appropriati copiati dall'interfaccia di amministrazione di Microsoft Entra al team di supporto di FTAPI. La configurazione viene eseguita in modo che la connessione SSO SAML sia impostata correttamente su entrambi i lati.

Creare l'utente di test di FTAPI

In questa sezione viene creato un utente di nome Britta Simon in FTAPI. FTAPI 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 FTAPI, ne viene creato uno nuovo dopo l'autenticazione.

Testare l'accesso 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) nell'interfaccia di amministrazione di Microsoft Entra. Verrà eseguito il reindirizzamento all'URL di accesso FTAPI in cui è possibile avviare il flusso di accesso.

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

  • È possibile usare App personali Microsoft. Quando si fa clic sul riquadro FTAPI nella App personali, verrà eseguito il reindirizzamento all'URL di accesso FTAPI. Per altre informazioni su App personali, vedere l'introduzione ad App personali.

Passaggi successivi

Dopo aver configurato FTAPI, è 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 sessione con app Microsoft Defender per il cloud.