Robuste Schnittstellen mit externen Prozessen
In diesem Artikel erfahren Sie, wie Sie die RESTful-APIs in der User Journey planen und implementieren und die Anwendung robuster gegen API-Ausfälle gestalten.
Sicherstellen der ordnungsgemäßen Platzierung der APIs
Mithilfe der IEF-Richtlinien (Identity Experience Framework) können Sie ein externes System mithilfe eines technischen RESTful-API-Profils aufrufen. Externe Systeme werden nicht von der IEF-Laufzeitumgebung gesteuert und stellen einen potenziellen Fehlerpunkt dar.
Verwalten externer Systeme mithilfe von APIs
Wenn Sie eine Schnittstelle für den Zugriff auf bestimmte Daten aufrufen, überprüfen Sie, ob die Daten die Authentifizierungsentscheidung steuern werden. Bewerten Sie, ob die Informationen für die Kernfunktionen der Anwendung von entscheidender Bedeutung sind. Beispielsweise eine E-Commerce- im Vergleich zu einer sekundären Funktion, etwa einer Verwaltungsfunktion. Wenn die Informationen für die Authentifizierung nicht benötigt werden und nur für sekundäre Szenarien erforderlich sind, sollten Sie erwägen, den Aufruf in die Anwendungslogik zu verschieben.
Wenn die für die Authentifizierung erforderlichen Daten relativ statisch und klein sind und kein anderer geschäftlicher Grund für die Externalisierung aus dem Verzeichnis vorliegt, sollten Sie erwägen, sie im Verzeichnis zu speichern.
Entfernen Sie nach Möglichkeit API-Aufrufe aus dem vorab authentifizierten Pfad. Wenn dies nicht möglich ist, müssen Sie strikte Schutzvorkehrungen für DoS-Angriffe (Denial-of-Service) und DDoS-Angriffe (Distributed Denial-of-Service) vor ihren APIs platzieren. Angreifer können die Anmeldeseite laden und versuchen, Ihre API mit DoS-Angriffen zu überfluten und Ihre Anwendung zu deaktivieren. Beispielsweise kann die Verwendung von CAPTCHA beim Anmeldungs- bzw. Registrierungsvorgang hilfreich sein.
Verwenden Sie nach Möglichkeit die API-Connectors des integrierten Flows für die Benutzerregistrierung zur Integration in Web-APIs, entweder nach dem Erstellen eines Verbunds mit einem Identitätsanbieter oder vor dem Erstellen des Benutzers. Da die Benutzerflows bereits ausgiebig getestet wurden, ist es wahrscheinlich, dass Sie keine Funktions-, Leistungs- oder Skalierungstests auf Benutzerflowebene durchführen müssen. Sie müssen Ihre Anwendungen weiterhin auf Funktionalität, Leistung und Skalierung testen.
Technische Profile der RESTful-API von Microsoft Entra B2C stellen kein Zwischenspeicherungsverhalten zur Verfügung. Stattdessen implementiert das RESTful-API-Profil eine Wiederholungslogik und ein Timeout, das in die Richtlinie integriert ist.
Für APIs, die Daten schreiben müssen, können Sie einen Task in eine Warteschlange stellen, damit solche Tasks von einem Hintergrundworker ausgeführt werden. Dienste wie Azure-Warteschlangen können verwendet werden. Diese Vorgehensweise führt dazu, dass die Rückgabe der API effizient erfolgt und die Ausführungsleistung der Richtlinie erhöht wird.
API-Fehlerbehandlung
Da sich die APIs außerhalb des Azure AD B2C-Systems befinden, ist eine ordnungsgemäße Fehlerbehandlung innerhalb des technischen Profils erforderlich. Stellen Sie sicher, dass der Endbenutzer entsprechend informiert ist und die Anwendung Fehler ordnungsgemäß behandeln kann.
Ordnungsgemäßes Behandeln von API-Fehlern
Eine API kann aus verschiedenen Gründen fehlschlagen. Sorgen Sie dafür, dass Ihre Anwendung gegenüber solchen Fehlern resistent ist. Geben Sie eine HTTP 4xx-Fehlermeldung zurück, wenn die API die Anforderung nicht abschließen kann. Versuchen Sie in der Azure AD B2C-Richtlinie, die Nichtverfügbarkeit der API ordnungsgemäß zu behandeln, und rendern Sie ggf. eine verringerte Benutzeroberfläche.
Behandeln Sie vorübergehende Fehler ordnungsgemäß. Das RESTful-API-Profil ermöglicht es Ihnen, Fehlermeldungen für verschiedene Störfälle zu konfigurieren.
Überwachen und verwenden Sie proaktiv Continuous Integration/Continuous Delivery (CI/CD), und rotieren Sie die Anmeldeinformationen für den API-Zugriff, z. B. Kennwörter und Zertifikate, die von der Engine des technischen Profils verwendet werden.
Bewährte Methoden für die API-Verwaltung
Wenn Sie die RESTful-APIs bereitstellen und das technische RESTful-Profil konfigurieren, können Sie die empfohlenen bewährten Methoden befolgen, um häufige Fehler und Probleme zu vermeiden, die übersehen werden können.
Verwalten von APIs
API Management (APIM) veröffentlicht, verwaltet und analysiert Ihre APIs. APIM verarbeitet außerdem die Authentifizierung, um sicheren Zugriff auf Back-End-Dienste und Microservices zu ermöglichen. Verwenden Sie ein API-Gateway zum horizontalen Hochskalieren von API-Bereitstellungen, Zwischenspeicherung und Lastenausgleich.
Es wird empfohlen, das richtige Token am Anfang der User Journey abrufen, anstatt für jede API mehrere Aufrufe auszuführen, und eine Azure APIM-API zu sichern.