Probleme bei der App-Registrierung
Probleme bei der App-Registrierung äußern sich in der Regel in Form von Authentifizierungsfehlern bei der Verbindung mit Dataverse oder Azure SQL. Häufige Probleme sind:
| Problem | Lösung |
| Abgelaufener Client-Schlüssel | Client-Geheimnisse haben ein Ablaufdatum. Überprüfen Sie Azure Portal → App-Registrierungen → Ihre App → Zertifikate und Geheimnisse. Erstellen Sie ein neues Geheimnis und aktualisieren Sie es in Data Mission Sync. |
| Falsche Client-ID | Überprüfen Sie, ob die Client-ID (Anwendungs-ID) genau übereinstimmt. Sie finden sie im Azure-Portal → App-Registrierungen → Ihre App → Übersicht. |
| Falsche Mandanten-ID | Stellen Sie sicher, dass Sie die richtige Mandanten-ID für Ihre Organisation verwenden. Multi-Mandanten-Apps erfordern möglicherweise eine spezielle Mandantenkonfiguration. |
| Geheimnis falsch kopiert | Client-Geheimnisse werden nach ihrer Erstellung nur einmal angezeigt. Wenn Sie es falsch kopiert haben, erstellen Sie ein neues Geheimnis. Achten Sie auf führende/nachfolgende Leerzeichen. |
| App-Registrierung gelöscht | Wenn die App-Registrierung in Azure gelöscht wurde, müssen Sie eine neue erstellen und alle Konfigurationen aktualisieren. |
Rotieren von Client-Geheimnissen
Client-Geheimnisse sollten vor ihrem Ablauf rotiert werden. So rotieren Sie ein Geheimnis:
1. Erstellen Sie einen neuen Geheimcode im Azure-Portal (bevor der alte abläuft).
2. Aktualisieren Sie den Geheimcode in Data Mission Sync über „Quelle bearbeiten“.
3. Testen Sie die Verbindung, um zu überprüfen, ob der neue Geheimcode funktioniert.
4. Löschen Sie den alten Geheimcode aus dem Azure-Portal.
| ⚠ Wichtig: Richten Sie 2–4 Wochen vor Ablauf Ihres Geheimnisses eine Kalendererinnerung ein. Abgelaufene Geheimnisse führen dazu, dass alle Synchronisierungen fehlschlagen. |
Probleme bei der SQL-Authentifizierung
Probleme bei der Azure SQL-Authentifizierung treten auf, wenn die App-Registrierung nicht ordnungsgemäß als Datenbankbenutzer konfiguriert wurde:
| Fehlermeldung | Lösung |
| Anmeldung für Benutzer fehlgeschlagen | Die App-Registrierung wurde nicht als Datenbankbenutzer hinzugefügt. Stellen Sie eine Verbindung zu Ihrer Datenbank her und führen Sie folgenden Befehl aus: CREATE USER [IhrAppName] FROM EXTERNAL PROVIDER; |
| Benutzer hat keine Berechtigung | Der Benutzer existiert, verfügt jedoch nicht über die erforderlichen Berechtigungen. Führen Sie folgenden Befehl aus: ALTER ROLE db_owner ADD MEMBER [YourAppName]; um die erforderlichen Berechtigungen zu erteilen. |
| Benutzer in Datenbank nicht gefunden | Möglicherweise sind Sie mit der falschen Datenbank verbunden. Stellen Sie sicher, dass Sie den Befehl CREATE USER in Ihrer Zieldatenbank ausführen, nicht in der Master-Datenbank. |
| Der Serverprinzipal existiert bereits | Ein Benutzer mit diesem Namen ist bereits vorhanden. Dies ist in der Regel kein Problem – stellen Sie einfach sicher, dass der Benutzer über die richtigen Berechtigungen verfügt. |
| 💡 Hinweis: Data Mission Sync verwendet ausschließlich die Microsoft Entra (Azure AD)-Authentifizierung. Die SQL Server-Benutzernamen-/Passwort-Authentifizierung wird nicht unterstützt. | |