Freigeben über


Authentifizierungsmuster

Add-In können dazuführen, dass ein Einloggen oder Anmelden des Benutzers für den Zugriff auf Funktionen und Funktionalität erforderlich ist. Eingabefelder für den Benutzernamen und das Kennwort oder Schaltflächen, die Anmeldeflows von Drittanbietern starten, sind allgemeine Benutzeroberflächen-Steuerelemente in Authentifizierungs-Oberflächen. Eine einfache und effiziente Authentifizierungs-Oberfläche ist wichtiger erste Schritt, damit Benutzer Ihr Add-In verwenden.

Bewährte Methoden

Dos Don’ts
Beschreiben Sie vor der Anmeldung den Mehrwert Ihres Add-Ins oder demonstrieren Sie die Funktionalität ohne die Erfordernis eines Kontos. Gehen Sie davon aus, dass Benutzer sich anmelden, ohne den Wert und die Vorteile Ihres Add-Ins zu verstehen.
Führen Sie Benutzer durch den Authentifizierungsfluss mit einer primären, gut sichtbaren Schaltfläche auf jedem Bildschirm. Lenken Sie die Aufmerksamkeit mit konkurrierenden Schaltflächen und Handlungsaufforderungen auf sekundäre und tertiäre Aufgaben.
Verwenden Sie eindeutige Schaltflächenbezeichnungen, die die jeweiligen aufgaben beschreiben wie „Anmelden“ oder „Konto erstellen“. Verwenden Sie allgemeine Schaltflächenbezeichnungen wie „Übermitteln“ oder „Loslegen“, um Benutzer durch den Authentifizierungsfluss zu leiten.
Verwenden Sie ein Dialogfeld, um die Aufmerksamkeit des Benutzers auf Authentifizierungsformulare zu lenken. Überlasten Sie Ihren Aufgabenbereich mit einer Erstausführung und Authentifizierungsformularen.
Aufzeigen von niedriger Effizienz im Flow, wie das Auto-Fukissieren auf Eingabefelder. Hinzufügen von unnötigen Schritte zu der Interaktion, z. B. Benutzer müssen die Felder des Formulars anklicken.
Bereitstellen einer Möglichkeit für Benutzer, sich abzumelden und erneut zu authentifizieren. Zwingen Sie Benutzer zur Deinstallation, um zu einer anderen Identität zu wechseln.

Authentifizierungsfluss

  1. First-Run Placemat: Platzieren Sie ihre Anmeldeschaltfläche als klare Handlungsanrufe in der Ersten Ausführungsoberfläche Ihres Add-Ins.

    Ein Beispiel-Add-In-Aufgabenbereich in einer Office-Anwendung.

  2. Identitätsanbieter-Auswahlmöglichkeiten – Stellen Sie eine eindeutige Liste der Identitätsanbieter bereit, die ein Formular für Benutzernamen und Passwort enthält, wenn zutreffend. Die Benutzeroberfläche Ihres Add-Ins ist möglicherweise blockiert, während der Authentifizierungsdialog geöffnet ist.

    Das Dialogfeld

  3. Identitätsanbieter-Anmeldung – Der Identitätsanbieter verfügt über eine eigene Benutzeroberfläche. Microsoft Azure Active Directory ermöglicht die Anpassung von Anmelde- und Zugriffsbereichsseiten für ein einheitliches Aussehen und Verhalten mit Ihrem Dienst. Weitere Informationen.

    Das Anmeldedialogfeld des Identitätsanbieters in einer Office-Anwendung.

  4. Fortschritt – Zeigen Sie den Fortschritt während des Ladevorgangs der Einstellungen und der Benutzeroberfläche an.

    Ein Beispieldialogfeld mit einer Statusanzeige in einer Office-Anwendung.

Hinweis

Wenn Sie den Microsoft Identitätsdienst verwenden, haben Sie die Möglichkeit, eine mit dem Markenzeichen versehene Anmeldeschaltfläche zu verwenden, die an ein dunkles oder helles Design angepasst werden kann. Weitere Informationen.

Authentifizierungsablauf mit Sign-On

Hinweis

Die API für einmaliges Anmelden wird derzeit für Word, Excel, Outlook und PowerPoint unterstützt. Weitere Informationen zur Unterstützung des einmaligen Anmeldens finden Sie unter IdentityAPI-Anforderungssätze. Wenn Sie mit einem Outlook-Add-In arbeiten, müssen Sie die moderne Authentifizierung für den Microsoft 365-Mandanten aktivieren. Informationen dazu finden Sie unter Aktivieren oder Deaktivieren der modernen Authentifizierung für Outlook in Exchange Online.

Verwenden Sie einmaliges Anmelden für eine reibungslosere Endbenutzererfahrung. Die Identität des Benutzers in Office (entweder ein Microsoft-Konto oder eine Microsoft 365-Identität) wird verwendet, um sich bei Ihrem Add-In anzumelden. Daher melden sich Benutzer nur einmal an. Dadurch wird die Erfahrung der Benutzer verbessert, und die ersten Schritte werden erleichtert.

  1. Wenn ein Add-In installiert wird, wird einem Benutzer ein Zustimmungsfenster ähnlich dem folgenden angezeigt:

    Das Zustimmungsfenster in einer Office-Anwendung, wenn ein Add-In installiert wird.

    Hinweis

    Der Veröffentlicher des Add-Ins hat die Kontrolle über das Logo, die Zeichenfolgen und die Berechtigungsbereiche, die im Zustimmungsfenster enthalten sind. Die Benutzeroberfläche ist von Microsoft vorkonfiguriert.

  2. Das Add-In wird nach der Zustimmung des Benutzers geladen. Es kann alle notwendigen benutzerdefinierten Informationen extrahieren und anzeigen.

    Eine Office-Anwendung mit Add-In-Schaltflächen, die im Menüband angezeigt werden.

Siehe auch