E‑Mail-OAuth-Profile und Microsoft 365-Clientanmeldedaten

Mit E‑Mail-OAuth-Profilen können Sie OAuth-Einstellungen für E‑Mail-Konten in der Contact Center AI Platform (CCAI Platform) verwalten. Anstatt eine einzelne globale OAuth-Konfiguration für alle OAuth-IMAP-Konten zu verwenden, können Sie separate E‑Mail-OAuth-Profile erstellen und jedes E‑Mail-Konto mit dem Profil verknüpfen, das es verwenden soll.

Für Microsoft 365 unterstützen E‑Mail-OAuth-Profile den Berechtigungstyp „Clientanmeldedaten“. Bei diesem Berechtigungstyp erfolgt die Authentifizierung auf Anwendungsebene und nicht über die Anmeldung eines einzelnen Nutzers. Er ist besonders nützlich für gemeinsame Posteingänge wie support@company.com, da der Zugriff nicht vom Passwort, der Einwilligungssitzung oder dem Beschäftigungsstatus eines einzelnen Administrators abhängt.

Auf dieser Seite erfahren Sie, wie Sie E‑Mail-OAuth-Profile für Microsoft 365 mit Clientanmeldedaten einrichten.

Autorisierungscode im Vergleich zu Clientanmeldedaten

Die CCAI Platform unterstützt die OAuth-Berechtigungstypen „Autorisierungscode“ und „Clientanmeldedaten“ für E‑Mail-Konten. In der folgenden Tabelle werden diese Berechtigungstypen verglichen:

Berechtigungstyp Optimal für Funktionsweise
Autorisierungscode Nutzerspezifische Posteingänge Ein Administrator oder Postfachnutzer meldet sich über den Microsoft OAuth Einwilligungsablauf an.
Clientanmeldedaten Gemeinsame oder anwendungsverwaltete Microsoft 365-Posteingänge Die CCAI Platform verwendet eine App-Registrierung, einen Clientschlüssel und Berechtigungen auf Instanzebene, um Zugriff anzufordern, ohne dass sich ein Nutzer interaktiv anmelden muss.

Jedes E‑Mail-OAuth-Profil verwendet einen Berechtigungstyp. Wenn Ihre Organisation verschiedene Berechtigungstypen, Anbieter oder Posteingangskonfigurationen benötigt, erstellen Sie separate E‑Mail-OAuth-Profile und verknüpfen Sie jedes E‑Mail-Konto mit dem entsprechenden Profil.

Hinweis

Sie benötigen Folgendes:

  • Eine Microsoft 365-Instanz.

  • Administratorzugriff auf Microsoft Entra.

  • Ein CCAI Platform-Administratorkonto mit der Berechtigung zum Verwalten von E‑Mail-Einstellungen.

  • PowerShell ist lokal installiert.

  • Das PowerShell-Modul ExchangeOnlineManagement ist installiert.

  • Die Microsoft-Instanz-ID für Ihr Verzeichnis.

Außerdem müssen Sie wissen, auf welchen Posteingang oder welche Posteingänge die CCAI Platform zugreifen soll.

Microsoft Entra-App-Registrierung erstellen

Die CCAI Platform verwendet die Microsoft Entra-App-Registrierung, um OAuth-Tokens für den Microsoft 365-E‑Mail-Zugriff anzufordern.

So erstellen Sie eine Microsoft Entra-App-Registrierung:

  1. Rufen Sie in Microsoft Azure Microsoft Entra ID > App-Registrierungen auf.

  2. Wählen Sie Neue Registrierung aus.

  3. Geben Sie einen eindeutigen Namen für die App ein, z. B. „CCAI Platform Email OAuth“.

  4. Schließen Sie die Registrierung ab.

  5. Kopieren Sie die Anwendungs-ID (Client).

  6. Kopieren Sie die Verzeichnis-ID (Mandant).

Verwenden Sie diese Werte, wenn Sie ein E‑Mail-OAuth- Profil erstellen.

Clientschlüssel erstellen

So erstellen Sie einen Clientschlüssel:

  1. Rufen Sie in der App-Registrierung Zertifikate und Secrets auf.

  2. Erstellen Sie einen neuen Clientschlüssel.

  3. Kopieren Sie den Secret-Wert sofort.

Microsoft API-Berechtigungen hinzufügen

Die App benötigt die Berechtigung, E‑Mails über Exchange Online zu senden und darauf zuzugreifen.

So fügen Sie Microsoft API-Berechtigungen hinzu:

  1. Rufen Sie in der App-Registrierung API-Berechtigungen auf.

  2. Wählen Sie Berechtigung hinzufügen aus.

  3. Wählen Sie Office 365 Exchange Online aus.

  4. Wählen Sie Anwendungsberechtigungen aus.

  5. Fügen Sie die erforderlichen Berechtigungen hinzu:

    • IMAP.AccessAsApp

    • SMTP.SendAsApp

  6. Wenn die CCAI Platform verfügbare Microsoft 365-Posteingänge in einer Drop-down-Liste anzeigen soll, fügen Sie die Microsoft Graph-Anwendungsberechtigungen hinzu, die zum Auflisten von Nutzern oder Posteingängen für Ihre Instanz erforderlich sind.

  7. Wählen Sie Administratoreinwilligung für Ihre Organisation erteilen aus.

Prüfen Sie, ob die Berechtigungen als erteilt angezeigt werden, bevor Sie fortfahren.

App Zugriff auf den Posteingang gewähren

Nachdem die App Berechtigungen auf Instanzebene hat, gewähren Sie ihr Zugriff auf den Posteingang, mit dem sich die CCAI Platform verbinden soll.

So gewähren Sie der App Zugriff auf den Posteingang:

  1. Öffnen Sie PowerShell.

  2. Stellen Sie eine Verbindung zu Exchange Online her:

    Connect-ExchangeOnline -Organization TENANT_ID
    

    Ersetzen Sie TENANT_ID durch die Verzeichnis-ID (Mandanten-ID) von Microsoft 365.

  3. Registrieren Sie den Dienstprinzipal in Exchange:

    New-ServicePrincipal `
        -AppId APPLICATION_CLIENT_ID `
        -ObjectId OBJECT_ID
    

    Ersetzen Sie Folgendes:

    • APPLICATION_CLIENT_ID: die Anwendungs-ID (Client) aus Ihrer Microsoft Entra-App-Registrierung

    • OBJECT_ID: die Objekt-ID aus Unternehmensanwendungen

  4. Gewähren Sie Zugriff auf den Posteingang:

    Add-MailboxPermission `
        -Identity EMAIL_ADDRESS `
        -User SERVICE_PRINCIPAL_ID `
        -AccessRights FullAccess
    

    Ersetzen Sie Folgendes:

    • EMAIL_ADDRESS: die E‑Mail-Adresse des Posteingangs, auf den die CCAI Platform zugreifen soll

    • SERVICE_PRINCIPAL_ID: die Dienstprinzipal-ID

E‑Mail-OAuth-Profil in der CCAI Platform erstellen

So erstellen Sie ein E‑Mail-OAuth-Profil für die Microsoft 365-Konfiguration mit Clientanmeldedaten:

  1. Klicken Sie im CCAI Platform-Portal auf Einstellungen > Entwicklereinstellungen. Wenn das Menü Einstellungen nicht angezeigt wird, klicken Sie auf Menü.

  2. Rufen Sie den Bereich E‑Mail-Kontoverwaltung auf und klicken Sie dann auf E‑Mail-Konto verwalten. Die Seite E‑Mail-Kontoverwaltung wird angezeigt.

  3. Klicken Sie auf den Tab E‑Mail-OAuth.

  4. Klicken Sie auf Profil hinzufügen.

  5. Geben Sie im Feld Name einen Profilnamen ein.

  6. Wählen Sie in der Liste Berechtigungstyp die Option Clientanmeldedaten aus.

  7. Geben Sie im Feld Token-URL den Microsoft OAuth-Token-Endpunkt für Ihre Instanz ein.

  8. Geben Sie im Feld Client-ID die Anwendungs-ID (Client) aus Microsoft Entra ein.

  9. Geben Sie im Feld Clientschlüssel den Clientschlüsselwert aus Microsoft Entra ein.

  10. Geben Sie im Feld Zielgruppe die Zielgruppe ein.

  11. Geben Sie im Feld Bereich den Bereich ein.

  12. Geben Sie im Feld Status den Status ein.

  13. Geben Sie im Feld Zugriffstyp den Zugriffstyp ein.

  14. Klicken Sie auf Speichern.

So verknüpfen Sie ein E‑Mail-Konto mit dem OAuth-Profil:

  1. Klicken Sie im CCAI Platform-Portal auf Einstellungen > Entwicklereinstellungen. Wenn das Menü Einstellungen nicht angezeigt wird, klicken Sie auf Menü.

  2. Rufen Sie den Bereich E‑Mail-Kontoverwaltung auf und klicken Sie dann auf E‑Mail-Konto verwalten. Die Seite E‑Mail-Kontoverwaltung wird angezeigt.

  3. Klicken Sie auf den Tab Liste der E‑Mail-Konten.

  4. Klicken Sie für das E‑Mail-Konto, das Sie bearbeiten möchten, auf und dann auf E‑Mail Konto bearbeiten.

  5. Wählen Sie in der Liste E‑Mail-Dienst die Option OAuth IMAP aus.

  6. Wählen Sie in der Liste OAuth-Profil das OAuth-Profil aus, das Sie im vorherigen Schritt erstellt haben.

  7. Klicken Sie auf Verknüpfen.

  8. Wählen Sie in der Liste E‑Mail-ID Ihren Posteingang aus.

  9. Klicken Sie auf Speichern.

Durch die Verknüpfung wird bestätigt, dass sich die CCAI Platform mit dem ausgewählten OAuth-Profil authentifizieren kann. Durch die Auswahl des Posteingangs wird der CCAI Platform mitgeteilt, welcher Posteingang für das E‑Mail-Konto verwendet werden soll.

Wenn die CCAI Platform die Postfachliste nicht von Microsoft abrufen kann, wird im Formular die manuelle Eingabe der E‑Mail-Adresse verwendet. Geben Sie die Posteingangsadresse manuell ein und speichern Sie das Konto.

Fehlerbehebung

Problem Lösung
Die Posteingangsliste wird nicht geladen Prüfen Sie, ob die Microsoft-App die erforderlichen Microsoft Graph-Berechtigungen und die Administratoreinwilligung hat. Wenn die Drop-down-Liste nicht verfügbar ist, können Sie den Posteingang manuell eingeben.
Die Verknüpfung schlägt mit einem Authentifizierungsfehler fehl Prüfen Sie, ob die Client-ID, der Clientschlüssel, die Instanz-ID und die Token URL korrekt sind. Prüfen Sie außerdem, ob der Clientschlüssel abgelaufen ist.
Der Posteingang kann keine E‑Mails senden oder empfangen Prüfen Sie, ob die App Posteingangsberechtigungen in Exchange Online hat und ob das E‑Mail-Konto mit dem richtigen E‑Mail-OAuth Profil verknüpft ist.