Anlegen der Outlook API mit einem Clientschlüssel und Zuweisung des Besitzers

Für die Anlage der Outlook API müssen Sie sich zuerst am Azure Portal anmelden. https://aad.portal.azure.com/

Hierzu klicken Sie zuerst auf „Übersicht“, danach auf „App-Registrierung“ und zuletzt auf „+Neue Registrierung“

VARIO Software App-Registrierung

Als nächstes müssen Sie der API einen Namen vergeben. Danach wählen Sie bitte unter „Unterstützte Kontotypen“ „Konten in einem beliebigen Organisationsverzeichnis“ aus und klicken auf „Registrieren“.

Anwendung Registrieren

Authentifizierung

Hierfür klicken Sie auf „+Plattform hinzufügen“ und wählen „Web“ aus.

Authentifizierung

Auf der folgenden Seite geben Sie bitte http://localhost:8080 als Umleitungs-URL an und klicken auf „Konfigurieren“.

Anwendung konfigurieren

Zertifikate & Geheimnisse

Hier klicken Sie bitte auf „+neuer geheimer Schlüssel“ und geben diesem einen Namem. Danach wählen Sie eine Gültikeit des Schlüssels aus und klicken auf „Hinzufügen“.

Zertifikate & Geheimnisse

Der Schlüssen wird nur einmalig angezeigt. Am Besten kopieren Sie sich diesen. Für den Fall, dass der Schlüssel nicht korrekt kopiert wurde, müssen Sie einen neuen erstellen.

Zertifikate & Geheimnisse Clientschlüssel

API-Berechtigung

Klicken Sie auf „+Berechtigung hinzufügen“ und danach auf „Exchange“.

API-Berechtigung

Danach klicken Sie bitte auf „Delegierte Berechtigung“.

API Berechtigung anfordern

Als nächstes müssen Sie die erforderlichen Berechtigungen für die API aus und klicken auf „Berechtigungen hinzufügen“.

API Berechtigung anfordern
API Berechtigung anfordern

Eine API verfügbar machen

Hier klicken Sie als erstes auf „Festlegen“.

Eine API verfügbar machen

Danach auf „Speichern“.

Eine API verfügbar machen speichern

Als nächstes klicken Sie bitte auf „+Bereich hinzufügen“ und vergeben einen „Bereichsnamen“. Danach können Sie auswählen „wer einwilligen darf“ (Optionale Angabe). Zuletzt legen Sie noch einen Anzeigenamen fest, fügen eine Beschreibung hinzu und klicken auf „Bereich hinzufügen“.

Eine API verfügbar machen

Als nächstes müssen Sie auf „+Eine Clientanwendung hinzufügen“ klicken. Hier wählen Sie den Autorisierten API Bereich aus und kopieren sich den mitteleren Teil, da dieser die Client ID ist. Dann müssen Sie die gerade kopierte Client ID nur noch in das Feld Client ID einfügen und auf „Anwendung hinzufügen“ klicken.

Eine API verfügbar machen

Office 365 API in der VARIO einrichten

Als erste müssen Sie die Parameterverwaltung (Menüpunkt 1.9.1) öffnen und in den Benutzereinstellungen auf Kommunikation klicken. Hier wählen Sie „Microsoft Outlook REST API verwenden“ aus und tragen die Client-ID (API-ID) und das Client Secret (der Schlüssel den Sie bei „Zertifikaten und Geheimnisse“ kopiert haben) ein.

Parameterverwaltung der VARIO

Beim erstmaligen Versenden einer E-Mail aus der VARIO werden Sie aufgefordert die Berechtigung zu akzeptieren.

Angeforderte Berechtigung