Freigeben über


Anpassen der Browsersprache für die Authentifizierung

Gilt für: Weißer Kreis mit grauem X. Mitarbeitermandanten Grüner Kreis mit weißem Häkchen. Externe Mandanten (weitere Informationen)

Tipp

Dieser Artikel gilt für Benutzerflows in externen Mandanten. Informationen zu Mitarbeitermandanten finden Sie unter Sprachanpassung in Microsoft Entra External ID.

In diesem Artikel wird erläutert, wie Sie die Browsersprache für die Authentifizierung Ihrer App anpassen. Indem Sie den Anmeldeprozess basierend auf der Browsersprache personalisieren, können Sie eine maßgeschneiderte Benutzeroberfläche für Ihre Benutzer bereitstellen und standardmäßige Brandingeinstellungen außer Kraft setzen.

Voraussetzungen

  • Falls Sie noch nicht Ihren eigenen externen Microsoft Entra-Mandanten erstellt haben, erstellen Sie ihn jetzt.
  • Registrieren sie eine Anwendung.
  • Erstellen Sie einen Benutzerablauf.
  • Überprüfen Sie die Dateigrößenanforderungen für jedes Bild, das Sie hinzufügen möchten. Möglicherweise müssen Sie einen Foto-Editor verwenden, um die Bilder in der richtigen Größe zu erstellen. Der bevorzugte Bildtyp für alle Bilder ist PNG, JPG wird aber ebenfalls akzeptiert.

Tipp

Jetzt ausprobieren

Gehen Sie zum Ausprobieren dieses Features zur Woodgrove Groceries-Demo und starten Sie den Anwendungsfall „Sprachanpassung“.

Hinzufügen der Browsersprache unter Unternehmensbranding

  1. Melden Sie sich mindestens als Organisationsbrandingadministrator beim Microsoft Entra Admin Center an.

  2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol "Einstellungen" im oberen Menü, um zu dem externen Mandanten zu wechseln, den Sie zuvor im Menü "Verzeichnisse + Abonnements " erstellt haben.

  3. Navigieren Sie zu Unternehmensbranding>Browsersprachenanpassungen>Hinzufügen der Browsersprache.

    Screenshot der Registerkarte

  4. Wählen Sie auf der Registerkarte " Grundlagen " unter "Sprachspezifische Benutzeroberflächenanpassung" die Browsersprache aus, die Sie im Menü anpassen möchten.

    Screenshot der Auswahl einer Sprache.

Die folgenden Sprachen werden im externen Mandanten unterstützt:

  • Arabisch (Saudi-Arabien)
  • Baskisch (Baskisch)
  • Bulgarisch (Bulgarien)
  • Katalanisch (Katalanisch)
  • Chinesisch (China)
  • Chinesisch (Hongkong SAR)
  • Kroatisch (Kroatien)
  • Tschechisch (Tschechien)
  • Dänisch (Dänemark)
  • Niederländisch (Niederlande)
  • Englisch (Vereinigte Staaten)
  • Estnisch (Estland)
  • Finnisch (Finnland)
  • Französisch (Frankreich)
  • Galicisch (Galicisch)
  • Deutsch (Deutschland)
  • Griechisch (Griechenland)
  • Hebräisch (Israel)
  • Ungarisch (Ungarn)
  • Italienisch (Italien)
  • Japanisch (Japan)
  • Kasachisch (Kasachstan)
  • Koreanisch (Korea)
  • Lettisch (Lettland)
  • Litauisch (Litauen)
  • Norwegisch, Bokmål (Norwegen)
  • Polnisch (Polen)
  • Portugiesisch (Brasilien)
  • Portugiesisch (Portugal)
  • Rumänisch (Rumänien)
  • Russisch (Russland)
  • Serbisch (Lateinisch, Serbien)
  • Slowakisch (Slowakei)
  • Slowenisch (Slowenien)
  • Spanisch (Spanien)
  • Schwedisch (Schweden)
  • Thailändisch (Thailand)
  • Türkisch (Türkiye)
  • Ukrainisch (Ukraine)
  1. Passen Sie die Elemente auf den Registerkarten "Grundlagen", "Layout", "Kopfzeile", "Fußzeile", "Anmeldeformular" und "Text" an. Ausführliche Anweisungen finden Sie unter Anpassen des Brandings und der Endbenutzerumgebung.
  2. Wenn Sie fertig sind, wählen Sie die Registerkarte " Überprüfen " aus, und durchlaufen Sie alle Ihre Sprachanpassungen. Wählen Sie dann "Hinzufügen" aus, wenn Sie Ihre Änderungen oder "Zurück " speichern möchten, wenn Sie die Bearbeitung fortsetzen möchten.

Hinzufügen der Sprachanpassung zu einem Benutzerflow

Die Sprachanpassung im externen Mandanten ermöglicht es Ihrem Benutzerfluss, verschiedene Sprachen zu berücksichtigen, um den Anforderungen Ihrer Kunden gerecht zu werden. Sie können mithilfe von Sprachen die Zeichenfolgen anpassen, die Ihren Kunden während der Registrierung im Rahmen der Attributerfassung angezeigt werden.

  1. Melden Sie sich im Microsoft Entra Admin Center als mindestens ein Organisations-Branding-Administrator an.

  2. Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol "Einstellungen" im oberen Menü, um zu dem externen Mandanten zu wechseln, den Sie zuvor im Menü "Verzeichnisse + Abonnements " erstellt haben.

  3. Navigieren Sie zu Entra-ID>Externe Identitäten>Benutzerflüsse.

  4. Wählen Sie den Benutzerflow aus, den Sie für Übersetzungen aktivieren möchten.

  5. Wählen Sie "Sprachen" aus.

  6. Wählen Sie auf der Seite "Sprachen " für den Benutzerablauf die Sprache aus, die Sie anpassen möchten.

  7. Erweitern Sie Registrierung und Anmeldung.

  8. Wählen Sie "Standardwerte herunterladen" aus (oder "Außerkraftsetzungen herunterladen" , wenn Sie diese Sprache zuvor bearbeitet haben).

    Screenshot, der zeigt, wie Sprachen unter einem Benutzerablauf hinzugefügt werden.

Die heruntergeladene Datei liegt im JSON-Format vor und enthält sowohl integrierte als auch benutzerdefinierte Attribute sowie andere Seiten- und Fehlerzeichenfolgen:

{
	"AttributeCollection_Description": "Wir benötigen nur ein paar weitere Informationen, um Ihr Konto einzurichten.",
	"AttributeCollection_Title": "Details hinzufügen",
	"Attribute_City": "Ort",
	"Attribute_Country": "Land/Region",
	"Attribute_DisplayName": "Anzeigename",
	"Attribute_Email": "E-Mail-Adresse",
	"Attribute_Generic_ConfirmationLabel": "{0} erneut eingeben",
	"Attribute_GivenName": "Vorname",
	"Attribute_JobTitle": "Position",
	"Attribute_Password": "Kennwort",
	"Attribute_Password_MismatchErrorString": "Kennwörter stimmen nicht überein.",
	"Attribute_PostalCode": "Postleitzahl",
	"Attribute_State": "Bundesland/Kanton",
	"Attribute_StreetAddress": "Straße",
	"Attribute_Surname": "Nachname",
	"SignIn_Description": "Melden Sie sich an, um auf {0} zuzugreifen.",
	"SignIn_Title": "Anmelden",
	"SignUp_Description": "Registrieren Sie sich, um auf {0} zuzugreifen.",
	"SignUp_Title": "Konto erstellen",
	"SisuOtc_Title": "Code eingeben",
	"Attribute_extension_a235ca9a0a7c4d33bd69e07bed81c8b1_Shoesize": "Shoe size"
}  

Sie können jedes oder alle dieser Attribute in der heruntergeladenen Datei ändern. Sie können z. B. das integrierte Attribut "City " und das benutzerdefinierte Attribut " Shoesize" ändern:

{
	"AttributeCollection_Description": "Wir benötigen nur ein paar weitere Informationen, um Ihr Konto einzurichten.",
	"AttributeCollection_Title": "Details hinzufügen",
	"Attribute_City": "Ort2",
	"Attribute_Country": "Land/Region",
	"Attribute_DisplayName": "Anzeigename",
	"Attribute_Email": "E-Mail-Adresse",
	"Attribute_Generic_ConfirmationLabel": "{0} erneut eingeben",
	"Attribute_GivenName": "Vorname",
	"Attribute_JobTitle": "Position",
	"Attribute_Password": "Kennwort",
	"Attribute_Password_MismatchErrorString": "Kennwörter stimmen nicht überein.",
	"Attribute_PostalCode": "Postleitzahl",
	"Attribute_State": "Bundesland/Kanton",
	"Attribute_StreetAddress": "Straße",
	"Attribute_Surname": "Nachname",
	"SignIn_Description": "Melden Sie sich an, um auf {0} zuzugreifen.",
	"SignIn_Title": "Anmelden",
	"SignUp_Description": "Registrieren Sie sich, um auf {0} zuzugreifen.",
	"SignUp_Title": "Konto erstellen",
	"SisuOtc_Title": "Code eingeben",
	"Attribute_extension_a235ca9a0a7c4d33bd69e07bed81c8b1_Shoesize": "Schuhgröße"
}  
  1. Nachdem Sie die erforderlichen Änderungen vorgenommen haben, können Sie die neue Außerkraftsetzungsdatei hochladen. Die Änderungen werden automatisch in Ihrem Benutzerflow gespeichert. Die Überschreibung wird auf der Registerkarte Konfiguriert angezeigt.
  2. Um Ihre Änderungen zu überprüfen, wählen Sie die Sprache auf der Registerkarte " Konfiguriert " aus, und erweitern Sie die Option " Registrieren und Anmelden ". Sie können Ihre angepasste Sprachdatei anzeigen, indem Sie Außerkraftsetzungen herunterladenauswählen. Um die benutzerdefinierte Außerkraftsetzungsdatei zu entfernen, wählen Sie Außerkraftsetzungen entfernen aus.

Screenshot, der zeigt, wie Die geänderte JSON-Datei entfernt oder heruntergeladen wird.

  1. Wechseln Sie zur Anmeldeseite Ihres externen Mandanten. Stellen Sie sicher, dass Sie das richtige Gebietsschema und den richtigen Markt in Ihren URLs haben, z. B.: ui_locales=de-DE und mkt=de-DE. Die aktualisierten Attribute auf der Registrierungsseite werden wie folgt angezeigt:

Screenshot der geänderten Anmeldeseitenattribute.

Wichtig

Im externen Mandanten stehen zwei Optionen zum Hinzufügen von benutzerdefiniertem Text zur Registrierungs- und Anmeldeerfahrung zur Auswahl. Die Funktion steht unter jedem Benutzerfluss während der Sprachanpassung und unter Unternehmensbranding zur Verfügung. Obwohl wir zwei Möglichkeiten haben, Zeichenfolgen (über Das Unternehmensbranding und über Benutzerflüsse) anzupassen, ändern beide Methoden dieselbe JSON-Datei. Die letzte Änderung, die entweder über Benutzerflüsse oder über das Unternehmensbranding vorgenommen wurde, überschreibt immer die vorherige Änderung.

Unterstützung für von rechts nach links-Sprachen

Sprachen, die von rechts nach links gelesen werden, z. B. Arabisch und Hebräisch, werden in der entgegengesetzten Richtung im Vergleich zu Sprachen angezeigt, die von links nach rechts gelesen werden. Der extern Mandant unterstützt von rechts nach links-Funktionen und Features für Sprachen, die in einer von rechts nach links-Umgebung zum Eingeben und Anzeigen von Daten funktionieren. Personen, die von rechts nach links lesen, können in ihrer natürlichen Leseweise interagieren.

Screenshot der Sprachunterstützung von rechts nach links.

Entfernen der Browsersprachanpassung

Wenn sie nicht mehr benötigt wird, können Sie die Sprachanpassung aus Ihrem externen Mandanten im Admin Center oder mit der Microsoft Graph-API entfernen.

Entfernen der Sprachanpassung im Admin Center

  1. Melden Sie sich beim Microsoft Entra Admin Center an.

  2. Navigieren Sie zuUnternehmensbranding-Browsersprachenanpassungen>

  3. Wählen Sie die Sprache aus, die Sie löschen möchten, und wählen Sie dann "Löschen" und " OK" aus.

    Screenshot der Registerkarte

Entfernen der Sprachanpassung mit der Microsoft Graph-API

  1. Melden Sie sich mit Ihrem externen Mandantenkonto beim MS Graph-Explorer an: https://developer.microsoft.com/en-us/graph/graph-explorer?tenant=<your-tenant-name.onmicrosoft.com>.

  2. Fragen Sie das standardmäßige Brandingobjekt ab, indem Sie die Microsoft Graph-API verwenden: https://graph.microsoft.com/v1.0/organization/<your-tenant-ID>/branding/localizations. Um zu bestätigen, dass Sie bei Ihrem externen Mandanten angemeldet sind, überprüfen Sie den Namen des Mandanten auf der rechten Seite des Bildschirms.

  3. Entfernen Sie das lokalisierte Brandingobjekt.

    Screenshot der MS Graph-API mit einem angemeldeten CIAM-Mandanten.

  4. Warten Sie ein paar Minuten, bis die Änderungen wirksam werden.

Nächste Schritte