Zum Hauptinhalt springen
Die Microsoft-365-Integration verbindet sich normalerweise über die anny-App: Ein:e Administrator:in erteilt einmalig die Zustimmung für die Organisation. Manche Organisationen dürfen fremde Apps in ihrem Tenant aber nicht freigeben, zum Beispiel wenn ein Rechenzentrum den Tenant zentral verwaltet. Für diesen Fall legst du in deinem eigenen Tenant eine App-Registrierung an und trägst ihre Zugangsdaten in anny ein. App, Berechtigungen und geheimer Schlüssel bleiben dann unter deiner Kontrolle. Dieser Artikel richtet sich an Administrator:innen von Microsoft Entra ID.
Die eigene App-Registrierung ist Teil des Enterprise-Plans. Ohne ihn zeigt die Integration nur den Button Autorisieren.

​
Voraussetzungen

  • Eine anny Organisation im Enterprise-Plan und Admin-Rechte in deinem anny Account
  • Eine Microsoft-365-Organisation mit Exchange-Online-Postfächern (Cloud, nicht On-Premise)
  • Ein Konto in Microsoft Entra ID, das App-Registrierungen anlegen und die Administratorzustimmung für Anwendungsberechtigungen erteilen darf, zum Beispiel mit der Rolle Global Administrator oder Privileged Role Administrator
  • Die Kalender, die du verbinden möchtest, existieren bereits (z. B. Raumpostfächer für deine Räume)

​
Benötigte Berechtigungen

Die App-Registrierung braucht diese Berechtigungen von Microsoft Graph, jeweils als Anwendungsberechtigung:
  • Calendars.ReadWrite: Termine in den verbundenen Kalendern lesen, anlegen, ändern und löschen und über Änderungen benachrichtigt werden
  • User.Read.All: Konten in der Auswahl Microsoft Kalender anzeigen und die Verbindung prüfen
  • MailboxSettings.Read: In der Fehlerdiagnose erkennen, ob automatische Antworten eines Postfachs Termine stören
MailboxSettings.Read ist optional: Die Synchronisation läuft auch ohne diese Berechtigung, die Fehlerdiagnose prüft dann nur keine automatischen Antworten.
Delegierte Berechtigungen funktionieren hier nicht. anny arbeitet ohne angemeldete Person, deshalb braucht auch kein Raumpostfach ein Konto mit Passwort.

​
Verbindung einrichten

Die Beschriftungen im Microsoft Entra Admin Center können je nach Sprache und Version leicht abweichen.
1

App registrieren

Öffne im Microsoft Entra Admin Center App-Registrierungen und klicke auf Neue Registrierung. Vergib einen Namen, zum Beispiel anny, und wähle Nur Konten in diesem Organisationsverzeichnis. Eine Umleitungs-URI brauchst du nicht.
2

Berechtigungen hinzufügen

Öffne API-Berechtigungen → Berechtigung hinzufügen → Microsoft Graph → Anwendungsberechtigungen und wähle die Berechtigungen aus der Liste oben. Klicke danach auf Administratorzustimmung erteilen. Neben jeder Berechtigung steht dann, dass die Zustimmung erteilt wurde.
3

Geheimen Clientschlüssel erstellen

Öffne Zertifikate & Geheimnisse → Geheime Clientschlüssel → Neuer geheimer Clientschlüssel und wähle eine Laufzeit. Microsoft begrenzt sie auf höchstens 24 Monate. Kopiere danach sofort den Wert, nicht die ID: Microsoft zeigt ihn nur einmal an.
4

IDs kopieren

Kopiere aus der Übersicht der App-Registrierung die Verzeichnis-ID (Mandant) und die Anwendungs-ID (Client).
5

Integration in anny öffnen

Öffne in der Seitenleiste Account › Apps & Integrationen, wähle unter Alle Apps und Integrationen Microsoft 365 aus und klicke auf Einrichten.
6

Zugangsdaten eintragen

Klicke im Abschnitt Verbindung unter dem Button Autorisieren auf Eigene App-Registrierung verwenden. Trage Verzeichnis-ID (Mandant), Anwendungs-ID (Client) und Geheimer Clientschlüssel ein und klicke auf Verbindung prüfen. anny speichert die Zugangsdaten erst, wenn Microsoft sie akzeptiert und die Berechtigungen ausreichen.
7

Kalender verbinden und aktivieren

Ab hier ist alles wie bei der normalen Verbindung: Lege fest, welche Kalender mit welchen Ressourcen gekoppelt werden, und aktiviere die Integration. Die Schritte findest du unter Microsoft 365 mit anny verbinden.

​
Geheimen Clientschlüssel erneuern

Läuft der Schlüssel ab, deaktiviert sich die Integration und die betroffenen Admins erhalten eine Benachrichtigung. anny warnt nicht vorab, trage dir das Ablaufdatum also selbst ein und erneuere den Schlüssel rechtzeitig.
1

Neuen Schlüssel erstellen

Erstelle im Microsoft Entra Admin Center einen neuen geheimen Clientschlüssel und kopiere den Wert.
2

Integration deaktivieren

Deaktiviere die Integration über den Toggle im Seitenkopf. Zugangsdaten lassen sich nur im deaktivierten Zustand ändern.
3

Zugangsdaten neu eintragen

Klicke im Abschnitt Verbindung auf Neu verbinden, trage alle drei Werte ein und klicke auf Verbindung prüfen.
4

Integration aktivieren

Aktiviere die Integration wieder. Lösche danach den alten Schlüssel im Microsoft Entra Admin Center.

​
Zugriff auf einzelne Postfächer begrenzen

Die Anwendungsberechtigungen gelten zunächst für alle Postfächer deines Tenants. Auf ausgewählte Raum- und Ressourcenpostfächer begrenzt du den Zugriff in Exchange Online: Die Anleitung unter Microsoft-365-Kalenderzugriff auf einzelne Postfächer begrenzen gilt auch für deine eigene App. Beachte dabei:
  • Nimm die IDs der Unternehmensanwendung, die zu deiner App-Registrierung gehört.
  • Statt der Rolle Application MailboxSettings.ReadWrite genügt Application MailboxSettings.Read.
  • User.Read.All bleibt in Entra ID. Ohne diese Berechtigung lehnt anny die Verbindung ab.

​
Zurück zur anny-App wechseln

Deaktiviere die Integration und wähle auf ihrer Detailseite die drei Punkte → Authentifizierung entfernen. Danach zeigt der Abschnitt Verbindung wieder den Button Autorisieren.

​
Einschränkungen

  • Nur geheime Clientschlüssel: Zertifikate als Zugangsdaten werden nicht unterstützt.
  • Keine Erinnerung vor dem Ablauf: anny meldet sich erst, wenn der Schlüssel abgelaufen ist und sich die Integration deaktiviert hat.
  • Nur Microsoft 365: Die Integration Microsoft Teams verbindet sich weiterhin über ihre eigene anny-App.

​
FAQ

Nein. anny speichert ihn verschlüsselt und zeigt ihn nach dem Eintragen nicht mehr an. Deshalb sind die Felder leer, wenn du auf Neu verbinden klickst, und du trägst alle drei Werte neu ein.
Nein. Die Anwendungsberechtigungen greifen ohne Anmeldung auf die Postfächer zu.

​
Troubleshooting

Prüfe, ob du den Wert des geheimen Clientschlüssels kopiert hast und nicht seine ID, ob der Schlüssel noch gültig ist und ob Verzeichnis-ID und Anwendungs-ID zur selben App-Registrierung gehören. Ein neuer Schlüssel kann ein paar Minuten brauchen, bis er funktioniert.
Microsoft hat die Zugangsdaten akzeptiert, aber anny darf die Konten deines Tenants nicht lesen. Prüfe, ob User.Read.All als Anwendungsberechtigung eingetragen ist und ob die Administratorzustimmung erteilt wurde. Neue Berechtigungen können etwas dauern, bis sie greifen.
Verzeichnis-ID und Anwendungs-ID sind IDs im Format 00000000-0000-0000-0000-000000000000. Eine Domain wie firma.onmicrosoft.com wird nicht akzeptiert.
Solange die Integration aktiv ist, lassen sich die Zugangsdaten nicht ändern. Deaktiviere sie über den Toggle im Seitenkopf und versuche es erneut.
Meist ist der geheime Clientschlüssel abgelaufen oder wurde gelöscht. Trage einen neuen ein, wie unter Geheimen Clientschlüssel erneuern beschrieben. Weitere Ursachen stehen unter Microsoft 365 mit anny verbinden.