Distribuire un connettore per archiviare i dati di Twitter

Questo articolo descrive il processo di distribuzione di un connettore che usa il servizio di importazione di Microsoft 365 per importare dati dall'account Twitter dell'organizzazione a Microsoft 365. Per una panoramica generale di questo processo e un elenco dei prerequisiti necessari per distribuire un connettore Twitter, vedere Configurare un connettore per archiviare i dati di Twitter.

Passaggio 1: Creare un'app in Microsoft Entra ID

  1. Passare a https://portal.azure.com e accedere con le credenziali di un account amministratore globale.

    Importante

    Microsoft consiglia di usare i ruoli con il minor numero di autorizzazioni. Ridurre al minimo il numero di utenti con il ruolo Amministratore globale consente di migliorare la sicurezza per l'organizzazione. Altre informazioni sui ruoli e le autorizzazioni di Microsoft Purview.

    Screenshot della pagina di accesso portale di Azure per le credenziali di amministratore globale.

  2. Nel riquadro di spostamento a sinistra selezionare Microsoft Entra ID.

    Screenshot del riquadro di spostamento a sinistra con Microsoft Entra ID selezionato nella portale di Azure.

  3. Nel riquadro di spostamento a sinistra selezionare Registrazioni app (anteprima) e quindi selezionare Nuova registrazione.

    Screenshot della pagina Microsoft Entra ID Registrazioni app con l'opzione Nuova registrazione.

  4. Registrare l'applicazione. In URI di reindirizzamento (facoltativo) selezionare Web nell'elenco a discesa tipo di applicazione e quindi digitare https://portal.azure.com nella casella per l'URI.

    Screenshot delle impostazioni di registrazione dell'app che mostrano l'URI di reindirizzamento configurato per il portale di Azure.

  5. Copiare l'ID applicazione (client) e l'ID directory (tenant) e salvarli in un file di testo o in un altro percorso sicuro. Questi ID verranno usati nei passaggi successivi.

    Screenshot della pagina di panoramica dell'app che mostra l'ID applicazione (client) e l'ID directory (tenant).

  6. Passare a Certificati & segreti per la nuova app e in Segreti client selezionare Nuovo segreto client.

    Screenshot della pagina Certificati & segreti con l'opzione per creare un nuovo segreto client.

  7. Creare un nuovo segreto. Nella casella descrizione digitare il segreto e quindi selezionare un periodo di scadenza.

    Screenshot del modulo del segreto client con il campo descrizione e le opzioni del periodo di scadenza.

  8. Copiare il valore del segreto e salvarlo in un file di testo o in un altro percorso di archiviazione. Si tratta del segreto dell'applicazione Microsoft Entra usato nei passaggi successivi.

    Screenshot del valore del segreto client visualizzato per la copia e il salvataggio.

Passaggio 2: Distribuire il servizio Web del connettore da GitHub all'account Azure

  1. Passare a questo sito GitHub e selezionare Distribuisci in Azure.

    Screenshot della pagina del repository GitHub con il pulsante Distribuisci in Azure evidenziato.

  2. Dopo aver selezionato Distribuisci per Azure, si viene reindirizzati a un portale di Azure con una pagina modello personalizzata. Compilare i dettagli informazioni di base e impostazioni e quindi selezionare Acquista.

    Screenshot della pagina portale di Azure modello personalizzato con i campi Nozioni di base e Impostazioni per la distribuzione del connettore.

    • Sottoscrizione: Selezionare la sottoscrizione Azure in cui si vuole distribuire il servizio Web del connettore Twitter.
    • Gruppo di risorse: Selezionare o creare un nuovo gruppo di risorse. Un gruppo di risorse è un contenitore che contiene le risorse correlate per una soluzione Azure.
    • Posizione: Selezionare una posizione.
    • Nome app Web: Specificare un nome univoco per l'app Web del connettore. Il nome deve avere una lunghezza compresa tra 3 e 18 caratteri. Questo nome viene usato per creare l'URL del servizio app Azure, ad esempio se si specifica il nome dell'app Web twitterconnector, l'URL del servizio app Azure viene twitterconnector.azurewebsites.net.
    • tenantId: ID tenant dell'organizzazione di Microsoft 365 copiato dopo la creazione dell'app connettore Twitter in Microsoft Entra ID nel passaggio 1.
    • APISecretKey: È possibile digitare qualsiasi valore come segreto. Questo valore viene usato per accedere all'app Web del connettore nel passaggio 5.

  3. Quando la distribuzione ha esito positivo, la pagina ha un aspetto simile allo screenshot seguente:

    Screenshot del portale di Azure che mostra una distribuzione corretta del servizio Web del connettore.

Passaggio 3: Creare l'app Twitter

  1. Passare a https://developer.twitter.com, accedere con le credenziali per l'account sviluppatore per l'organizzazione e selezionare App.

    Screenshot della home page del portale per sviluppatori di Twitter con l'opzione App.

  2. Selezionare Crea un'app.

    Screenshot della pagina App del portale per sviluppatori di Twitter con l'opzione per creare una nuova app.

  3. In Dettagli app immettere informazioni sull'applicazione.

    Screenshot del modulo dei dettagli dell'app Twitter per l'immissione delle informazioni sull'applicazione.

  4. Nel dashboard per sviluppatori di Twitter selezionare l'app appena creata e quindi selezionare Dettagli.

    Screenshot del dashboard per sviluppatori di Twitter che mostra i dettagli dell'app e l'ID app.

  5. Nella scheda Chiavi e token , in Chiavi API consumer, copiare sia la chiave API che la chiave privata API e salvarle in un file di testo o in un altro percorso di archiviazione. Selezionare quindi Crea per generare un token di accesso e un segreto del token di accesso e copiarli in un file di testo o in un altro percorso di archiviazione.

    Screenshot della pagina Chiavi e token dell'app per sviluppatori di Twitter che mostra la chiave privata dell'API.

    Selezionare Crea per generare un token di accesso e un segreto del token di accesso e copiarli in un file di testo o in un altro percorso di archiviazione.

  6. Selezionare la scheda Autorizzazioni e configurare le autorizzazioni come illustrato nello screenshot seguente:

    Screenshot della scheda Autorizzazioni dell'app Twitter con le autorizzazioni necessarie configurate.

  7. Dopo aver salvato le impostazioni di autorizzazione, selezionare la scheda Dettagli app e quindi selezionare Modifica > dettagli modifica.

    Screenshot della pagina dei dettagli dell'app Twitter con l'opzione Modifica dettagli selezionata.

  8. Completare le attività seguenti:

    • Selezionare la casella di controllo per consentire all'app connettore di accedere a Twitter.
    • Aggiungere l'URI di reindirizzamento OAuth usando il formato seguente: <connectorserviceuri>/Views/TwitterOAuth, dove il valore di connectorserviceuri è l'URL del servizio app Azure per l'organizzazione.

    Screenshot delle impostazioni dell'app Twitter che mostrano l'autorizzazione di accesso abilitata e l'URI di reindirizzamento OAuth configurato.

L'app per sviluppatori Twitter è ora pronta per l'uso.

Passaggio 4: Configurare l'app Web del connettore

  1. Passare a https://<AzureAppResourceName>.azurewebsites.net (dove AzureAppResourceName è il nome della risorsa dell'app Azure denominata nel passaggio 2). La home page dell'app è simile allo screenshot seguente:

    Screenshot della home page dell'app Web del connettore ospitato Azure.

  2. Selezionare Configura per visualizzare una pagina di accesso.

    Screenshot della pagina di accesso dell'app Web del connettore aperta dall'opzione Configura.

  3. Nella casella ID tenant digitare o incollare l'ID tenant Microsoft Entra (ID directory (tenant) dalla registrazione dell'app Microsoft Entra. Nella casella password digitare o incollare il valore APISecretKey dalle impostazioni del modello di distribuzione Azure, quindi selezionare Imposta impostazioni di configurazione per visualizzare la pagina dei dettagli di configurazione.

    Screenshot della pagina di accesso con i campi ID tenant e chiave privata API.

  4. Immettere le impostazioni di configurazione seguenti:

    • Chiave api Twitter: Chiave API per l'applicazione Twitter creata nel passaggio 3.
    • Chiave privata api Twitter: Chiave privata API per l'applicazione Twitter creata nel passaggio 3.
    • Token di accesso di Twitter: Token di accesso creato nel passaggio 3.
    • Segreto del token di accesso di Twitter: Segreto del token di accesso creato nel passaggio 3.
    • Microsoft Entra ID applicazione: ID applicazione per l'app Microsoft Entra creata nel passaggio 1
    • Microsoft Entra Segreto applicazione: valore del segreto client dell'applicazione Microsoft Entra creato durante la registrazione dell'app in Microsoft Entra ID.

  5. Selezionare Salva per salvare le impostazioni del connettore.

Passaggio 5: Configurare un connettore Twitter

  1. Accedere al portale di Microsoft Purview.

  2. Selezionare Impostazioni>Connettori dati.

  3. Selezionare Connettori personali e quindi Aggiungi connettore.

  4. Nell'elenco selezionare Twitter.

  5. Nella pagina Condizioni del servizio selezionare Accetta.

  6. Nella pagina Aggiungi credenziali per l'app connettore immettere le informazioni seguenti e quindi selezionare Convalida connessione.

    • Nella casella Nome digitare un nome per il connettore, ad esempio l'handle della Guida di Twitter.
    • Nella casella URL connettore digitare o incollare l'URL del servizio app Azure.
    • Nella casella Password digitare o incollare il valore APISecretKey dalle impostazioni del modello di distribuzione Azure.
    • Nella casella APP AZURE ID digitare o incollare il valore dell'ID app applicazione Azure (detto anche ID client) ottenuto nel passaggio 1.

  7. Dopo aver convalidato la connessione, selezionare Avanti.

  8. Nella pagina Autorizza Microsoft 365 a importare dati digitare o incollare nuovamente APISecretKey e quindi selezionare Account di accesso app Web.

  9. Selezionare Login with Twitter (Accedi con Twitter).

  10. Nella pagina di accesso di Twitter accedere usando le credenziali per l'account Twitter dell'organizzazione. Dopo l'accesso, nella pagina Twitter viene visualizzato il messaggio seguente, "Processo connettore Twitter configurato correttamente".

  11. Selezionare Continua per completare la configurazione del connettore Twitter.

  12. Nella pagina Imposta filtri è possibile applicare un filtro all'importazione iniziale di elementi con una determinata età. Selezionare un'età, quindi selezionare Avanti.

  13. Nella pagina Scegli percorso di archiviazione digitare l'indirizzo di posta elettronica della cassetta postale di Microsoft 365 in cui vengono importati gli elementi di Twitter e quindi selezionare Avanti.

  14. Selezionare Avanti per esaminare le impostazioni del connettore e quindi selezionare Fine per completare la configurazione del connettore.

  • Last updated on