Configurare un connettore outlook nell'agente SRE di Azure

In questo articolo si connette l'agente a Microsoft Outlook in modo che possa inviare messaggi di posta elettronica, rispondere ai thread e leggere la posta in arrivo durante le indagini. Per altre informazioni, vedere Inviare notifiche.

Annotazioni

Questo articolo tratta il connettore Outlook legacy, che utilizza un'identità gestita e un'assegnazione di ruolo Contributor. Per configurare Outlook con accesso singolo, approvazione per strumento e blocco dei parametri, vedi Collega un servizio di notifiche. Usa questo articolo se hai bisogno del percorso dell'identità gestita o se il tuo agente già si affida a esso.

Tempo stimato: 5 minuti

In questo articolo si apprenderà come:

  • Aggiungere un connettore di Outlook usando l'accesso OAuth
  • Configurare un'identità gestita per l'accesso in fase di esecuzione
  • Verificare il connettore inviando un messaggio di posta elettronica di test

Prerequisiti

  • Un agente creato nel portale dell'agente SRE di Azure
  • Un account di Microsoft 365 con accesso a Outlook
  • Ruolo collaboratore nel gruppo di risorse dell'agente (richiede Microsoft.Web/connections/write e Microsoft.Authorization/roleAssignments/write)
  • Identità gestita configurata nell'agente

Aprire la pagina dei connettori in cui è possibile aggiungere e gestire le connessioni esterne dell'agente.

  1. Apri l'agente nel portale SRE di Azure.
  2. Nella barra laterale sinistra espandere Generatore.
  3. Seleziona Connettori.

L'elenco dei connettori mostra tutti i connettori esistenti per l'agente.

Aggiungere un connettore di Outlook

Selezionare il tipo di connettore Outlook dalla procedura guidata.

  1. Selezionare Aggiungi connettore nella barra degli strumenti.
  2. Nel selezionatore di connettori, seleziona Office 365 Outlook.
  3. Seleziona Avanti.

Screenshot del selezionatore di connettori che mostra Office 365 Outlook opzione insieme ad altri tipi di connettori.

Annotazioni

L'agente può avere un solo connettore di Outlook. Se si dispone già di un connettore, la scheda è disabilitata con il messaggio "L'agente può avere un solo connettore di Outlook". Per modificare l'account connesso, modificare il connettore esistente.

Accedere a Outlook

Il modulo di installazione mostra il nome del connettore (generato automaticamente) e l'opzione di accesso.

  1. Attendere il completamento del controllo delle autorizzazioni. Brevemente viene visualizzato Controllo delle autorizzazioni .
  2. Selezionare Accedi a Outlook.
  3. Completare l'autenticazione OAuth nella finestra popup.
  4. In caso di esito positivo, viene visualizzata una scheda Connessa come che mostra l'indirizzo di posta elettronica con un segno di spunta verde.

Avviso

Se la finestra di dialogo di autenticazione non viene visualizzata, verificare che il browser non blocchi i popup da sre.azure.com.

Checkpoint: La scheda Connessa come mostra l'indirizzo di posta elettronica con un segno di spunta verde. Se invece viene visualizzato un avviso relativo alle autorizzazioni, verifica di disporre del ruolo Collaboratore nel gruppo di risorse. L'avviso include un collegamento alle impostazioni di Azure IAM.

Suggerimento

Selezionare Accedi con un account diverso sotto la scheda connessa per ripetere l'autenticazione usando un account Microsoft diverso. Questa azione disconnette l'account corrente e avvia un nuovo flusso OAuth.

Selezionare l'identità gestita

Il connettore outlook richiede sia l'accesso OAuth che un'identità gestita.

  • L'accesso OAuth autorizza l'agente a usare l'account Outlook (inviare e leggere messaggi di posta elettronica).
  • L'identità gestita consente all'agente di accedere in modo sicuro al connettore in fase di esecuzione tramite Azure Resource Manager.
  1. Nell'elenco a discesa Identità gestita selezionare un'identità:
    • Sistema assegnato: l'opzione più semplice. Creato automaticamente con l'agente e integrato nel ciclo di vita. Usare questa opzione se non è necessario condividere l'identità tra più risorse.
    • Assegnato dall'utente: una risorsa Azure indipendente che gestisci separatamente. Usare questa opzione se si condividono le identità tra i servizi o se è necessario che l'identità persista indipendentemente dall'agente.
  2. Se non vengono visualizzate identità, selezionare Aggiungi identità sotto l'elenco a discesa per configurarne una nel portale di Azure.

Rivedi e aggiungi

Verificare i dettagli del connettore e creare il connettore.

  1. Selezionare Avanti per passare al passaggio Rivedi e aggiungi .
  2. Verificare i dettagli del connettore.
  3. Selezionare Aggiungi connettore per creare il connettore.

Checkpoint: una notifica di tipo avviso popup conferma che il connettore è stato creato correttamente. Il connettore viene visualizzato nell'elenco dei connettori.

Testare il connettore Outlook

Chiedere all'agente di inviare un messaggio di posta elettronica di test per verificare il funzionamento del connettore.

Send an email to [your-email] with subject "SRE Agent Test" and body "Outlook connector is working"

L'agente compone il messaggio di posta elettronica, lo formatta come HTML e lo invia tramite l'account outlook connesso.

Checkpoint: L'agente mostra una scheda degli strumenti che conferma l'invio del messaggio di posta elettronica. Controllare la posta in arrivo per verificare la ricevuta.

Modificare o rimuovere il connettore

Edit

  1. Nell'elenco dei connettori selezionare il menu altre azioni (...) nella riga del connettore di Outlook.
  2. Selezionare Modifica connettore.
  3. Nella finestra di dialogo di modifica ripetere l'autenticazione con un account diverso o modificare l'identità gestita.
  4. Seleziona Salva.

Elimina

  1. Selezionare il menu altre azioni (...) nella riga del connettore e quindi selezionare Elimina connettore. In alternativa, selezionare la casella di controllo e selezionare Rimuovi sulla barra degli strumenti.
  2. Confermare l'eliminazione.

Dopo che l'agente elimina il connettore outlook, l'agente non può inviare o leggere messaggi di posta elettronica. È possibile aggiungere un nuovo connettore di Outlook in qualsiasi momento.

Risoluzione dei problemi

Usa le seguenti informazioni per risolvere problemi comuni quando configuri un connettore Outlook.

Issue Soluzione
Viene visualizzato un avviso relativo alle autorizzazioni Sono necessari i ruoli Microsoft.Web/connections/write e Microsoft.Authorization/roleAssignments/write sul gruppo di risorse. Selezionare il collegamento nell'avviso per aprire le impostazioni di Azure IAM.
Popup OAuth bloccato Consenti popup da sre.azure.com nelle impostazioni del browser.
L'accesso con OAuth non riesce Verificare che l'account Di Microsoft 365 disponga di una cassetta postale di Outlook attiva.
Nessuna identità gestita nell'elenco a discesa Selezionare Aggiungi identità per configurare una nel portale di Azure e quindi selezionare il pulsante Aggiorna.
Scheda connettore disabilitata Si dispone già di un connettore di Outlook. Modificare prima di tutto quello esistente o eliminarlo.