Partilhar via


Criar um cliente do Microsoft Graph

O cliente do Microsoft Graph foi concebido para simplificar a efetuar chamadas para o Microsoft Graph. Pode utilizar uma única instância de cliente para a duração da aplicação. Para obter informações sobre como adicionar e instalar o pacote de cliente do Microsoft Graph no seu projeto, veja Instalar o SDK.

Os exemplos de código seguintes mostram como criar uma instância de um cliente do Microsoft Graph com um fornecedor de autenticação nos idiomas suportados. O fornecedor de autenticação processa a aquisição de tokens de acesso para a aplicação.

Estão disponíveis muitos fornecedores de autenticação diferentes para cada idioma e plataforma. Os diferentes fornecedores de autenticação suportam diferentes cenários de cliente. Para obter detalhes sobre que fornecedor e opções são adequados para o seu cenário, veja Escolher um Fornecedor de Autenticação.

O ID de cliente é o ID de registo da aplicação que é gerado quando regista a sua aplicação no portal do Azure.

var scopes = new[] { "User.Read" };

// Multi-tenant apps can use "common",
// single-tenant apps must use the tenant ID from the Azure portal
var tenantId = "common";

// Value from app registration
var clientId = "YOUR_CLIENT_ID";

// using Azure.Identity;
var options = new DeviceCodeCredentialOptions
{
    AuthorityHost = AzureAuthorityHosts.AzurePublicCloud,
    ClientId = clientId,
    TenantId = tenantId,
    // Callback function that receives the user prompt
    // Prompt contains the generated device code that user must
    // enter during the auth process in the browser
    DeviceCodeCallback = (code, cancellation) =>
    {
        Console.WriteLine(code.Message);
        return Task.FromResult(0);
    },
};

// https://learn.microsoft.com/dotnet/api/azure.identity.devicecodecredential
var deviceCodeCredential = new DeviceCodeCredential(options);

var graphClient = new GraphServiceClient(deviceCodeCredential, scopes);

Inclua using instruções para Azure.Identity e Microsoft.Graph para executar este código.