BrianTJackett / msgraph-dotnet-interactive-extension

An extension for .NET Interactive Notebooks that provides authenticated Microsoft Graph clients.

Microsoft Graph extension for .NET Interactive Notebooks

Sample implementation of Microsoft Graph magic command / extension for .Net Interactive.

Test notebook

Build and import

The below commands can be used to build as a NuGet package (C#), import, and call via magic command.

rm ~/.nuget/packages/Microsoft.DotNet.Interactive.MicrosoftGraph -Force -Recurse -ErrorAction Ignore
dotnet build ./src/Microsoft.DotNet.Interactive.MicrosoftGraph.csproj

#i nuget:<REPLACE_WITH_WORKING_DIRECTORY>\src\bin\Debug\
#r "nuget:Microsoft.DotNet.Interactive.MicrosoftGraph,*-*"

Test extension

Display help for "microsoftgraph" magic command

#!microsoftgraph -h

Instantiate new connections to Microsoft Graph (using each authentication flow), specify unique scope name for parallel use

#!microsoftgraph --authentication-flow InteractiveBrowser --scope-name gcInteractiveBrowser --tenant-id <tenantId> --client-id <clientId>
#!microsoftgraph --authentication-flow DeviceCode --scope-name gcDeviceCode --tenant-id <tenantId> --client-id <clientId>
#!microsoftgraph --authentication-flow ClientCredential --scope-name gcClientCredential --tenant-id <tenantId> --client-id <clientId> --client-secret <clientSecret>

Settings file

As an alternative to passing client ID, client secret, and tenant ID as parameters to the magic command, you can put any or all of them into a JSON file and pass the path to that file in the --config-file parameter. Values passed in explicit parameters will override values in the JSON file.

#!microsoftgraph --authentication-flow ClientCredential --scope-name gcClientCredential ---configFile "./settings.json"

File schema

{
  "clientId": "YOUR_CLIENT_ID",
  "clientSecret": "YOUR_CLIENT_SECRET",
  "tenantId": "YOUR_TENANT_ID"
}

Interactive Browser sample snippet

var me = await gcInteractiveBrowser.Me.Request().GetAsync();
Console.WriteLine($"Me: {me.DisplayName}, {me.UserPrincipalName}");

Device Code sample snippet

var users = await gcDeviceCode.Users.Request()
    .Top(5)
    .Select(u => new {u.DisplayName, u.UserPrincipalName})
    .GetAsync();

users.Select(u => new {u.DisplayName, u.UserPrincipalName})

Client Credential sample snippet

var queryOptions = new List<QueryOption>()
{
new QueryOption("$count", "true")
};

var applications = await gcClientCredential.Applications
    .Request( queryOptions )
    .Header("ConsistencyLevel","eventual")
    .Top(5)
    .Select(a => new {a.AppId, a.DisplayName})
    .GetAsync();

applications.Select(a => new {a.AppId, a.DisplayName})

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.