Szybka konfiguracja Aeg Rke63221dx

• Artykuł
12/05/2022
• Czas czytania: 4 min

Po utworzeniu aplikacji dowiesz się, jak skonfigurować kod ze współrzędnymi aplikacji.

biblioteki Microsoft obsługujące aplikacje klasyczne

Następujące biblioteki Microsoft obsługują aplikacje klasyczne:

¹Dodatkowe warunki użytkowania dla Microsoft wersji zapoznawczej platformy Azure mają zastosowanie do bibliotek w publicznej wersji zapoznawczej.

Publiczna aplikacja kliencka

Z punktu widzenia kodu aplikacje klasyczne to publiczne aplikacje klienckie. Konfiguracja będzie nieco inna w zależności od tego, czy używasz uwierzytelniania interakcyjnego, czy nie.

• . NETJavaMacOSNode. jsPython

  Musisz skompilować i manipulować MSAL. NET IPublicClientApplication.

  Wyłącznie według kodu

  Poniższy kod tworzy wystąpienie publicznej aplikacji klienckiej i loguje użytkowników w chmurze publicznej platformy Azure Microsoft przy użyciu konta służbowego lub osobistego konta Microsoft.

  IPublicClientApplication app = PublicClientApplicationBuilder. Create(clientId). Build();

  Jeśli zamierzasz używać uwierzytelniania interakcyjnego lub przepływu kodu urządzenia, jak pokazano wcześniej, użyj . WithRedirectUri modyfikatora.

  IPublicClientApplication app;app = PublicClientApplicationBuilder. WithDefaultRedirectUri(). Build();
  Korzystanie z plików konfiguracji
  Poniższy kod tworzy wystąpienie publicznej aplikacji klienckiej z obiektu konfiguracji, który można wypełnić programowo lub odczytać z pliku konfiguracji. 
  PublicClientApplicationOptions options = GetOptions(); // your own methodIPublicClientApplication app = PublicClientApplicationBuilder. CreateWithApplicationOptions(options). Build();
  Bardziej rozbudowana konfiguracja
  Kompilowanie aplikacji można rozwinąć, dodając kilka modyfikatorów. Jeśli na przykład aplikacja ma być wielodostępną aplikacją w chmurze krajowej, taką jak pokazano tutaj dla instytucji rządowych USA, możesz napisać:
  app = PublicClientApplicationBuilder. WithAadAuthority(AzureCloudInstance. AzureUsGovernment,AadAuthorityAudience. AzureAdMultipleOrgs). Build();
  MSAL. NET zawiera również modyfikator Active Directory Federation Services 2019:
  app = PublicClientApplicationBuilder. WithAdfsAuthority("https://consoso. com/adfs"). Build();
  Jeśli na koniec chcesz uzyskać tokeny dla dzierżawy usługi Azure Active Directory (Azure AD) B2C, określ dzierżawę, jak pokazano w poniższym fragmencie kodu:
  app = PublicClientApplicationBuilder. WithB2CAuthority("https://fabrikamb2c. b2clogin. com/tfp/{tenant}/{PolicySignInSignUp}"). Build();
  Więcej tutaj
  Aby dowiedzieć się więcej na temat konfigurowania aplikacji klasycznej MSAL. NET:
  Aby uzyskać listę wszystkich modyfikatorów dostępnych w programie PublicClientApplicationBuilder, zobacz dokumentację referencyjną PublicClientApplicationBuilder. 
  Opis wszystkich opcji uwidocznionych w programie można znaleźć w PublicClientApplicationOptionstemacie PublicClientApplicationOptions w dokumentacji referencyjnej. 
  Kompletny przykład z opcjami konfiguracji
  Wyobraź sobie aplikację konsolową platformy. NET Core, która ma następujący appsettings. json plik konfiguracji:
  {"Authentication": {"AzureCloudInstance": "AzurePublic","AadAuthorityAudience": "AzureAdMultipleOrgs","ClientId": "ebe2ab4d-12b3-4446-8480-5c3828d04c50"},"WebAPI": {"MicrosoftGraphBaseEndpoint": "https://graph. com"}}
  W tym pliku jest niewiele kodu do odczytania przy użyciu polecenia. Platforma konfiguracji zapewniana przez platformę NET:
  public class SampleConfiguration{/// <summary>/// Authentication options/// </summary>public PublicClientApplicationOptions PublicClientApplicationOptions { get; set;}/// Base URL for Microsoft Graph (it varies depending on whether the application runs/// in Microsoft Azure public clouds or national or sovereign clouds)public string MicrosoftGraphBaseEndpoint { get; set;}/// Reads the configuration from a JSON file/// <param name="path">Path to the configuration json file</param>/// <returns>SampleConfiguration as read from the json file</returns>public static SampleConfiguration ReadFromJsonFile(string path)//. NET configurationIConfigurationRoot Configuration;var builder = new ConfigurationBuilder(). SetBasePath(Directory. GetCurrentDirectory()). AddJsonFile(path);Configuration = builder. Build();// Read the auth and graph endpoint configurationSampleConfiguration config = new SampleConfiguration()PublicClientApplicationOptions = new PublicClientApplicationOptions()};Configuration. Bind("Authentication", config. PublicClientApplicationOptions);config. MicrosoftGraphBaseEndpoint =Configuration. GetValue<string>("WebAPI:MicrosoftGraphBaseEndpoint");return config;}}
  Teraz, aby utworzyć aplikację, napisz następujący kod:
  SampleConfiguration config = SampleConfiguration. ReadFromJsonFile("appsettings. json");var app = PublicClientApplicationBuilder. CreateWithApplicationOptions(config. PublicClientApplicationOptions). Build();
  Przed wywołaniem . Build() metody można zastąpić konfigurację wywołaniami metod . WithXXX, jak pokazano wcześniej. 

  Oto klasa używana w przykładach programistycznych języka Java biblioteki MSAL do konfigurowania przykładów: TestData.

  PublicClientApplication pca = PublicClientApplication. builder(CLIENT_ID). authority(AUTHORITY). build();
  Szybka konfiguracja
  Objective-C:
  NSError *msalError = nil;MSALPublicClientApplicationConfig *config = [[MSALPublicClientApplicationConfig alloc] initWithClientId:@"<your-client-id-here>"];MSALPublicClientApplication *application = [[MSALPublicClientApplication alloc] initWithConfiguration:config error:&msalError];
  Swift:
  let config = MSALPublicClientApplicationConfig(clientId: "<your-client-id-here>")if let application = try? MSALPublicClientApplication(configuration: config){ /* Use application */}
  Bardziej rozbudowana konfiguracja
  MSALAADAuthority *aadAuthority =[[MSALAADAuthority alloc] initWithCloudInstance:MSALAzureUsGovernmentCloudInstanceaudienceType:MSALAzureADMultipleOrgsAudiencerawTenant:nilerror:nil];MSALPublicClientApplicationConfig *config =[[MSALPublicClientApplicationConfig alloc] initWithClientId:@"<your-client-id-here>"redirectUri:@"<your-redirect-uri-here>"authority:aadAuthority];NSError *applicationError = nil;MSALPublicClientApplication *application =[[MSALPublicClientApplication alloc] initWithConfiguration:config error:&applicationError];
  let authority = try? MSALAADAuthority(cloudInstance:. usGovernmentCloudInstance, audienceType:. azureADMultipleOrgsAudience, rawTenant: nil)let config = MSALPublicClientApplicationConfig(clientId: "<your-client-id-here>", redirectUri: "<your-redirect-uri-here>", authority: authority)if let application = try? MSALPublicClientApplication(configuration: config) { /* Use application */}
  Parametry konfiguracji można załadować z wielu źródeł, takich jak plik JavaScript lub zmienne środowiskowe. Poniżej jest używany plik authConfig. js. 
  /** Copyright (c) Microsoft Corporation. All rights reserved.* Licensed under the MIT License.*/const { LogLevel} = require("@azure/msal-node");/*** Configuration object to be passed to MSAL instance on creation.* For a full list of MSAL. js configuration parameters, visit:* https://github. com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-node/docs/configuration. mdconst AAD_ENDPOINT_HOST = "Enter_the_Cloud_Instance_Id_Here"; // include the trailing slashconst msalConfig = {auth: {clientId: "Enter_the_Application_Id_Here",authority: `${AAD_ENDPOINT_HOST}Enter_the_Tenant_Info_Here`, },system: {loggerOptions: {loggerCallback(loglevel, message, containsPii) {console. log(message);},piiLoggingEnabled: false,logLevel: LogLevel. Verbose, }, }, };* Add here the endpoints and scopes when obtaining an access token for protected web APIs. For more information, see:* https://github. com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-browser/docs/resources-and-scopes. mdconst GRAPH_ENDPOINT_HOST = "Enter_the_Graph_Endpoint_Here"; // include the trailing slashconst protectedResources = {graphMe: {endpoint: `${GRAPH_ENDPOINT_HOST}v1. 0/me`,scopes: ["User. Read"], }};module. exports = {msalConfig: msalConfig,protectedResources: protectedResources, };
  Zaimportuj obiekt konfiguracji z pliku authConfig. Węzeł MSAL można zainicjować minimalnie, jak pokazano poniżej. Zobacz dostępne opcje konfiguracji. 
  const { PublicClientApplication} = require('@azure/msal-node');const { msalConfig} = require('. /authConfig')* Initialize a public client application. For more information, visit:* https://github. com/AzureAD/microsoft-authentication-library-for-js/blob/dev/lib/msal-node/docs/initialize-public-client-application. mdclientApplication = new PublicClientApplication(msalConfig);
  config = json. load(open(sys. argv[1]))app = msal. PublicClientApplication(config["client_id"], authority=config["authority"],# token_cache=... # Default cache is in memory only.# You can learn how to use SerializableTokenCache from# https://msal-python. rtfd. io/en/latest/#msal. SerializableTokenCache)
  Następne kroki
  Przejdź do następnego artykułu w tym scenariuszu Uzyskaj token dla aplikacji klasycznej.