Konfigurieren der Herausgeberdomäne einer App
Die Herausgeberdomäne einer App informiert Benutzer darüber, wohin ihre Informationen gesendet werden. Die Herausgeberdomäne fungiert auch als Eingabe oder Voraussetzung für Herausgeberüberprüfung. Je nachdem, wann die App registriert wurde, und abhängig vom Status der Herausgeberüberprüfung, wird die Herausgeberdomäne dem Benutzer direkt in der Einwilligungsaufforderung der Anwendung angezeigt. Die Herausgeberdomäne einer Anwendung wird Benutzern (abhängig vom Status der Herausgeberüberprüfung) auf der Einwilligungsoberfläche angezeigt, um Benutzern aus Gründen der Vertrauenswürdigkeit mitzuteilen, wohin ihre Informationen gesendet werden.
In der Zustimmungsaufforderung einer App wird entweder die Herausgeberdomäne oder der Überprüfungsstatus des Herausgebers angezeigt. Welche Informationen angezeigt werden, hängt davon ab, ob es sich bei der App um eine mehrinstanzenfähige App handelt, wann die App registriert wurde und welchen Überprüfungsstatus des Herausgebers die App aufweist.
Grundlegendes zu mehrinstanzenfähigen Apps
Eine mehrinstanzenfähige App unterstützt Benutzerkonten, die sich außerhalb eines einzelnen Organisationsverzeichnisses befinden. Eine mehrinstanzenfähige App kann beispielsweise alle Geschäfts-, Schul- oder Unikonten von Microsoft Entra oder sowohl Geschäfts-, Schul- oder Unikonten von Microsoft Entra als auch persönliche Microsoft-Konten unterstützen.
Grundlegendes zu Standardwerten für die Herausgeberdomäne
Mehrere Faktoren bestimmen den Standardwert, der für die Herausgeberdomäne einer App festgelegt ist:
- Angabe, ob die App in einem Mandanten registriert ist
- Angabe, ob ein Mandant über mandantenseitig überprüfte Domänen verfügt
- Datum der App-Registrierung
Mandantenregistrierung und mandantenseitig überprüfte Domänen
Wenn Sie eine neue App registrieren, wird die Herausgeberdomäne der App möglicherweise auf einen Standardwert festgelegt. Der Standardwert hängt davon ab, wo die App registriert ist. Der Wert für die Herausgeberdomäne hängt insbesondere davon ab, ob die App in einem Mandanten registriert ist und ob der Mandant über mandantenseitig überprüfte Domänen verfügt.
Wenn mandantenseitig überprüfte Domänen vorhanden sind, ist die Herausgeberdomäne der App standardmäßig die primäre überprüfte Domäne des Mandanten. Wenn die App keine mandantenseitig überprüfte Domänen besitzt und nicht in einem Mandanten registriert ist, lautet der Standardwert der Herausgeberdomäne NULL.
In der folgenden Tabelle werden Beispielszenarien verwendet, um die Standardwerte für die Herausgeberdomäne zu beschreiben:
Mandantenseitig überprüfte Domäne | Standardwert der Herausgeberdomäne |
---|---|
NULL | NULL |
*.onmicrosoft.com |
*.onmicrosoft.com |
- *.onmicrosoft.com - domain1.com - domain2.com (primär) |
domain2.com |
Datum der App-Registrierung
Das Registrierungsdatum einer App bestimmt auch die Standardwerte für die Herausgeberdomäne der App.
Wenn Ihre mehrinstanzenfähige Anwendung zwischen dem 21. Mai 2019 und dem 30. November 2020 registriert wurde:
- Wenn die Herausgeberdomäne der App nicht festgelegt ist oder auf eine Domäne festgelegt ist, die auf
.onmicrosoft.com
endet, zeigt die Zustimmungsaufforderung der App Nicht überprüft als Wert für die Herausgeberdomäne an. - Wenn die App über eine überprüfte App-Domäne verfügt, zeigt die Zustimmungsaufforderung die überprüfte Domäne an.
- Wenn der Herausgeber der App überprüft wurde, zeigt die Herausgeberdomäne ein blaues Überprüft-Symbol an, das den Status angibt.
Wenn Ihre mehrinstanzenfähige Anwendung nach dem 30. November 2020 registriert wurde:
- Wenn der App-Herausgeber nicht überprüft wurde, zeigt die Zustimmungsaufforderung für die App Nicht überprüft an. Es werden keine Informationen zur Herausgeberdomäne angezeigt.
- Wenn der App-Herausgeber überprüft wurde, zeigt die Zustimmungsaufforderung der App ein blaues Überprüft-Symbol an.
Vor dem 21. Mai 2019 erstellte Apps
Wenn Ihre App vor dem 21. Mai 2019 registriert wurde, zeigt die Zustimmungsaufforderung Ihrer App Nicht überprüft an, auch wenn Sie keine Herausgeberdomäne festgelegt haben. Es wird empfohlen, den Wert der Herausgeberdomäne festzulegen, sodass Benutzer diese Informationen in der Zustimmungsaufforderung der App sehen können.
Festlegen einer Herausgeberdomäne im Microsoft Entra Admin Center
Tipp
Die Schritte in diesem Artikel können je nach dem Portal, mit dem Sie beginnen, geringfügig variieren.
So legen Sie über das Microsoft Entra Admin Center eine Herausgeberdomäne für Ihre App fest:
Melden Sie sich beim Microsoft Entra Admin Center an.
Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol
für Einstellungen rechts oben, und wählen Sie im Menü Verzeichnisse + Abonnements den Mandanten aus, bei dem die App registriert ist.
Durchsuchen Sie im Microsoft Entra Admin Center Identität>Anwendungen>App-Registrierungen.
Suchen Sie nach der App, die Sie konfigurieren möchten, und wählen Sie sie aus.
Wählen Sie unter Übersicht im Ressourcenmenü unterhalb von Verwalten den Eintrag Branding aus.
Wählen Sie für Herausgeberdomäne eine der folgenden Optionen aus:
- Wenn Sie noch keine Domäne konfiguriert haben, wählen Sie Domäne konfigurieren aus.
- Wenn Sie eine Domäne konfiguriert haben, wählen Sie Domäne aktualisieren aus.
Wenn Ihre App in einem Mandanten registriert ist, wählen Sie als Nächstes eine aus zwei Optionen aus:
- Verifizierte Domäne auswählen
- Neue Domäne verifizieren
Wenn Ihre Domäne in keinem Mandanten registriert ist, wird nur die Option zum Überprüfen einer neuen Domäne für Ihre App angezeigt.
Überprüfen einer neuen Domäne für Ihre App
So überprüfen Sie eine neue Herausgeberdomäne für Ihre App:
Erstellen Sie eine Datei mit dem Namen microsoft-identity-association.json. Kopieren Sie den folgenden JSON-Code, und fügen Sie ihn in die Datei microsoft-identity-association.json ein:
{ "associatedApplications": [ { "applicationId": "<your-app-id>" }, { "applicationId": "<another-app-id>" } ] }
Ersetzen Sie
<your-app-id>
durch die Anwendungs- bzw. Client-ID für Ihre App. Verwenden Sie alle relevanten App-IDs, wenn Sie eine neue Domäne für mehrere Apps überprüfen.Hosten Sie die Datei unter
https://<your-domain>.com/.well-known/microsoft-identity-association.json
. Ersetzen Sie<your-domain>
durch den Namen der überprüften Domäne.Wählen Sie Domäne überprüfen und speichern aus.
Nachdem Sie eine Domäne überprüft haben, müssen Sie die für die Überprüfung verwendeten Ressourcen nicht verwalten. Nach Abschluss der Überprüfung können Sie die gehostete Datei entfernen.
Auswählen einer überprüften Domäne
Wenn Ihr Mandant überprüfte Domänen enthält, wählen Sie eine der Domänen in der Dropdownliste Verifizierte Domäne auswählen aus.
Hinweis
Der Inhalt wird für die Deserialisierung als UTF-8-JSON interpretiert. Unterstützte Content-Type
-Header, die zurückgegeben werden sollten, sind application/json
, application/json; charset=utf-8
oder
. Wenn Sie einen anderen Header verwenden, wird möglicherweise diese Fehlermeldung angezeigt:
Verification of publisher domain failed. Error getting JSON file from https:///.well-known/microsoft-identity-association. The server returned an unexpected content type header value.
Herausgeberdomäne und Zustimmungsaufforderung für die App
Die Konfiguration der Herausgeberdomäne hat Einfluss darauf, was Benutzer in der Zustimmungsaufforderung der App sehen. Weitere Informationen zu den Komponenten der Zustimmungsaufforderung finden Sie unter Grundlegendes zu Einwilligungserfahrungen für Azure AD-Anwendungen.
Die folgende Abbildung zeigt, wie die Herausgeberdomäne in App-Zustimmungsaufforderungen für Apps angezeigt wird, die vor dem 21. Mai 2019 erstellt wurden:
Bei Apps, die zwischen dem 21. Mai 2019 und dem 30. November 2020 erstellt wurden, hängt die Anzeige der Herausgeberdomäne in der Zustimmungsaufforderung der App von der Herausgeberdomäne und der Art der App ab. Die folgende Abbildung zeigt, was bei verschiedenen Konfigurationen in der Zustimmungsaufforderung angezeigt wird:
Bei Mehrinstanzen-Apps, die nach dem 30. November 2020 erstellt wurden, wird in der Zustimmungsaufforderung einer App nur der Überprüfungsstatus des Herausgebers angezeigt. In der folgenden Tabelle wird beschrieben, was je nach Überprüfungsstatus einer App in der Zustimmungsaufforderung angezeigt wird. Die Zustimmungsaufforderung für Einzelmandanten-Apps bleibt unverändert.
Herausgeberdomäne und Umleitungs-URIs
Apps, die Benutzer mithilfe eines Geschäfts-, Schul- oder Unikontos oder mithilfe eines Microsoft-Kontos (mehrinstanzenfähig) anmelden, unterliegen einigen Einschränkungen hinsichtlich Umleitungs-URIs.
Beschränkung auf einzelne Stammdomäne
Wenn der Herausgeberdomänenwert für eine Mehrinstanzen-App auf NULL festgelegt ist, ist die App auf die Freigabe einer einzelnen Stammdomäne für die Umleitungs-URIs beschränkt. Die folgende Kombination von Werten ist z. B. nicht zulässig, da die Stammdomäne contoso.com
nicht mit der Stammdomäne fabrikam.com
übereinstimmt.
"https://contoso.com",
"https://fabrikam.com",
Einschränkungen für Unterdomänen
Unterdomänen sind zulässig, Sie müssen jedoch die Stammdomäne explizit registrieren. Obwohl die folgenden URIs eine einzelne Stammdomäne verwenden, ist die folgende Kombination z. B. nicht zulässig:
"https://app1.contoso.com",
"https://app2.contoso.com",
Wenn entwicklerseitig die Stammdomäne jedoch explizit hinzugefügt wird, ist die Kombination zulässig:
"https://contoso.com",
"https://app1.contoso.com",
"https://app2.contoso.com",
Ausnahmen bei Einschränkungen
In den folgenden Fällen gilt die Beschränkung auf eine einzelne Stammdomäne nicht:
- Apps mit einem einzelnen Mandanten oder Apps für Konten in einem einzelnen Verzeichnis
- Verwendung von „localhost“ als Umleitungs-URIs
- Umleitungs-URIs mit benutzerdefinierten Schemas (nicht HTTP oder HTTPS).
Programmgesteuertes Konfigurieren der Herausgeberdomäne
Derzeit können Sie weder eine REST-API noch PowerShell verwenden, um eine Herausgeberdomäne programmgesteuert festzulegen.
Nächste Schritte
- Erfahren Sie, wie Sie eine App als durch den Herausgeber verifiziert markieren.
- Lesen Sie den Artikel Problembehandlung bei der Herausgeberüberprüfung.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für