Dynamisches Erstellen einer Microsoft Teams-Besprechung mit Microsoft Graph

Öffnen Sie das samples/acs-to-teams-meeting/server/csharp/GraphACSFunctions.sln in Visual Studio oder den Ordner GraphACSFunctions in Visual Studio Code.

Wechseln Sie zum GraphACSFunctions Projekt, und erstellen Sie eine local.settings.json Datei mit den folgenden Werten:

{
    "IsEncrypted": false,
    "Values": {
        "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
        "TENANT_ID": "",
        "CLIENT_ID": "",
        "CLIENT_SECRET": "",
        "USER_ID": "",
        "ACS_CONNECTION_STRING": ""
    },
    "Host": {
        "LocalHttpPort": 7071,
        "CORS": "*",
        "CORSCredentials": false
    },
    "watchDirectories": [
        "Shared"
    ]
}

• Verwenden Sie die Werte, die Sie in einer früheren Übung in die lokale Datei kopiert haben, um die Werte TENANT_ID, CLIENT_ID und CLIENT_SECRET zu aktualisieren.
• Definieren Sie USER_ID mit der Benutzer-ID, mit der Sie eine Microsoft Teams-Besprechung erstellen möchten.

Sie können die Benutzer-ID aus dem Azure-Portal abrufen.

• Melden Sie sich mit Ihrem Microsoft 365-Entwicklermandantenadministratorkonto an.
• Wählen Sie Microsoft Entra ID aus.
• Navigieren Sie zur Registerkarte "Benutzer " auf der Seitenleiste.
• Suchen Sie nach Ihrem Benutzernamen, und wählen Sie ihn aus, um die Benutzerdetails anzuzeigen.
• Object ID stellt User ID innerhalb der Benutzerdetails dar. Kopieren Sie den Object ID Wert, und verwenden Sie ihn für den USER_ID Wert in local.settings.json.

Öffnen Sie GraphACSFunctions.sln im acs-to-teams-meeting/server/csharp-Ordner, und beachten Sie, dass sie die folgenden Microsoft Graph- und Identitätspakete enthält:

<PackageReference Include="Azure.Communication.Identity" Version="1.3.1" />
<PackageReference Include="Azure.Identity" Version="1.11.2" />
<PackageReference Include="Microsoft.Graph" Version="5.51.0" />

Wechseln Sie zu Program.cs , und notieren Sie sich den folgenden Code in der ConfigureServices Methode:

    var host = new HostBuilder()
        .ConfigureFunctionsWebApplication()
        .ConfigureServices(services => {
            services.AddApplicationInsightsTelemetryWorkerService();
            services.ConfigureFunctionsApplicationInsights();
            services.AddSingleton(static p =>
            {
                var config = p.GetRequiredService<IConfiguration>();
                var clientSecretCredential = new ClientSecretCredential(
                    config.GetValue<string>("TENANT_ID"),
                    config.GetValue<string>("CLIENT_ID"),
                    config.GetValue<string>("CLIENT_SECRET")
                );

                return new GraphServiceClient(
                    clientSecretCredential,
                    ["https://graph.microsoft.com/.default"]
                );
            });

            ...

            services.AddSingleton<IGraphService, GraphService>();
        })
        .Build();
}

• Dieser Code erstellt ein GraphServiceClient Objekt, das zum Aufrufen von Microsoft Graph aus Azure Functions verwendet werden kann. Es ist ein Singleton und kann in andere Klassen eingefügt werden.
• Sie können Microsoft Graph-API-Aufrufe mit Nur-App-Berechtigungen (z. B. Calendars.ReadWrite) ausführen, indem Sie einen ClientSecretCredential Wert an den GraphServiceClient Konstruktor übergeben. Das ClientSecretCredential verwendet die Werte Tenant Id, Client Id und Client Secret aus der Microsoft Entra ID-App.

Öffnen Sie Dienste/GraphService.cs.

Nehmen Sie sich einen Moment Zeit, um die CreateMeetingEventAsync Methode zu erkunden:

using System;
using System.Threading.Tasks;
using Microsoft.Graph;
using Microsoft.Extensions.Configuration;

namespace GraphACSFunctions.Services;

public class GraphService : IGraphService
{
    private readonly GraphServiceClient _graphServiceClient;
    private readonly IConfiguration _configuration;

    public GraphService(GraphServiceClient graphServiceClient, IConfiguration configuration)
    {
        _graphServiceClient = graphServiceClient;
        _configuration = configuration;
    }

    public async Task<string> CreateMeetingAsync()
    {
        var userId = _configuration.GetValue<string>("USER_ID");
        var newMeeting = await _graphServiceClient
            .Users[userId]
            .Calendar
            .Events
            .PostAsync(new()
            {
                Subject = "Customer Service Meeting",
                Start = new()
                {
                    DateTime = DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mm:ss"),
                    TimeZone = "UTC"
                },
                End = new()
                {
                    DateTime = DateTime.UtcNow.AddHours(1).ToString("yyyy-MM-ddTHH:mm:ss"),
                    TimeZone = "UTC"
                },
                IsOnlineMeeting = true
            });
        return newMeeting.OnlineMeeting.JoinUrl;
    }
}

• GraphServiceClient und IConfiguration Objekte werden in den Konstruktor eingefügt und Feldern zugewiesen.
• Die CreateMeetingAsync() Funktion sendet Daten an die Microsoft Graph-Kalenderereignisse-API, die dynamisch ein Ereignis im Kalender eines Benutzers erstellt und die Verknüpfungs-URL zurückgibt.

Öffnen Sie TeamsMeetingFunctions.cs , und nehmen Sie sich einen Moment Zeit, um den Konstruktor zu untersuchen. Die zuvor angesehene GraphServiceClient wird injiziert und dem _graphService-Feld zugewiesen.

private readonly IGraphService _graphService;

public TeamsMeetingFunction(IGraphService graphService) => _graphService = graphService;

Suchen Sie die Run Methode:

[Function("HttpTriggerTeamsUrl")]
public async Task<HttpResponseData> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = null)] HttpRequestData req,
    ILogger log)
{
    var response = req.CreateResponse(HttpStatusCode.OK);
    await response.WriteStringAsync(await _graphService.CreateMeetingAsync());
    return response;
}

• Er definiert den Funktionsnamen HttpTriggerTeamsUrl, der mit einer HTTP-GET-Anforderung aufgerufen werden kann.
• Es ruft _graphService.CreateMeetingAsync() auf, wodurch ein neues Ereignis erstellt wird und die Teilnahme-URL zurückgegeben wird.

Führen Sie das Programm aus, indem Sie in Visual Studio F5 drücken oder "Debuggen" auswählen .> Starten Sie das Debuggen über das Menü. Diese Aktion startet das Azure Functions-Projekt und stellt den ACSTokenFunction Aufruf zur Verfügung.

Öffnen Sie den Projektordner "samples/acs-to-teams-meeting/server/typescript " in Visual Studio Code.

Erstellen Sie eine local.settings.json Datei mit den folgenden Werten:

{
    "IsEncrypted": false,
    "Values": {
        "FUNCTIONS_WORKER_RUNTIME": "node",
        "TENANT_ID": "",
        "CLIENT_ID": "",
        "CLIENT_SECRET": "",
        "USER_ID": "",
        "ACS_CONNECTION_STRING": ""
    },
    "Host": {
        "LocalHttpPort": 7071,
        "CORS": "*",
        "CORSCredentials": false
    },
    "watchDirectories": [
        "Shared"
    ]
}

• Verwenden Sie die Werte, die Sie in einer früheren Übung in die lokale Datei kopiert haben, um die Werte TENANT_ID, CLIENT_ID und CLIENT_SECRET zu aktualisieren.
• Definieren Sie USER_ID mit der Benutzer-ID, mit der Sie eine Microsoft Teams-Besprechung erstellen möchten.

Sie können die Benutzer-ID aus dem Azure-Portal abrufen.

• Melden Sie sich mit Ihrem Microsoft 365-Entwicklermandantenadministratorkonto an.
• Microsoft Entra-ID auswählen,
• Navigieren Sie zur Registerkarte "Benutzer " auf der Seitenleiste.
• Suchen Sie nach Ihrem Benutzernamen, und wählen Sie ihn aus, um die Benutzerdetails anzuzeigen.
• Object ID stellt User ID innerhalb der Benutzerdetails dar. Kopieren Sie den Object ID Wert, und verwenden Sie ihn für den USER_ID Wert in local.settings.json.

Öffnen Sie die package.json Datei in VS Code, und beachten Sie, dass die folgenden Microsoft Graph- und Identitätspakete enthalten sind:

@azure/communication-identity
@azure/identity
@microsoft/microsoft-graph-client

Öffnen Sie ein Terminalfenster im Typescript-Ordner , und führen Sie den npm install Befehl aus, um die Anwendungsabhängigkeiten zu installieren.

Öffnen Sie "Shared/graph.ts ", und nehmen Sie sich einen Moment Zeit, um die Importe am Anfang der Datei zu erkunden. Dieser Code behandelt das Importieren von Authentifizierungs- und Clientsymbolen, die in der Azure-Funktion zum Aufrufen von Microsoft Graph verwendet werden.

import { startDateTimeAsync, endDateTimeAsync } from './dateTimeFormat';
import { ClientSecretCredential } from '@azure/identity';
import { Client } from '@microsoft/microsoft-graph-client';
import { TokenCredentialAuthenticationProvider } from '@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials';
import 'isomorphic-fetch';

Nehmen Sie sich einen Moment Zeit, um clientSecretCredential und appGraphClient zu untersuchen. Sie werden später im Authentifizierungsprozess und beim Aufrufen der Microsoft Graph-API verwendet:

let clientSecretCredential;
let appGraphClient;

Suchen Sie die ensureGraphForAppOnlyAuth Funktion:

• ClientSecretCredential verwendet die Werte Tenant Id, Client Id und Client Secret aus der Microsoft Entra ID-App.
• Das authProvider Objekt wird als Microsoft Entra ID-App definiert, die sich im Hintergrund authentifiziert und App-exklusive Berechtigungen (z. B. Calendars.ReadWrite) verwendet, um Microsoft Graph-API-Aufrufe auszuführen.

function ensureGraphForAppOnlyAuth() {
    if (!clientSecretCredential) {
        clientSecretCredential = new ClientSecretCredential(
            process.env.TENANT_ID,
            process.env.CLIENT_ID,
            process.env.CLIENT_SECRET
        );
    }

    if (!appGraphClient) {
        const authProvider = new TokenCredentialAuthenticationProvider(
        clientSecretCredential, {
            scopes: [ 'https://graph.microsoft.com/.default' ]
        });

        appGraphClient = Client.initWithMiddleware({
            authProvider: authProvider
        });
    }
}

Nehmen Sie sich einen Moment Zeit, um die createNewMeetingAsync Funktion zu erkunden. Sie sendet Daten an die Microsoft Graph-Kalenderereignisse-API, die dynamisch ein Ereignis im Kalender eines Benutzers erstellt und die neuen Ereignisdetails zurückgibt:

async function createNewMeetingAsync(userId) {
    ensureGraphForAppOnlyAuth();
    let startTime = await startDateTimeAsync();
    let endTime = await endDateTimeAsync();
    const newMeeting = `/users/${userId}/calendar/events`;

    const event = {
    subject: 'Customer Service Meeting',
    start: {
        dateTime: startTime,
        timeZone: 'UTC'
    },
    end: {
        dateTime: endTime,
        timeZone: 'UTC'
    },
    isOnlineMeeting: true
    };

    const newEvent = await appGraphClient.api(newMeeting).post(event);    
    return newEvent;     
}

export default createNewMeetingAsync;

Wechseln Sie zu server/typescript/src/functions/httpTriggerTeamsUrl.ts und erkunden Sie die Http Trigger-Funktion :

• createNewMeetingAsync wird aus graph.ts importiert. Es behandelt das Erstellen und Abrufen neuer Ereignisdetails.
• userId wird aus local.settings.json innerhalb der Http Trigger-Funktion abgerufen. Dieser Abruf erfolgt durch Den Zugriff auf die USER_ID Umgebungsvariable mithilfe von process.env.USER_ID.
• Wenn die Funktion ausgelöst wird, wird sie mit der definierten Benutzer-ID aufgerufen createNewMeetingAsync und gibt die neuen Ereignisdetails im teamMeetingLink Parameter zurück.
• Die Funktion greift auf die Join-URL der Teams-Besprechung zu, indem sie meeting.onlineMeeting.joinUrl aufruft, und gibt den Wert im Inhaltsbereich der Antwort zurück.

import { app, HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";
import createNewMeetingAsync from '../../Shared/graph';

let teamsMeetingLink;

export async function httpTriggerTeamsUrl(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    context.log("Request received");
    const userId = process.env.USER_ID;
    context.log('UserId', userId);

    teamsMeetingLink = await createNewMeetingAsync(userId);
    const body = JSON.stringify(teamsMeetingLink);
    const meeting = JSON.parse(body);
    context.log("meeting:", meeting);

    return {
        // status: 200, /* Defaults to 200 */
        body: meeting.onlineMeeting.joinUrl
    }    
};

app.http('httpTriggerTeamsUrl', {
    methods: ['GET'],
    authLevel: 'anonymous',
    handler: httpTriggerTeamsUrl
});

export default httpTriggerTeamsUrl;

Verwenden Sie ein Terminalfenster, um die Funktion lokal auszuführen, indem Sie npm start im Ordner samples/acs-video-to-teams-meeting/server/typescript ausführen.