Configurazione di Webex Connect Email App con Office 365 Oauth

Introduzione

In questo documento viene descritto come configurare un'app E-mail per Office 365 con autorizzazione di apertura (OAuth 2.0).

Contributo di Andrius Suchanka e Bhushan Suresh, Cisco TAC Engineer.

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Webex Contact Center (WxCC) 2.0
• Webex connectportal con flussi di posta elettronica configurati 
• Accesso a Microsoft Azure
• Accesso a MS Office365

Componenti usati

Le informazioni di questo documento si basano sulle seguenti versioni software:

• WxCC 2.0
• Cisco Webex Connect
• Microsoft Azure
• Microsoft Office 365

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Configurazione

Passaggio 1: Avvia configurazione app e-mail su Webex Connect

Avvia la configurazione dell'app e-mail sulla piattaforma Webex Connect. 

-Accedere al tenant Webex Connect;

-Passare a 'Assets->Apps', fare clic su 'Configure New App' e selezionare 'Email'. Selezionare 'OAuth 2.0' per il tipo di autenticazione, copiare e archiviare 'Indirizzo di inoltro' e 'URL di richiamata' per i passaggi di configurazione successivi:

Procedere alla configurazione sul lato Microsoft.

Passaggio 2: Crea un'app in Microsoft Azure

Registra un'app nel portale di Azure in base al documento 'Registra un'applicazione con la piattaforma di identità Microsoft'.

-Accedere a https://portal.azure.com;

-Passare a 'Azure Active Directory', selezionare 'Registrazioni app' e fare clic su 'Nuova registrazione';

-Fornire il nome dell'applicazione, selezionare il tipo di account appropriato, immettere il Web 'Redirect URI' con il nome del tenant (ovvero https://yourwebexconnectname.us.webexconnect.io/callback as visualizzato nel passaggio 1) e registrare l'app:

-Dopo la registrazione dell'app - passare a 'Autenticazione', scorrere verso il basso fino a 'Flussi grandi e ibridi impliciti', selezionare l'opzione 'Token di accesso' e salvare:

-Passare a 'Certificati e segreti', selezionare 'Segreti client', fare clic su 'Nuovo segreto client', aggiungere una descrizione e la durata di validità:

-Copiare il valore segreto client e memorizzarlo per un utilizzo successivo:

-Passare a 'Autorizzazioni API', fare clic su 'Aggiungi un'autorizzazione', selezionare 'API utilizzate dall'organizzazione', nel campo di ricerca input 'office 365' e selezionare 'Office 365 Exchange Online'. Selezionare 'Autorizzazioni applicazione', espandere la sezione 'Mail', selezionare 'Mail.Send' e fare clic su 'Aggiungi autorizzazione':

-Dopo aver aggiunto tale autorizzazione, è necessario concedere il consenso dell'amministratore. Fare clic su 'Concedi il consenso dell'amministratore':

-Passare a 'Panoramica' e annotare 'ID applicazione (client)' e 'ID directory (tenant)' per un ulteriore utilizzo della configurazione:

Nota: verificare che il consenso utente per le app sia consentito in Azure in 'Consenso e autorizzazioni' per 'Applicazioni aziendali' (impostazioni predefinite):

Passaggio 3: Configura utente cassetta postale in Office365

-Accedere a https://admin.microsoft.com;

-Passare a Utenti->Utenti attivi;

-Selezionare un utente con una casella di posta per l'integrazione con Webex Connect;

-Dopo aver selezionato un utente specifico, passare a 'Mail', in 'Email apps' fare clic su 'Manage email apps', assicurarsi che 'Authenticated SMTP' sia selezionato e fare clic su 'Save changes':

-In 'Inoltro e-mail' fare clic su 'Gestisci inoltro e-mail', selezionare 'Inoltra tutti i messaggi e-mail inviati a questa cassetta postale', compilare 'Inoltro indirizzo e-mail' con alias dalla configurazione dell'app Webex Connect come mostrato nel passaggio 1 (se necessario, selezionare 'Mantieni una copia dei messaggi inoltrati in questa cassetta postale') e fare clic su 'Salva modifiche':

-Verificare che l'inoltro della posta elettronica in uscita a indirizzi di posta elettronica esterni sia consentito nel portale di Microsoft 365 Defender.

-In caso contrario - creare o modificare i criteri antispam esistenti come indicato nella documentazione Microsoft:

Configura filtro posta indesiderata in uscita - Office 365

Nota: se viene visualizzato un errore relativo a 'Enable-OrganizationCustomization' durante il tentativo di salvare i criteri antispam con l'opzione di inoltro impostata su 'On', eseguire il cmdlet 'Enable-OrganizationCustomization' come indicato nell'articolo di Microsoft - Enable-OrganizationCustomization (possono trascorrere fino a 24 ore prima che la modifica del cmdlet venga applicata).

Nota 2: per connettersi a Exchange Online PowerShell, consultare l'articolo - Connessione a Exchange Online PowerShell

Passaggio 4: Configurazione dell'app e-mail su Webex Connect

Tornare alla configurazione dell'app e-mail di Webex Connect e compilare i campi obbligatori.

-Per l'ID e-mail, usare la cassetta postale configurata per l'inoltro femminile verso l'indirizzo e-mail di Webex Connect al passaggio 3.

-Utilizzare le impostazioni per la configurazione SMTP:

SMTP Server: smtp.office365.com
Port: 587
Security: STARTTLS

-Per 'Username' utilizzare lo stesso utente configurato nel passaggio 3;

-Per 'ID client' utilizzare 'ID applicazione (client)' salvato come indicato nel passaggio 2;

-Per 'Segreto client' utilizzare 'Segreto client' salvato come indicato nel passaggio 2:

-Utilizzare 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/authorization' per 'URL autorizzazione';

-Utilizzare 'offline_access https://outlook.office.com/SMTP.Send' for 'Ambito';

-Per 'Access Token URL' e 'Refresh Token URL' utilizzare 'https://login.microsoftonline.com/<id-tenant-azure>/oauth2/v2.0/token':

-Fare clic su 'Genera token', assicurarsi di utilizzare lo stesso utente configurato nel campo 'Nome utente' - i campi 'Token di accesso', 'Aggiorna token' e 'Validità' sono popolati:

-Fare clic su 'Save' e quindi su 'Register to Webex Engage':

Verifica

Verifica inviando un messaggio di posta elettronica alla cassetta postale di Office 365. Se l'e-mail viene presentata all'agente di Webex Contact Center e il mittente originale riceve una risposta dall'agente di Webex Contact Center, la configurazione ha esito positivo.

Risoluzione dei problemi

Se il flusso di posta elettronica continua a non riuscire, accedere alla console di debug sulla pagina del portale Webex Connect e cercare con il canale di posta elettronica e l'indicatore orario 

Questa sezione contiene i messaggi in arrivo e in uscita e lo stato

Selezionare l'ID messaggio per ottenere ulteriori dettagli sull'errore 

Dopo aver selezionato l'ID messaggio, nella sezione Errori e avvertenze vengono visualizzati ulteriori dettagli dell'errore

Se è necessario gestire Cisco TAC, raccogliere le seguenti informazioni: 

• ID asset del canale e-mail 
• ID transazione e screenshot della transazione non riuscita nei log di debug come mostrato