快速入门:访问受保护的 Web API 的 .NET 控制台应用
本快速入门使用示例 .NET 控制台应用程序通过适用于 .NET 的 Microsoft 身份验证库 (MSAL) 访问受保护的 Web API 作为其自己的标识。 该应用程序是一个守护程序应用程序,它是一个机密客户端应用程序,使用客户端凭据 OAuth 流获取访问令牌来调用 Microsoft Graph API。
先决条件
- 具有活动订阅的 Azure 帐户。 如果还没有帐户,请创建一个帐户。
- 最低要求 .NET 6.0 SDK
- Visual Studio 2022 或 Visual Studio Code
注册应用程序和记录标识符
若要完成注册,请为应用程序命名并指定支持的帐户类型。 注册后,应用程序“概述”窗格将显示应用程序源代码中所需的标识符。
登录到 Microsoft Entra 管理中心。
如果你有权访问多个租户,请使用顶部菜单中的“设置”图标 ,通过“目录 + 订阅”菜单切换到你希望在其中注册应用程序的租户。
浏览至“标识”>“应用程序”>“应用注册”,然后选择“新建注册”。
输入应用程序的“名称”,例如“identity-client-daemon-app”。
对于“支持的帐户类型”设置,请选择“仅限此组织目录中的帐户”。 要了解不同帐户类型的信息,请选择“帮我选择”选项。
选择“注册”。
注册完成后,将显示应用程序的“概述”窗格。 记录要在应用程序源代码中使用的“目录(租户)ID”、“应用程序(客户端)ID 和“对象 ID”。
注意
可以通过参照修改应用程序支持的帐户来更改支持的帐户类型。
创建客户端机密
- 在 Microsoft Entra 管理中心,浏览到“标识”>“应用程序”>“应用注册”。
- 选择你在前面注册的应用程序。
- 在应用程序的“概览”窗格中,选择“证书和机密”>“新建客户端密码”。
- 在“说明”字段中输入机密的说明。
- 选择机密的到期期限。
- 选择 添加 。
- 记录客户端密码的值。 该值仅显示一次,因此请确保记录它。
克隆或下载示例应用程序
若要获取示例应用程序,可以从 GitHub 克隆它或将其下载为 .zip 文件。
若要克隆示例,请打开命令提示符并导航到要创建项目的位置,然后输入以下命令:
git clone https://github.com/Azure-Samples/ms-identity-docs-code-dotnet.git
下载 .zip 文件。 将其提取到名称长度小于 260 个字符的文件路径。
配置项目
在 IDE 中,打开包含示例的项目文件夹 ms-identity-docs-code-dotnet/console-daemon。
打开 Program.cs,并将文件内容替换为以下代码片段;
// Full directory URL, in the form of https://login.partner.microsoftonline.cn/<tenant_id> Authority = " https://login.partner.microsoftonline.cn/Enter_the_tenant_ID_obtained_from_the_Microsoft_Entra_admin_center", // 'Enter the client ID obtained from the Microsoft Entra admin center ClientId = "Enter the client ID obtained from the Microsoft Entra admin center", // Client secret 'Value' (not its ID) from 'Client secrets' in the Microsoft Entra admin center ClientSecret = "Enter the client secret value obtained from the Microsoft Entra admin center", // Client 'Object ID' of app registration in Microsoft Entra admin center - this value is a GUID ClientObjectId = "Enter the client Object ID obtained from the Microsoft Entra admin center"
Authority
- 颁发机构是一个 URL,表示 MSAL 可从中请求令牌的目录。 将“Enter_the_tenant_ID”替换为先前记录的“目录(租户)ID”值。ClientId
- 应用程序的标识符,也称为客户端。 将引号中的文本替换为先前在注册应用程序的概述页中记录的Application (client) ID
值。ClientSecret
- 在 Microsoft Entra 管理中心为应用程序创建的客户端密码。 输入客户端密码的值。ClientObjectId
- 客户端应用程序的对象 ID。 将引号中的文本替换为先前在注册应用程序的概述页中记录的Object ID
值。
运行应用程序
在终端中,导航到项目目录 ms-identity-docs-code-dotnet/console-daemon。
运行以下命令以生成并运行应用程序:
dotnet run
应用程序会运行并显示类似于以下内容的响应(为简洁起见缩短了):
{ "@odata.context": "https://microsoftgraph.chinacloudapi.cn/v1.0/$metadata#applications/$entity", "id": "00001111-aaaa-2222-bbbb-3333cccc4444", "deletedDateTime": null, "appId": "00001111-aaaa-2222-bbbb-3333cccc4444", "applicationTemplateId": null, "disabledByMicrosoftStatus": null, "createdDateTime": "2021-01-17T15:30:55Z", "displayName": "identity-dotnet-console-app", "description": null, "groupMembershipClaims": null, ... }
相关内容
- 使用教程:通过 Microsoft 标识平台注册应用程序系列学习创建 ASP.NET Web 应用。
- 快速入门:使用 Microsoft 标识平台保护 ASP.NET Core Web API。
- 快速入门:将 ASP.NET Web 应用部署到 Azure 应用服务