Microsoft Graph Data Connect-App-Registrierung

Dieser Artikel enthält Bewährte Methoden für die Verwendung der Azure-Portal-Benutzeroberfläche zum Registrieren einer Microsoft Entra-App bei Microsoft Graph Data Connect.

Azure-Portal Erfahrung

In der Azure-Portal können Entwickler und globale Mandantenadministratoren alle registrierten Anwendungen überprüfen, Apps autorisieren und App-Registrierungen verwalten.

Zielseite

Wichtig

Wenn Microsoft Graph Data Connect von Ihrem Administrator nicht aktiviert wurde, ist die Portaloberfläche deaktiviert. Ausführliche Informationen dazu, wie globale Administratoren Data Connect aktivieren können, finden Sie unter Aktivieren von Microsoft Graph Data Connect in Ihrem Microsoft 365-Mandanten.

Auf dem ersten Bildschirm der Azure-Portal werden Sie aufgefordert, Ihre erste App bei Data Connect zu registrieren oder vorhandene Registrierungen in eine Übersichtstabellenansicht zu laden.

Die Tabelle enthält die folgenden Spaltenfelder:

• Name: Der Name der App-Registrierung.
• App-ID: Die Microsoft Entra Anwendungs-ID.
• Registriert am: Das Datum, an dem die App registriert wurde.
• Entwickler: Der Entwickler, der die Anwendung registriert hat.
• Mehrinstanzenfähig: Gibt an, ob es sich bei der App um einen mehrinstanzenfähigen oder einen einzelnen Mandanten handelt.
• Letzte Änderung: Das letzte Datum, an dem die Anwendung geändert wurde.

Oben in der Tabelle sind standardmäßig drei Schaltflächen aktiviert: Hinzufügen, Aktualisieren und Löschen. Hinzufügen startet eine Aktion für eine neue App-Registrierung. Aktualisieren fragt vorhandene App-Registrierungen im Mandanten erneut ab und aktualisiert die Tabelle. Löschen ist nur für die Einzelauswahl aktiviert und initiiert einen Löschvorgang.

Registrieren einer neuen App

Wenn Sie eine neue App-Registrierung mit Data Connect hinzufügen, befolgen Sie den Assistenten zum Hinzufügen, um die erforderlichen Details auf den folgenden Registerkarten auszufüllen: Registrierungsinformationen, Datasets und Überprüfen und erstellen.

Seite "Registrierungsinformationen"

Auf der Seite Registrierungsinformationen werden die Standardanforderungen für App-Registrierungen beschrieben. Bei der App-Registrierung müssen Sie Einträge auswählen, die sich auf das Standardverhalten auswirken, z. B. die folgenden Felder:

• Anwendungs-ID (erforderlich): Wählen Sie Microsoft Entra Apps im Mandanten aus, oder erstellen Sie eine neue.
• Beschreibung (erforderlich): Geben Sie im Textfeld für die App-Registrierung Details wie Projektziel, eindeutiger Bezeichner und organization Projektnamen an.
• Veröffentlichungstyp (erforderlich): Wählen Sie aus den Feldern mehrinstanzenfähig oder mit einem Mandanten aus.
• Key Vault (nur für mehrinstanzenfähige App-Registrierungen erforderlich): Geben Sie den Schlüsseltresor an, der die Kommunikation zwischen Mandanten ermöglicht.
• Computetyp (erforderlich): Wählen Sie das Azure-Produktangebot für diese Anwendung aus.
• Aktivitätstyp (erforderlich): Wählen Sie die Aktivität Data Factory/Synapse/Fabric aus, die zum Kopieren der Daten verwendet wird.

Geben Sie dann die Projektdetails an – ein Prozess, der dem Erstellen einer Ressource in Azure ähnelt. Im Folgenden sind die Projektdetailsfelder aufgeführt:

• Abonnement (erforderlich): Wählen Sie ein Abonnement im Mandanten aus, das ausschließlich zum Filtern der nächsten vier Abschnitte verwendet wird, die sich auf die Konfiguration des Datenziels beziehen.

• Ressourcengruppe (erforderlich): Wählen Sie den Gruppenspeicherort für den Datenspeicher aus.

• Zieltyp: Wählen Sie den Speichertyp aus dem Azure Storage-Konto oder Azure SQL Datenbankserver aus.

  Anmerkung: Wenn Sie SQL-Datenbank Server auswählen, unterstützt Mapping Data Flows die App nur Typen. Weitere Informationen finden Sie unter Mapping Data Flows in Azure Data Factory.

• Speicherkonto (erforderlich): Wählen Sie das Speicherkonto aus, in dem sich die daten befinden, die mit Data Connect bereitgestellt werden sollen, oder erstellen Sie ein neues Azure Storage-Konto.

• Speicherkonto-URI (erforderlich): Wählen Sie in dem ausgewählten Speicherkonto den zu verwendenden URI aus (Distributed File System (DFS) oder Blob).

Hinweis

Der verknüpfte Dienst, den Sie während der Pipelineeinrichtung erstellen, sollte mit dem übereinstimmen, den Sie in den vorherigen Schritten auf der Seite Registrierungsinformationen ausgewählt haben. Wenn Sie DFS auswählen, verwenden Sie einen Azure Data Lake Storage Gen2 verknüpften Dienst, und wenn Sie blob auswählen, verwenden Sie Azure Blob Storage verknüpften Dienst.

Wenn Sie SQL für Speicherkonto auswählen, ist das Detailfeld für das URI-Projekt deaktiviert.

Hinweis

Wenn Sie Microsoft Fabric als Computetyp auswählen, unterstützt die App nur den Kopieraktivitätstyp.

• Arbeitsbereich (erforderlich): Wählen Sie den Fabric-Arbeitsbereich für Ihre Anwendung aus. Weitere Informationen finden Sie unter Fabric-Arbeitsbereiche.
• Lakehouse (erforderlich): Wählen Sie die OneLake-instance aus, in die die Daten kopiert werden sollen. Weitere Informationen finden Sie unter Fabric OneLake.

Hinweis

Wenn Sie Microsoft Fabric als Computetyp auswählen, müssen Sie einen Microsoft.GraphServices-Ressourcenanbieter für das ausgewählte Azure-Abonnement registrieren. Das ausgewählte Abonnement und die Ressourcengruppe werden für die Abrechnung verwendet. Weitere Informationen finden Sie unter Azure-Ressourcenanbieter und -Typen.

Datasets

Nachdem Sie die Seite Registrierungsinformationen abgeschlossen haben, geben Sie die Datasets an, die die App-Registrierung abfragen muss. Dieser Schritt ist für die Autorisierung von entscheidender Bedeutung. Nur die von Ihnen ausgewählten Datasets werden zur Administratorautorisierung übertragen. Weitere Informationen zu Datasets finden Sie unter Datasets, Regionen und Senken.

Der Assistent zeigt eine Tabelle an, die die Eingabe mehrerer Datasets, die Auswahl von Spalten in den Datasets und ggf. weitere Details ermöglicht, z. B. Bereichs- und Bereichsoptionen. Sie können jedes Dataset auswählen, das die App zur Autorisierung anfordert, sowie alle oder mehrere Spalten aus dem Dataset, je nach dem erforderlichen Grad an Granularität und Datenschutz.

Bereichsauswahl

Sie können den Bereich für jedes Dataset auf drei Arten konfigurieren:

• Alle Informationen: Die Standardoption. Wenn Sie das Feld leer lassen, wird der gesamte Bereich des Datasets registriert.
• Benutzer oder Gruppen im organization auswählen: Geben Sie die Objekt-IDs der Benutzer oder Gruppen durch Kommas getrennt ein. Erfahren Sie mehr über Microsoft Entra Gruppen.
• Bestimmte Prädikate: Verwenden Sie den Filtermechanismus ähnlich dem von Microsoft Graph-APIs, um einen Bereich innerhalb einer Spalte des Datasets anzugeben. Erfahren Sie mehr über die Benutzerauswahl.

Weitere Informationen zu Bereichen finden Sie unter Benutzerauswahl- und Filterfunktionen in Microsoft Graph Data Connect.

Wenn Sie fertig sind, wählen Sie Weiter : Überprüfen + erstellen aus.

Hinweis

Wenn informationen in den erforderlichen Feldern auf den vorherigen Registerkarten fehlen, ist die Schaltfläche Weiter : Überprüfen + erstellen deaktiviert.

Überprüfen + erstellen

Der letzte Schritt im Assistenten zeigt eine Zusammenfassungsseite an, auf der Sie die angegebenen Details überprüfen und die Erstellung des App-Registrierungseintrags bestätigen können.

Hinweis

Wenn Sie zuvor Microsoft Fabric als Computetyp ausgewählt haben, wird eine Ressource mit dem Typ Microsoft.GraphServices und dem Namen mgdc-your_app_id<> unter dem ausgewählten Abonnement und der ressourcengruppe registriert. Diese Ressource wird für die Abrechnung verwendet. Weitere Informationen zum Aktivieren des Microsoft.GraphServices-Ressourcenanbieters finden Sie unter Azure-Ressourcenanbieter und -typen.

Anzeigen von Details zur App-Registrierung

Nachdem Sie Ihren App-Registrierungseintrag erstellt haben, wählen Sie den App-Namen auf der Angebotsseite aus, um die von Ihnen angegebenen Details anzuzeigen. Alle bei der Erstellung angegebenen Details werden angezeigt.

Eintrag "App-Registrierung aktualisieren"

Greifen Sie über die Übersichtsseite der einzelnen Apps auf die Updatefunktionalität zu. Entweder der App-Besitzer oder der globale Administrator kann Eigenschaften oder Datasets aktualisieren, die einer Data Connect-Anwendung zugeordnet sind. Wie in den folgenden Abbildungen gezeigt, werden alle Aktualisierungen des Zielspeichers für die App oder die Datasets, Schemas oder Bereiche, die der App zugeordnet sind, die vorherige Autorisierung ungültig, und der globale Administrator muss die App erneut aus dem Microsoft 365 Admin Center genehmigen.

Hinweis

Falls noch nicht erstellt, wird eine Ressource mit dem Namen mgdc-your_app_id<> vom Typ Microsoft.GraphServices unter dem ausgewählten Abonnement und der Ressourcengruppe für den Microsoft Fabric-Computetyp registriert.

Löschen eines App-Registrierungseintrags

Sie können einen App-Registrierungseintrag entweder auf der Übersichtsseite der einzelnen App oder auf der Landing Page löschen. Derzeit können App-Besitzer oder globale Administratoren App-Registrierungseinträge löschen. Wenn Sie einen App-Registrierungseintrag löschen, müssen Sie den Namen der App eingeben, um den Löschvorgang zu bestätigen. Nachdem die App gelöscht wurde, kann jede Abhängigkeit oder Pipeline, die sie verwendet, nicht mehr verwendet werden, insbesondere:

• Jede Pipeline durchläuft mehrere Phasen. In der ersten Phase der Pipeline überprüfen wir die Zustimmung. Jede Pipeline nach der Zustimmungsüberprüfungsphase wird fortgesetzt und erfolgreich ausgeführt.
• Jede Pipeline vor der Autorisierungsüberprüfungsphase schlägt fehl, da die Anwendung fehlt.