Erstellen von PHP-Apps mit Microsoft Graph - Microsoft Graph

In diesem Lernprogramm erfahren Sie, wie Sie eine PHP-Konsolen-App erstellen, die die Microsoft Graph-API verwendet.

Tipp

Wenn Sie nur das abgeschlossene Lernprogramm herunterladen möchten, können Sie das GitHub-Repository herunterladen oder klonen.

Voraussetzungen

Bevor Sie mit diesem Lernprogramm beginnen, sollten Sie PHP und Composer auf Ihrem Entwicklungscomputer installiert haben.

Außerdem sollten Sie entweder über ein persönliches Microsoft-Konto mit einem Postfach auf Outlook.com oder über ein Microsoft-Geschäfts-, Schul- oder Unikonto verfügen. Wenn Sie nicht über ein Microsoft-Konto verfügen, gibt es eine Reihe von Optionen, um ein kostenloses Konto zu erhalten:

Sie können sich für ein neues persönliches Microsoft-Konto registrieren.
Sie können sich für das Microsoft 365-Entwicklerprogramm registrieren, um ein kostenloses Microsoft 365-Abonnement zu erhalten.

Hinweis

Dieses Lernprogramm wurde mit PHP Version 8.1.5 und Composer Version 2.3.5 geschrieben. Die Schritte in diesem Handbuch funktionieren möglicherweise mit anderen Versionen, die jedoch nicht getestet wurden.

Registrieren der App im Portal

45 Minuten verbleibend

In dieser Übung registrieren Sie eine neue Anwendung in Azure Active Directory, um die Benutzerauthentifizierung zu aktivieren. Sie können eine Anwendung über das Azure Active Directory Admin Center oder über das Microsoft Graph PowerShell SDK registrieren.

Registrieren der Anwendung für die Benutzerauthentifizierung

In diesem Abschnitt registrieren Sie eine Anwendung, die die Benutzerauthentifizierung mithilfe des Gerätecodeflusses unterstützt.

Azure AD Admin Center
PowerShell

Öffnen Sie einen Browser, und navigieren Sie zum Azure Active Directory Admin Center. Melden Sie sich mit einem persönlichen Konto (auch: Microsoft-Konto) oder einem Geschäfts- oder Schulkonto an.
Wählen Sie in der linken Navigationsleiste Azure Active Directory aus, und wählen Sie dann App-Registrierungen unter Verwalten aus.
Wählen Sie Neue Registrierung aus. Geben Sie einen Namen für Ihre Anwendung ein, PHP Graph Tutorialz. B. .

Legen Sie unterstützte Kontotypen wie gewünscht fest. Mögliche Optionen:

Option	Wer können sich anmelden?
Nur Konten in diesem Organisationsverzeichnis	Nur Benutzer in Ihrer Microsoft 365 Organisation
Konten in einem beliebigen Organisationsverzeichnis	Benutzer in einer beliebigen Microsoft 365 Organisation (Geschäfts-, Schul- oder Unikonten)
Konten in einem beliebigen Organisationsverzeichnis ... und persönlichen Microsoft-Konten	Benutzer in einer beliebigen Microsoft 365 Organisation (Geschäfts-, Schul- oder Unikonten) und persönlichen Microsoft-Konten

Lassen Sie URI umleiten leer.
Wählen Sie Registrieren aus. Kopieren Sie auf der Seite "Übersicht " der Anwendung den Wert der Anwendungs-ID (Client-ID), und speichern Sie ihn. Sie benötigen ihn im nächsten Schritt. Wenn Sie "Konten" in diesem Organisationsverzeichnis nur für unterstützte Kontotypen ausgewählt haben, kopieren Sie auch die Verzeichnis-ID (Mandanten-ID), und speichern Sie sie.
Wählen Sie unter Verwalten die Option Authentifizierung aus. Suchen Sie den Abschnitt "Erweiterte Einstellungen" , und ändern Sie den Umschalter " Öffentliche Clientflüsse zulassen " in "Ja", und wählen Sie dann "Speichern" aus.

Zur Verwendung von PowerShell benötigen Sie das Microsoft Graph PowerShell SDK. Wenn Sie es nicht haben, finden Sie installationsanweisungen unter Installieren des Microsoft Graph PowerShell SDK.

Wichtig

Das PowerShell-Skript erfordert ein Geschäfts-/Schulkonto beim Anwendungsadministrator, Cloudanwendungsadministrator oder globaler Administrator Rolle. Wenn Ihr Konto über die Anwendungsentwicklerrolle verfügt, können Sie sich im Azure AD Admin Center registrieren.

Erstellen Sie eine neue Datei mit dem Namen RegisterAppForUserAuth.ps1 , und fügen Sie den folgenden Code hinzu.
Speichern Sie die Datei.
Öffnen Sie PowerShell, und ändern Sie das aktuelle Verzeichnis in den Speicherort von RegisterAppForUserAuth.ps1.

Führen Sie den folgenden Befehl aus, und ersetzen Sie den <Zielgruppenwert> durch den gewünschten Wert (siehe Tabelle unten).

.\RegisterAppForUserAuth.ps1 -AppName "PHP Graph Tutorial" -SignInAudience <audience-value>

SignInAudience-Wert	Wer können sich anmelden?
`AzureADMyOrg`	Nur Benutzer in Ihrer Microsoft 365 Organisation
`AzureADMultipleOrgs`	Benutzer in einer beliebigen Microsoft 365 Organisation (Geschäfts-, Schul- oder Unikonten)
`AzureADandPersonalMicrosoftAccount`	Benutzer in einer beliebigen Microsoft 365 Organisation (Geschäfts-, Schul- oder Unikonten) und persönlichen Microsoft-Konten
`PersonalMicrosoftAccount`	Nur persönliche Microsoft-Konten

Folgen Sie der Aufforderung, um in einem Browser zu öffnen https://microsoft.com/devicelogin , geben Sie den bereitgestellten Code ein, und schließen Sie den Authentifizierungsprozess ab.
Kopieren Sie die Client-ID - und Auth-Mandantenwerte aus der Skriptausgabe. Sie benötigen diese Werte im nächsten Schritt.
```
SUCCESS
Client ID: 2fb1652f-a9a0-4db9-b220-b224b8d9d38b
Auth tenant: common
```

Hinweis

Beachten Sie, dass Sie keine Microsoft Graph-Berechtigungen für die App-Registrierung konfiguriert haben. Dies liegt daran, dass im Beispiel die dynamische Zustimmung verwendet wird, um bestimmte Berechtigungen für die Benutzerauthentifizierung anzufordern.

Erstellen einer PHP-Konsolen-App

40 Minuten verbleibend

Beginnen Sie mit der Initialisierung eines neuen Composer Projekts. Öffnen Sie die Befehlszeilenschnittstelle (CLI) in einem Verzeichnis, in dem Sie das Projekt erstellen möchten. Führen Sie den folgenden Befehl aus.

composer init

Beantworten Sie die Eingabeaufforderungen. Sie können die Standardwerte für die meisten Fragen akzeptieren, aber auf Folgendes antworten n :

Would you like to define your dependencies (require) interactively [yes]? n
Would you like to define your dev dependencies (require-dev) interactively [yes]? n
Add PSR-4 autoload mapping? Maps namespace "Microsoft\Graphtutorial" to the entered relative path. [src/, n to skip]: n

Installieren von Abhängigkeiten

Fügen Sie vor dem Fortfahren einige zusätzliche Abhängigkeiten hinzu, die Sie später verwenden werden.

Microsoft Graph SDK für PHP zum Aufrufen der Microsoft Graph.
vlucas/phpdotenv zum Lesen von Umgebungsvariablen aus env-Dateien.

Führen Sie den folgenden Befehl in Ihrer CLI aus, um die Abhängigkeiten zu installieren.

composer require microsoft/microsoft-graph vlucas/phpdotenv

Laden von Anwendungseinstellungen

In diesem Abschnitt fügen Sie dem Projekt die Details ihrer App-Registrierung hinzu.

Erstellen Sie eine Datei im Stammverzeichnis Ihres Projekts namens ".env ", und fügen Sie den folgenden Code hinzu.

Aktualisieren Sie die Werte gemäß der folgenden Tabelle.

Einstellung	Wert
`CLIENT_ID`	Die Client-ID Ihrer App-Registrierung
`AUTH_TENANT`	Wenn Sie die Option ausgewählt haben, dass sich nur Benutzer in Ihrer Organisation anmelden können, ändern Sie diesen Wert in Ihre Mandanten-ID. Andernfalls belassen als `common`.

Wichtig

Wenn Sie die Quellcodeverwaltung wie Git verwenden, wäre es jetzt ein guter Zeitpunkt, die ENV-Datei aus der Quellcodeverwaltung auszuschließen, um zu verhindern, dass Ihre App-ID versehentlich ausläuft.

Entwerfen der App

In diesem Abschnitt erstellen Sie ein einfaches konsolenbasiertes Menü.

Erstellen Sie eine Datei im Stammverzeichnis Ihres Projekts mit dem Namen "main.php". Fügen Sie die öffnenden und schließenden PHP-Tags hinzu.
```
<?php
?>
```
Fügen Sie den folgenden Code zwischen den PHP-Tags hinzu.

Fügen Sie die folgenden Platzhaltermethoden am Ende der Datei vor dem schließenden PHP-Tag hinzu. Sie implementieren sie in späteren Schritten.

function initializeGraph(): void {
    // TODO
}

function greetUser(): void {
    // TODO
}

function displayAccessToken(): void {
    // TODO
}

function listInbox(): void {
    // TODO
}

function sendMail(): void {
    // TODO
}

function listUsers(): void {
    // TODO
}

function makeGraphCall(): void {
    // TODO
}

Dadurch wird ein einfaches Menü implementiert und die Auswahl des Benutzers über die Befehlszeile gelesen.

Hinzufügen der Benutzerauthentifizierung

35 Minuten verbleibend

In diesem Abschnitt erweitern Sie die Anwendung aus der vorherigen Übung, um die Authentifizierung mit Azure AD zu unterstützen. Dies ist erforderlich, um das erforderliche OAuth-Zugriffstoken zum Aufrufen der Microsoft Graph abzurufen.

Konfigurieren Graph Clients für die Benutzerauthentifizierung

In diesem Abschnitt verwenden Sie die GuzzleHttp\Client Klasse, um ein Zugriffstoken mithilfe des Gerätecodeflusses anzufordern.

Erstellen Sie eine neue Datei im Stammverzeichnis Ihres Projekts mit dem Namen "GraphHelper.php". Fügen Sie den folgenden Code hinzu.

<?php
use Microsoft\Graph\Graph;
use Microsoft\Graph\Http;
use Microsoft\Graph\Model;
use GuzzleHttp\Client;

class GraphHelper {
}
?>

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere initializeGraph Funktion in "main.php " durch Folgendes.

Dieser Code lädt Informationen aus der ENV-Datei und initialisiert zwei Eigenschaften, ein Client Objekt und ein Graph Objekt. Das Client Objekt wird verwendet, um ein Zugriffstoken anzufordern, und das Graph Objekt wird verwendet, um Aufrufe an Microsoft Graph zu senden.

Testen von DeviceCodeCredential

Fügen Sie als Nächstes Code hinzu, um ein Zugriffstoken vom GraphHelper.

Fügen Sie die folgende Funktion zur GraphHelper-Klasse hinzu:
Ersetzen Sie die leere displayAccessToken Funktion in "main.php " durch Folgendes.

Erstellen sie die App, und führen Sie sie aus. Geben Sie 1 die Eingabetaste ein, wenn Sie zur Eingabe einer Option aufgefordert werden. Die Anwendung zeigt eine URL und einen Gerätecode an.

$ php main.php

PHP Graph Tutorial

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. List users (requires app-only)
5. Make a Graph call
1
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and
enter the code RB2RUD56D to authenticate.

Öffnen Sie einen Browser, und navigieren Sie zu der angezeigten URL. Geben Sie den bereitgestellten Code ein, und melden Sie sich an.

Wichtig

Achten Sie auf alle vorhandenen Microsoft 365-Konten, die beim Surfen https://microsoft.com/deviceloginin Ihrem Browser angemeldet sind. Verwenden Sie Browserfeatures wie Profile, Gastmodus oder privaten Modus, um sicherzustellen, dass Sie sich als das Konto authentifizieren, das Sie zum Testen verwenden möchten.
Kehren Sie nach Abschluss der Anwendung zurück, um das Zugriffstoken anzuzeigen.

Tipp

Nur zu Überprüfungs- und Debugzwecken können Sie Benutzerzugriffstoken (nur für Geschäfts-, Schul- oder Unikonten) mithilfe des Onlinetokenparsers von Microsoft unter https://jwt.msdecodieren. Dies kann hilfreich sein, wenn beim Aufrufen von Microsoft Graph Tokenfehler auftreten. Überprüfen Sie beispielsweise, ob der scp Anspruch im Token die erwarteten Microsoft Graph Berechtigungsbereiche enthält.

Benutzer abrufen

30 Minuten verbleibend

In diesem Abschnitt integrieren Sie die Microsoft Graph in die Anwendung. Für diese Anwendung verwenden Sie das Microsoft Graph SDK für PHP, um Aufrufe an Microsoft Graph zu senden.

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere greetUser Funktion in "main.php " durch Folgendes.

Wenn Sie die App jetzt ausführen, werden Sie nach der Anmeldung in der App mit dem Namen begrüßt.

Hello, Megan Bowen!
Email: MeganB@contoso.com

Code erklärt

Betrachten Sie den Code in der getUser Funktion. Es sind nur ein paar Zeilen, aber es gibt einige wichtige Details zu beachten.

Zugreifen auf "Ich"

Die Funktion erstellt eine Anforderung an die Get-Benutzer-API . Auf diese API kann auf zwei Arten zugegriffen werden:

GET /me
GET /users/{user-id}

In diesem Fall ruft der Code den GET /me API-Endpunkt auf. Dies ist eine Verknüpfungsmethode zum Abrufen des authentifizierten Benutzers, ohne dessen Benutzer-ID zu kennen.

Hinweis

Da der GET /me API-Endpunkt den authentifizierten Benutzer abruft, ist er nur für Apps verfügbar, die die Benutzerauthentifizierung verwenden. Nur-App-Authentifizierungs-Apps können nicht auf diesen Endpunkt zugreifen.

Anfordern bestimmter Eigenschaften

Die Funktion verwendet den $select Abfrageparameter , um den benötigten Eigenschaftensatz anzugeben.

Stark typisierter Rückgabetyp

Die Funktion gibt ein User Objekt zurück, das aus der JSON-Antwort der API deserialisiert wurde. Da der Code verwendet $select, haben nur die angeforderten Eigenschaften Werte im zurückgegebenen User Objekt. Alle anderen Eigenschaften haben Standardwerte.

Posteingang auflisten

25 Minuten verbleibend

In diesem Abschnitt fügen Sie die Möglichkeit hinzu, Nachrichten im E-Mail-Posteingang des Benutzers auflisten zu können.

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere listInbox Funktion in "main.php " durch Folgendes.

Führen Sie die App aus, melden Sie sich an, und wählen Sie Option 2 aus, um Ihren Posteingang auflisten.

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. List users (requires app-only)
5. Make a Graph call
2
Message: Updates from Ask HR and other communities
  From: Contoso Demo on Yammer
  Status: Read
  Received: Mon, 18 Apr 2022 14:24:16 +0000
Message: Employee Initiative Thoughts
  From: Patti Fernandez
  Status: Read
  Received: Mon, 18 Apr 2022 13:52:03 +0000
Message: Voice Mail (11 seconds)
  From: Alex Wilber
  Status: Unread
  Received: Wed, 13 Apr 2022 02:30:27 +0000
Message: Our Spring Blog Update
  From: Alex Wilber
  Status: Unread
  Received: Tue, 12 Apr 2022 16:46:01 +0000
Message: Atlanta Flight Reservation
  From: Alex Wilber
  Status: Unread
  Received: Mon, 11 Apr 2022 13:39:10 +0000
Message: Atlanta Trip Itinerary - down time
  From: Alex Wilber
  Status: Unread
  Received: Fri, 08 Apr 2022 18:36:01 +0000

...

More messages available? True

Code erklärt

Betrachten Sie den Code in der getInbox Funktion.

Zugreifen auf bekannte E-Mail-Ordner

Die Funktion wird an den Anforderungs-Generator übergeben /me/mailFolders/inbox/messages , der eine Anforderung an die Api für Listennachrichten erstellt. Da es das /mailFolders/inbox Segment enthält, gibt die API nur Nachrichten im angeforderten E-Mail-Ordner zurück. Da der Posteingang in diesem Fall ein standardmäßiger, bekannter Ordner innerhalb des Postfachs eines Benutzers ist, kann über seinen bekannten Namen darauf zugegriffen werden. Auf nicht standardmäßige Ordner wird auf die gleiche Weise zugegriffen, indem der bekannte Name durch die ID-Eigenschaft des E-Mail-Ordners ersetzt wird. Ausführliche Informationen zu den verfügbaren bekannten Ordnernamen finden Sie unter mailFolder-Ressourcentyp.

Zugreifen auf eine Sammlung

getUser Im Gegensatz zur Funktion aus dem vorherigen Abschnitt, die ein einzelnes Objekt zurückgibt, gibt diese Methode eine Auflistung von Nachrichten zurück. Die meisten APIs in Microsoft Graph, die eine Sammlung zurückgeben, geben nicht alle verfügbaren Ergebnisse in einer einzigen Antwort zurück. Stattdessen verwenden sie Paging , um einen Teil der Ergebnisse zurückzugeben, während sie eine Methode für Clients bereitstellen, um die nächste "Seite" anzufordern.

Standardseitengrößen

APIs, die Paging verwenden, implementieren ein Standardseitenformat. Bei Nachrichten ist der Standardwert 10. Clients können mehr (oder weniger) mithilfe des $top Abfrageparameters anfordern. In getInboxwird dies mit der setPageSize Methode im Anforderungs-Generator erreicht.

Hinweis

Der übergebene setPageSize Wert ist eine obere Grenze, keine explizite Zahl. Die API gibt eine Reihe von Nachrichten bis zum angegebenen Wert zurück.

Abrufen nachfolgender Seiten

Wenn auf dem Server weitere Ergebnisse verfügbar sind, enthalten sammlungsantworten eine @odata.nextLink Eigenschaft mit einer API-URL, um auf die nächste Seite zuzugreifen. Das PHP SDK macht dies als isEnd Methode für Sammlungsanforderungsobjekte verfügbar. Wenn diese Methode "false" zurückgibt, sind weitere Ergebnisse verfügbar. Auf die nächste Seite kann von der getPage Methode zugegriffen werden.

Sortieren von Sammlungen

Die Funktion verwendet den $orderby Abfrageparameter , um Ergebnisse sortiert nach dem Zeitpunkt anzufordern, zu dem die Nachricht empfangen wird (receivedDateTime Eigenschaft). Es enthält das DESC Schlüsselwort, sodass kürzlich empfangene Nachrichten zuerst aufgeführt werden.

Nachrichten senden

20 Minuten verbleibend

In diesem Abschnitt fügen Sie die Möglichkeit hinzu, eine E-Mail-Nachricht als authentifizierter Benutzer zu senden.

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere sendMail Funktion in "main.php " durch Folgendes.
Führen Sie die App aus, melden Sie sich an, und wählen Sie Option 3 aus, um eine E-Mail an sich selbst zu senden.
```
Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. List users (requires app-only)
5. Make a Graph call
3

Mail sent.
```
Hinweis

Wenn Sie mit einem Entwicklermandanten aus dem Microsoft 365-Entwicklerprogramm testen, wird die von Ihnen gesendete E-Mail möglicherweise nicht zugestellt, und Sie erhalten möglicherweise einen Unzustellbarkeitsbericht. In diesem Fall wenden Sie sich bitte über die Microsoft 365 Admin Center an den Support.

Code erklärt

Betrachten Sie den Code in der sendMail Funktion.

Senden von E-Mails

Die Funktion wird an den Anforderungs-Generator übergeben /me/sendMail , der eine Anforderung an die Senden-E-Mail-API erstellt. Der Anforderungs-Generator verwendet einen Anforderungstext, der die zu sendende Nachricht enthält.

Erstellen von Objekten

Im Gegensatz zu den vorherigen Aufrufen von Microsoft Graph, die nur Daten lesen, werden durch diesen Aufruf Daten erstellt. Um dies mit der Clientbibliothek zu tun, erstellen Sie ein assoziatives Array, das die Daten darstellt, legen Sie die gewünschten Eigenschaften fest, und senden Sie es dann im API-Aufruf. Da der Aufruf Daten sendet, wird die POST Methode anstelle von GETverwendet.

Optional: Konfigurieren der reinen App-Authentifizierung

15 Minuten verbleibend

In diesem Abschnitt aktualisieren Sie die App-Registrierung aus dem vorherigen Abschnitt, um die Nur-App-Authentifizierung zu unterstützen. Nur-App-Authentifizierung ist eine gute Wahl für Hintergrunddienste, und es gibt auch einige APIs, die nur die Nur-App-Authentifizierung unterstützen. Sie müssen diesen Abschnitt nur abschließen, wenn Sie die Nur-App-Teile dieses Lernprogramms verwenden möchten. Andernfalls können Sie sicher zum nächsten Schritt springen.

Wichtig

Das Microsoft Graph Go SDK befindet sich derzeit in Community Preview. Während dieses Zeitraums werden grundlegende Änderungen erwartet. Dieses Lernprogramm wurde mit Version 0.19.1 geschrieben.

Ich benötige keine app-only, skip to the end

Wichtig

Die Schritte in diesem Abschnitt erfordern ein Geschäfts-/Schulkonto mit der rolle globaler Administrator.

Azure AD Admin Center
PowerShell

Öffnen Sie die App-Registrierung aus dem vorherigen Abschnitt im Azure AD Admin Center.
Wählen Sie API-Berechtigungen unter Verwalten aus.
Entfernen Sie die Standardberechtigung "User.Read " unter "Konfigurierte Berechtigungen ", indem Sie die Auslassungszeichen (...) in der Zeile und dann die Berechtigung "Entfernen" auswählen.
Wählen Sie "Berechtigung hinzufügen" und dann "Microsoft Graph" aus.
Wählen Sie Anwendungsberechtigungen aus.
Wählen Sie "User.Read.All" und dann " Berechtigungen hinzufügen" aus.
Wählen Sie "Administratorzustimmung erteilen für..." und dann " Ja " aus, um die Administratorzustimmung für die ausgewählte Berechtigung zu erteilen.
Wählen Sie unter "Verwalten" die Option "Zertifikate und geheime Schlüssel" und dann "Neuer geheimer Clientschlüssel" aus.
Geben Sie eine Beschreibung ein, wählen Sie eine Dauer und dann "Hinzufügen" aus.
Kopieren Sie den geheimen Schlüssel aus der Spalte "Wert" . Sie benötigen ihn in den nächsten Schritten.

Wichtig

Dieser geheime Clientschlüssel wird nicht noch einmal angezeigt, stellen Sie daher sicher, dass Sie ihn jetzt kopieren.

Erstellen Sie eine neue Datei mit dem Namen UpdateAppForAppOnlyAuth.ps1 , und fügen Sie den folgenden Code hinzu.
Speichern Sie die Datei.
Öffnen Sie PowerShell, und ändern Sie das aktuelle Verzeichnis in den Speicherort von UpdateAppForAppOnlyAuth.ps1.
Führen Sie den folgenden Befehl aus, indem <Sie Ihre Client-ID> durch Ihre Client-ID ersetzen.
```
.\UpdateAppForAppOnlyAuth.ps1 -AppId <your-client-id> -GraphScopes "User.Read.All"
```
Folgen Sie der Aufforderung, um in einem Browser zu öffnen https://microsoft.com/devicelogin , geben Sie den bereitgestellten Code ein, und schließen Sie den Authentifizierungsprozess ab.
Kopieren Sie die Werte der Mandanten-ID und des geheimen Clientschlüssels aus der Skriptausgabe. Sie benötigen diese Werte im nächsten Schritt.
```
SUCCESS
Tenant ID: a795ad0f-7d82-4a3b-a2c0-0713ec72ade7
Client secret: 2jv7Q~8eiOd_QafJ.....
Secret expires: 2/16/2024 9:32:09 PM
```

Hinweis

Beachten Sie, dass Sie im Gegensatz zu den Schritten bei der Registrierung für die Benutzerauthentifizierung in diesem Abschnitt Microsoft Graph Berechtigungen für die App-Registrierung konfiguriert haben. Dies liegt daran, dass die Nur-App-Authentifizierung den Clientanmeldeinformationsfluss verwendet, der erfordert, dass Berechtigungen für die App-Registrierung konfiguriert werden. Weitere Informationen finden Sie im Standardbereich .

Optional: Nur-App-Authentifizierung hinzufügen

12 Minuten verbleibend

In diesem Abschnitt fügen Sie der Anwendung die Nur-App-Authentifizierung hinzu. Dieser Abschnitt ist optional und erfordert den Abschluss von Optional: Konfigurieren der reinen App-Authentifizierung. Diese Schritte können nur mit einem Geschäfts-, Schul- oder Unikonto abgeschlossen werden.

Ich benötige keine app-only, skip to the end

Konfigurieren Graph Clients für die Nur-App-Authentifizierung

In diesem Abschnitt fordern Sie mithilfe des Clientanmeldeinformationsflusses ein Zugriffstoken an.

Aktualisieren Sie die Werte in .env gemäß der folgenden Tabelle.

Einstellung Wert

TENANT_ID Mandanten-ID Ihrer Organisation

CLIENT_SECRET Der im vorherigen Schritt generierte geheime Clientschlüssel
Fügen Sie die folgende Funktion zu GraphHelper.php hinzu.

Einstellung	Wert
`TENANT_ID`	Mandanten-ID Ihrer Organisation
`CLIENT_SECRET`	Der im vorherigen Schritt generierte geheime Clientschlüssel

Optional: Benutzer auflisten

10 Minuten verbleibend

In diesem Abschnitt fügen Sie die Möglichkeit hinzu, alle Benutzer in Ihrem Azure Active Directory mit nur app-Authentifizierung auflisten. Dieser Abschnitt ist optional und erfordert den Abschluss von "Optional:Konfigurieren der Nur-App-Authentifizierung " und "Optional: Nur-App-Authentifizierung hinzufügen". Diese Schritte können nur mit einem Geschäfts-, Schul- oder Unikonto abgeschlossen werden.

Ich benötige keine app-only, skip to the end

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere listUsers Funktion in "main.php " durch Folgendes.

Führen Sie die App aus, melden Sie sich an, und wählen Sie Option 4 aus, um Benutzer auflisten zu können.

Please choose one of the following options:
0. Exit
1. Display access token
2. List my inbox
3. Send mail
4. List users (requires app-only)
5. Make a Graph call
4
User: Adele Vance
  ID: 05fb57bf-2653-4396-846d-2f210a91d9cf
  Email: AdeleV@contoso.com
User: Alex Wilber
  ID: a36fe267-a437-4d24-b39e-7344774d606c
  Email: AlexW@contoso.com
User: Allan Deyoung
  ID: 54cebbaa-2c56-47ec-b878-c8ff309746b0
  Email: AllanD@contoso.com
User: Bianca Pisani
  ID: 9a7dcbd0-72f0-48a9-a9fa-03cd46641d49
  Email: NO EMAIL
User: Brian Johnson (TAILSPIN)
  ID: a8989e40-be57-4c2e-bf0b-7cdc471e9cc4
  Email: BrianJ@contoso.com

...

More users available? true

Code erklärt

Betrachten Sie den Code in der getUsers Funktion. Es ist dem Code in getInbox:

Es ruft eine Sammlung von Benutzern ab.
Es verwendet $select , um bestimmte Eigenschaften anzufordern.
Es wird verwendet setPageSize , um die Anzahl der zurückgegebenen Benutzer zu begrenzen.
Es wird $orderBy verwendet, um die Antwort zu sortieren.

Der Hauptunterschied besteht darin, dass dieser Code die $appClient, nicht die $userClientverwendet. Beide Clients verwenden dieselbe Syntax und Anforderungs-Generatoren, sind jedoch mit unterschiedlichen Anmeldeinformationen konfiguriert.

Optional: Eigenen Code hinzufügen

5 Minuten verbleibend

In diesem Abschnitt fügen Sie Der Anwendung Ihre eigenen Microsoft Graph-Funktionen hinzu. Dies kann ein Codeausschnitt aus der Microsoft Graph-Dokumentation oder Graph Explorer oder von Ihnen erstellter Code sein. Dieser Abschnitt ist optional.

Aktualisieren der App

Fügen Sie der GraphHelper-Klasse den folgenden Code hinzu.
Ersetzen Sie die leere makeGraphCall Funktion in "main.php " durch Folgendes.

Auswählen einer API

Suchen Sie eine API in Microsoft Graph, die Sie ausprobieren möchten. Beispiel: die Ereignis-API erstellen . Sie können eines der Beispiele in der API-Dokumentation verwenden oder eine eigene API-Anforderung erstellen.

Konfigurieren von Berechtigungen

Überprüfen Sie den Abschnitt "Berechtigungen" der Referenzdokumentation für die ausgewählte API, um zu sehen, welche Authentifizierungsmethoden unterstützt werden. Einige APIs unterstützen z. B. keine reinen App- oder persönlichen Microsoft-Konten.

Um eine API mit Benutzerauthentifizierung aufzurufen (wenn die API die Benutzerauthentifizierung (delegiert) unterstützt), fügen Sie den erforderlichen Berechtigungsbereich in .env hinzu.
Um eine API mit Nur-App-Authentifizierung aufzurufen (wenn die API dies unterstützt), fügen Sie den erforderlichen Berechtigungsbereich im Azure AD Admin Center hinzu.

Hinzufügen ihres Codes

Fügen Sie Ihren Code der makeGraphCall Funktion in GraphHelper.php hinzu.

Herzlichen Glückwunsch!

100 % abgeschlossen!

Sie haben das PHP Microsoft Graph-Lernprogramm abgeschlossen. Nachdem Sie nun über eine funktionierende App verfügen, die Microsoft Graph aufruft, können Sie experimentieren und neue Features hinzufügen. Besuchen Sie die Übersicht über Microsoft Graph, um alle Daten anzuzeigen, auf die Sie mit Microsoft Graph zugreifen können.

PHP-Beispiele

Laravel Web App