Wie richte ich den Outlook-Mailserver für die IROIN® Suite ein?

Lerne, wie du mit OAuth2 Outlook für den Nachrichtenversand einrichtest

Die IROIN® Influencer Marketing Suite lässt sich mit Outlook über eine OAuth2-Anwendung in Azure Active Directory integrieren, um den Nachrichtenversand zu optimieren. Mit dieser Anleitung kannst du die Integration Schritt für Schritt umsetzen, sodass du E-Mails direkt über IROIN® versenden kannst. Alles, was du brauchst, ist Zugriff auf das Azure Active Directory Portal und Administratorrechte.

App-Registrierung in Azure Active Directory

1.) Navigiere zu Azure Active Directory und melde dich dort an. Genau wie bei Gmail musst du eine Anwendung erstellen, die die Anmeldedaten verwaltet. Öffne also die Seite „App-Registrierungen“ und klicke auf die Schaltfläche „Neue Registrierung“.

2.) Gib die folgenden Werte ein:

• Name der Anwendung: Dieser wird später den Benutzern im Autorisierungsformular angezeigt. Wähle einen leicht verständlichen Namen.
• Unterstützte Kontentypen: Im Kontext der IROIN® Influencer Marketing Suite solltest du nur Konten aus deinem Organisationsverzeichnis zulassen.
• URL für den Anwendungsrückruf: Dies ist die Basis-URL deiner IROIN® Instanz mit dem Suffix „/silent-oauth.html“.

3.) Erhalte die Anwendungs-ID: Jetzt hast du deine Anwendung erstellt und kannst bereits die erste erforderliche Kennung, die „Anwendungs-ID“, abrufen. Diese benötigst du später für die Einrichtung der OAuth2-Unterstützung in IROIN®.

Um mit dem Einrichten der Anwendung fortzufahren, klicken Sie auf den Menü-Link „API-Berechtigungen“.

4.) Öffne die API-Berechtigungen: Klicke auf den Menü-Link „API-Berechtigungen“, um die für die Anwendung erforderlichen Berechtigungen festzulegen.

5.) Füge API-Berechtigungen hinzu:

• Standardmäßig gibt es nur die Berechtigung „User.Read“, die für unseren Zweck nicht ausreicht.
• Klicke auf „Berechtigung hinzufügen“, um weitere Berechtigungen zu ergänzen.

6.) Wähle „Microsoft Graph“ als Standardabschnitt und klicke auf die große Schaltfläche, um fortzufahren.

7.) Wähle den Berechtigungstyp:

• Je nach Kontotyp kannst du zwischen „delegierten“ und „Anwendungsberechtigungen“ wählen.
• Wähle „Delegiert“.
  
  

8.) Füge die erforderlichen Berechtigungen hinzu:

• Suche nach „IMAP“ und aktiviere das Kontrollkästchen „Imap.AccessAsUser.All“ (für das Lesen von E-Mails).
  
  
• Suche nach „SMTP“ und aktiviere die Berechtigung (für das Versenden von E-Mails über SMTP).
• Suche nach „offline_access“ und aktiviere diese Berechtigung, um abgelaufene Zugriffstoken zu aktualisieren.
• Suche nach „email“ und markiere diese Berechtigung. Klicke auf die Schaltfläche „Berechtigungen hinzufügen“, um fortzufahren.
  
  

9.) Überprüfe die Berechtigungen: Auf der Übersichtsseite sollten jetzt alle erforderlichen Berechtigungen aufgeführt sein. Wenn alles korrekt ist, klicke auf den Menüpunkt „Tokenkonfiguration“.

10.) Klicke auf „Optionalen Anspruch hinzufügen

“.

• Wähle den Tokentyp „ID“ und markiere den Anspruch „email“.
• Nach dem Hinzufügen erscheint der Anspruch in der Liste.
  
  
• Klicke anschließend auf den Menüpunkt „Zertifikate & Geheimnisse“.

Geheimen Clientschlüssel einrichten

1.) Erstelle einen geheimen Clientschlüssel, der von IROIN® benötigt wird:

• Klicke auf „Neuer geheimer Clientschlüssel“, um ihn zu erstellen.
• Gib einen Namen für den Clientschlüssel ein und wähle eine Verfallszeit, mit der du einverstanden bist.
  

2.) Speichere den geheimen Clientschlüssel:

• Sobald die Anmeldeinformationen erstellt wurden, wird der geheime Clientschlüssel angezeigt.
• Kopiere den Wert aus dem Feld „Wert“, da er nach dem Verlassen der Seite nicht mehr sichtbar ist. Dies ist das „Client Secret“ für IROIN®.

Konfiguration in der IROIN® Suite und Verbindung testen

1.) Wechsle nun in deine IROIN® Instanz und klicke auf „Einstellungen → Messaging → Apps“.

Du befindest dich jetzt in der Konfiguration von IROIN®.

2.) Füge die Outlook-App hinzu:

• Klicke auf „App hinzufügen“, um die eben erstellte Outlook-App mit der Software zu verbinden.
  

3.) Füge die Outlook-Anmeldedaten hinzu:

• Trage die Outlook-Anmeldedaten in der App-Konfiguration ein.
• Klicke abschließend auf „Speichern“ und schon bist du fertig.