Webex Connect e-mail app configureren met Office 365 Oauth

Inleiding

In dit document worden de stappen beschreven voor het configureren van een e-mail app voor Office365 met Open Authorisation (OAuth 2.0).

Bijgedragen door Andrius Suchanka en Bhushan Suresh, Cisco TAC Engineer.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Webex Contact Center (WXCC) 2.0
• Webex connectportal met geconfigureerd e-mail stromen 
• MS Azure-toegang
• MS Office 365-toegang

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende softwareversies:

• WXc 2.0
• Cisco Webex Connect
• Microsoft Azure
• Microsoft Office 365-software

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Configureren

Stap 1: Start e-mail app configuratie op Webex Connect

Start E-mail app configuratie op Webex Connect platform. 

-Login bij uw Webex Connect-huurder;

-Navigeren naar 'Assets->Apps', klik op 'Nieuwe app configureren' en selecteer 'E-mail'. Selecteer 'OAuth 2.0' voor het verificatietype, kopiëren en opslaan 'Forwarding Address' en 'Call Back URL' voor latere configuratiestappen:

Ga verder naar configuratie aan Microsoft kant.

Stap 2: Een app maken in Microsoft Azure

Registreer een app in Azure-portal volgens 'Registreer een toepassing bij het Microsoft-identiteitsplatform'-document.

-Aanmelden bij https://portal.azure.com;

-Navigeer naar 'Azure Active Directory', selecteer 'App registrations' en klik op 'New registration';

-Vermeld de naam van de toepassing, selecteer het juiste accounttype, voer Web 'Redirect URI' in met uw huurdersnaam (dat is https://yourwebexconnectname.us.webexconnect.io/callback as in stap 1) en registreer de app:

-Nadat de app is geregistreerd - navigeer naar 'Verificatie', scroll naar beneden naar 'Implicit grote en hybride stromen', selecteer 'Access tokens' optie en sla op:

-Navigeer naar 'Certificaten & geheimen', selecteer 'Clientgeheimen', klik op 'Nieuw clientgeheim', voeg een beschrijving en geldigheidslengte toe:

-Kopieer de geheime waarde van de client en sla deze op voor later gebruik:

-Navigeer naar 'API permissies', klik op 'Add a permissie', selecteer 'API's my organisation uses', in zoekveld input 'office 365' en selecteer 'Office 365 Exchange Online'. Selecteer 'Toepassingsrechten', vouw 'Mail' sectie uit, controleer 'Mail.Send' en klik op 'Toestemming toevoegen':

-Nadat genoemde toestemming is toegevoegd, moet admin toestemming worden verleend. Klik op 'Grant Admin toestemming':

-Navigeer naar 'Overzicht' en noteer 'Application (client) ID' en 'Directory (tenant) ID' voor verder configuratiegebruik:

Opmerking: zorg ervoor dat de toestemming van de gebruiker voor apps in Azure is toegestaan onder 'Toestemming en machtigingen' voor 'Enterprise-toepassingen' (dit is een standaardinstellingen):

Stap 3: Postvakgebruiker configureren op Office365

-Aanmelden bij https://admin.microsoft.com;

-Navigeren naar gebruikers->Actieve gebruikers;

-Selecteer een gebruiker met een postvak voor integratie met Webex Connect;

-Na het selecteren van specifieke gebruiker navigeer naar 'Mail', onder 'E-mail apps' klik op 'Beheer e-mail apps', zorg ervoor dat 'Geverifieerde SMTP' is geselecteerd en klik 'Veranderingen opslaan':

-Onder 'Email Forwarding' klik op 'E-mail doorsturen beheren', selecteer 'Alle e-mails doorsturen naar dit postvak', vul 'E-mailadres doorsturen' in met een alias uit Webex Connect App-configuratie zoals in stap 1 (selecteer indien nodig 'Een kopie van doorgestuurd e-mail bewaren in dit postvak') en klik op 'Wijzigingen opslaan':

-Zorg ervoor dat uitgaande e-mail doorsturen naar externe e-mailadressen is toegestaan in uw Microsoft 365 Defender portal.

-Als dit niet het geval is - maak of wijzig bestaande anti-spam beleid volgens de Microsoft documentatie:

Uitgaande spamfiltering configureren - Office 365

Opmerking: als er een fout wordt weergegeven met betrekking tot 'Enable-OrganisationPersonisation' tijdens het opslaan van anti-spam beleid met doorsturen ingesteld op 'On', voer dan cmdlet 'Enable-OrganisationPersonisation' uit zoals aangegeven in het Microsoft-artikel - Enable-OrganisationAdjustization (het kan tot 24 uur duren totdat de genoemde cmdlet-wijziging van kracht wordt).

Opmerking 2: om verbinding te maken met Exchange Online PowerShell, raadpleeg dan het artikel - Connect to Exchange Online PowerShell

Stap 4: E-mailapp configureren op Webex Connect

Switch terug naar Webex Connect e-mail app configuratie en vul vereiste velden in.

-Voor 'Email ID' gebruik mailbox die is geconfigureerd voor het doorsturen van e-mail naar Webex Connect e-mail is in stap 3.

-Gebruik de instellingen voor SMTP-configuratie:

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

-Gebruik voor 'Gebruikersnaam' dezelfde gebruiker als bij stap 3;

-Voor 'client-ID' gebruikt u opgeslagen 'Application (client) ID' zoals aangegeven in stap 2;

-Voor 'Client Secret' gebruik opgeslagen 'Client Secret' zoals aangegeven in stap 2:

-Gebruik 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/authorised' voor 'Authorisation URL';

-gebruik "offline_access" https://outlook.office.com/SMTP.Send' for "scope";

-Voor 'Access Token URL' en 'Refresh Token URL' gebruikt u 'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/token':

-Klik op 'Generate Token', zorg ervoor dat u dezelfde gebruiker gebruikt als in het veld 'Gebruikersnaam' is geconfigureerd - de velden 'Access Token', 'Refresh Token' en 'Validity' zijn ingevuld:

Klik op 'Opslaan' en vervolgens op 'Registreren in Webex Engage':

Verifiëren

Verifiëren door een e-mail te sturen naar Office 365 postvak. Als die e-mail wordt weergegeven aan de Webex Contact Center-agent en een antwoord van Webex Contact Center-agent wordt ontvangen door de oorspronkelijke afzender, is de configuratie geslaagd.

Probleemoplossing

Als de e-mailstroom nog steeds mislukt, hebt u toegang tot de Debug Console op Webex Connect portal pagina en zoekt u met het e-mail kanaal en de tijdstempel 

In deze sectie vindt u het inkomende bericht en het uitgaande bericht samen met de status

Selecteer de bericht-ID om meer informatie over de fout te verzamelen 

Zodra de Message ID is geselecteerd, worden in het gedeelte Fout en waarschuwingen meer details over de fout weergegeven

Als u Cisco TAC wilt instellen, raadpleegt u de volgende informatie: 

• Asset-ID van het e-mailkanaal 
• Transactie-ID en screenshot van de mislukte fout in de Debug-logboeken zoals aangegeven in de afbeelding