快速入门：在示例移动应用中登录用户

在本快速入门中，你将下载并运行代码示例，该示例演示 Android 应用程序如何登录用户并获取访问令牌来调用Microsoft图形 API。

应用程序必须由Microsoft Entra ID 中的应用对象表示，以便Microsoft标识平台可以向应用程序提供令牌。

在本快速入门中，你将下载并运行代码示例，该示例演示本机 iOS 或 macOS 应用程序如何登录用户并获取访问令牌来调用 Microsoft 图形 API。

本快速入门适用于 iOS 和 macOS 应用。 某些步骤仅适用于 iOS 应用，并会指示为此类步骤。

• 在 Microsoft Entra 管理中心注册新应用，为 任何组织目录中的帐户和个人Microsoft帐户配置。 有关更多详细信息 ，请参阅注册应用程序 。 在应用程序 概述 页中记录以下值供以后使用：
  • 应用程序（客户端）ID
  • 目录（租户）ID
• Android Studio
• Android 16+

• 在 Microsoft Entra 管理中心注册新应用， 仅为此组织目录中的帐户配置。 有关更多详细信息 ，请参阅注册应用程序 。 在应用程序 概述 页中记录以下值供以后使用：
  • 应用程序（客户端）ID
  • 目录（租户）ID
• XCode 10+
• iOS 10+
• macOS 10.12+

1. 在“ 管理”下，选择“ 身份验证>添加平台>Android”。

2. 根据上面下载的示例类型输入项目的包名称。

   • Java 示例 - com.azuresamples.msalandroidapp
   • Kotlin 示例 - com.azuresamples.msalandroidkotlinapp

3. 在“配置 Android 应用”窗格的“签名哈希”部分中，选择“生成开发签名哈希”。并将 KeyTool 命令复制到命令行。

   • KeyTool.exe 作为 Java 开发工具包（JDK）的一部分安装。 还必须安装 OpenSSL 工具才能执行 KeyTool 命令。 有关详细信息，请参阅 有关生成密钥的 Android 文档 。

4. 输入 KeyTool 生成的 签名哈希 。

5. 选择“配置”并保存显示在 Android 配置窗格中的 MSAL 配置，以便在稍后配置应用时输入它。

6. 选择“完成”。

1. 在“ 管理”下，选择“ 身份验证>添加平台>iOS”。
2. 输入应用程序的 捆绑标识符 。 捆绑标识符是唯一标识应用程序的唯一字符串，例如 com.<yourname>.identitysample.MSALMacOS。 记下使用的值。 请注意，iOS 配置也适用于 macOS 应用程序。
3. 选择“ 配置 ”并保存 MSAL 配置 详细信息，供本快速入门稍后使用。
4. 选择“完成”。

• Java： 下载代码。
• Kotlin： 下载代码。

下载示例项目

• 下载适用于 iOS 的代码示例
• 下载适用于 macOS 的代码示例

安装依赖项

1. 提取 zip 文件。
2. 在终端窗口中，导航到包含下载的代码示例的文件夹，然后运行 pod install 以安装最新的 MSAL 库。

1. 在 Android Studio 的项目窗格中，导航到 app\src\main\res。

2. 右键单击 res 并选择“ 新建>目录”。 输入 raw 为新目录名称，然后选择“ 确定”。

3. 在 应用>src>main>res>raw 中，转到调用 auth_config_single_account.json 的 JSON 文件并粘贴之前保存的 MSAL 配置。

   在重定向 URI 下方粘贴：

     "account_mode" : "SINGLE",
   

   配置文件应类似于以下示例：

   {
     "client_id": "00001111-aaaa-bbbb-3333-cccc4444",
     "authorization_user_agent": "WEBVIEW",
     "redirect_uri": "msauth://com.azuresamples.msalandroidapp/00001111%cccc4444%3D",
     "broker_redirect_uri_registered": false,
     "account_mode": "SINGLE",
     "authorities": [
       {
         "type": "AAD",
         "audience": {
           "type": "AzureADandPersonalMicrosoftAccount",
           "tenant_id": "common"
         }
       }
     ]
   }
   

4. 打开 /app/src/main/AndroidManifest.xml 文件。

5. 查找占位符：

   • enter_the_signature_hash 并将其替换为之前添加平台重定向 URL 时生成的 签名哈希 。

   由于本教程仅演示如何在单帐户模式下配置应用，请参阅 单帐户模式与多个帐户模式 并 配置应用 以获取详细信息

运行示例应用

从 Android Studio 的 可用设备 下拉列表中选择仿真器或物理设备并运行应用。

示例应用在 “单帐户模式” 屏幕上启动。 默认提供默认范围 user.read，在Microsoft图形 API 调用期间读取自己的配置文件数据时使用。 默认情况下会提供Microsoft图形 API 调用的 URL。 如果需要，可以更改这两者。

使用应用菜单在单帐户模式和多个帐户模式之间进行更改。

在单帐户模式下，使用工作或家庭帐户登录：

1. 以 交互方式选择“获取图形数据 ”，提示用户输入其凭据。 你将在屏幕底部看到对 Microsoft 图形 API 的调用的输出。
2. 登录后，选择“ 无提示获取图形数据 ”以调用Microsoft图形 API，而无需提示用户再次输入凭据。 你将在屏幕底部看到对 Microsoft 图形 API 的调用的输出。

在多个帐户模式下，可以重复相同的步骤。 此外，还可以删除已登录帐户，该帐户也会删除该帐户的缓存令牌。

如果选择了上面的选项 1，则可以跳过这些步骤。

1. 在 XCode 中打开项目。

2. 编辑 ViewController.swift ，并将以“let kClientID”开头的行替换为以下代码片段。 请记住，使用在本快速入门中之前注册应用时保存的 clientID 更新值 kClientID ：

   let kClientID = "Enter_the_Application_Id_Here"
   

3. 如果要为 Microsoft Entra 国家/地区云构建应用，请将以“let kGraphEndpoint”开头的行替换为正确的终结点“let kAuthority”。 对于全局访问，请使用默认值：

   let kGraphEndpoint = "https://graph.microsoft.com/"
   let kAuthority = "https://login.microsoftonline.com/common"
   

4. 此处介绍了其他终结点。 例如，若要通过 Microsoft Entra Germany 运行快速入门，请使用以下内容：

   let kGraphEndpoint = "https://graph.microsoft.de/"
   let kAuthority = "https://login.microsoftonline.de/common"
   

5. 打开项目设置。 在 “标识 ”部分中，输入 捆绑标识符。

6. 右键单击 Info.plist 并选择“ 开放为>源代码”。

7. 在听写根节点下，替换为 Enter_the_bundle_Id_Here 在门户中使用的 捆绑 ID 。 msauth.请注意字符串中的前缀。

   <key>CFBundleURLTypes</key>
   <array>
      <dict>
         <key>CFBundleURLSchemes</key>
         <array>
            <string>msauth.Enter_the_Bundle_Id_Here</string>
         </array>
      </dict>
   </array>
   

8. 生成并运行应用！

代码组织成片段，演示如何编写单个帐户和多个帐户 MSAL 应用。 代码文件按如下所示进行组织：

现在，我们将更详细地查看这些文件，并调用每个文件中特定于 MSAL 的代码。

转到 Android 教程，在其中构建一个 Android 应用，该应用从Microsoft标识平台获取访问令牌，并使用它调用Microsoft图形 API。

继续学习分步教程，在其中生成 iOS 或 macOS 应用，该应用从Microsoft标识平台获取访问令牌，并使用它调用Microsoft图形 API。

• Android Studio。

• 用户流。 有关详细信息，请参阅 为外部租户中的应用创建自助服务注册用户流。 此用户流可用于多个应用程序。
• 将应用程序添加到用户流。
• .NET 7.0 开发工具包
• 安装了 MAUI 工作负载的 Visual Studio 2022：
  • Windows 说明
  • macOS 的说明

• Xcode。

若要将应用类型指定到应用注册，请执行以下步骤：

1. 在 管理下，选择 身份验证。
2. 在 “平台配置 ”页上，选择 “添加平台”，然后选择 “Android ”选项。
3. 输入项目的包名称。 如果下载了 示例代码，则此值为 com.azuresamples.msaldelegatedandroidkotlinsampleapp。
4. 在“配置 Android 应用”窗格的“签名哈希”部分中，选择“生成开发签名哈希”。这将针对每个开发环境进行更改。在终端中复制并运行作系统的 KeyTool 命令。
5. 输入 KeyTool 生成的 签名哈希 。
6. 选择配置。
7. 从 Android 配置窗格中复制 MSAL 配置，并将其保存到以后的应用配置。
8. 选择“完成”。

启用公共客户端流

若要将应用标识为公共客户端，请执行以下步骤：

1. 在 管理下，选择 身份验证。

2. 在 “高级设置”下，对于 “允许公共客户端流”，请选择“ 是”。

3. 选择 保存 以保存更改。

若要将应用类型指定到应用注册，请执行以下步骤：

1. 在 管理下，选择 身份验证。
2. 在 “平台配置 ”页上，选择“ 添加平台”，然后选择“ 移动和桌面应用程序 ”选项。
3. 对于 重定向 URI ，请输入 msal{client_id}://auth。 确保与 {client_id} 应用注册的值匹配。 选择配置。
4. 选择“保存”，保存更改。

若要将应用类型指定到应用注册，请执行以下步骤：

1. 在 管理下，选择 身份验证。
2. 在 “平台配置 ”页上，选择 “添加平台”，然后选择 “iOS/macOS ”选项。
3. 输入项目的捆绑 ID。 如果下载了 示例代码，则此值为 com.microsoft.identitysample.ciam.MSALiOS。
4. 选择“配置”并保存 iOS/macOS 配置窗格中显示的 MSAL 配置，以便稍后配置应用时可以输入它。
5. 选择“完成”。

启用公共客户端流

若要将应用标识为公共客户端，请执行以下步骤：

1. 在 管理下，选择 身份验证。

2. 在 “高级设置”下，对于 “允许公共客户端流”，请选择“ 是”。

3. 选择 保存 以保存更改。

若要获取示例应用程序，可以从 GitHub 克隆它，也可以 将其下载为 .zip 文件。

• 若要克隆示例，请打开命令提示符并导航到要创建项目的位置，并输入以下命令：

  git clone https://github.com/Azure-Samples/ms-identity-ciam-browser-delegated-android-sample
  

若要获取 .NET MAUI Android 应用程序示例代码，请运行以下命令， 下载 .zip 文件 或从 GitHub 克隆示例 .NET MAUI Android 应用程序：

git clone https://github.com/Azure-Samples/ms-identity-ciam-dotnet-tutorial.git

若要获取示例应用程序，可以从 GitHub 克隆它，也可以将其下载为 .zip 文件。

• 若要克隆示例，请打开命令提示符并导航到要创建项目的位置，并输入以下命令：

  git clone https://github.com/Azure-Samples/ms-identity-ciam-browser-delegated-ios-sample.git
  

若要启用对 Microsoft Graph 资源的身份验证和访问，请执行以下步骤配置示例：

1. 在 Android Studio 中，打开克隆的项目。

2. 打开 /app/src/main/res/raw/auth_config_ciam.json 文件。

3. 查找占位符：

   • Enter_the_Application_Id_Here 并将其替换为之前注册的应用 的应用程序（客户端）ID 。
   • Enter_the_Redirect_Uri_Here 并将其替换为在添加平台重定向 URL 时之前下载的Microsoft身份验证库（MSAL）配置文件中 redirect_uri 的值。
   • Enter_the_Tenant_Subdomain_Here 并将其替换为 Directory （tenant） 子域。 例如，如果租户主域为 contoso.onmicrosoft.com，请使用 contoso。 如果不知道租户子域，请了解如何 阅读租户详细信息。

4. 打开 /app/src/main/AndroidManifest.xml 文件。

5. 查找占位符：

   • ENTER_YOUR_SIGNATURE_HASH_HERE 并将其替换为之前添加平台重定向 URL 时生成的 签名哈希 。

6. 打开 /app/src/main/java/com/azuresamples/msaldelegatedandroidkotlinsampleapp/MainActivity.kt 文件。

7. 查找命名 scopes 的属性，并设置 授予管理员同意中记录的范围。 如果尚未记录任何范围，可以将此范围列表留空。

   private const val scopes = "" // Developers should set the respective scopes of their Microsoft Graph resources here. For example, private const val scopes = "api://{clientId}/{ToDoList.Read} api://{clientId}/{ToDoList.ReadWrite}"
   

你已配置应用，并且已准备好运行。

1. 在 Visual Studio 中，打开 ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/appsettings.json 文件。
2. 查找占位符：
   1. Enter_the_Tenant_Subdomain_Here 并将其替换为 Directory （tenant） 子域。 例如，如果租户主域为 contoso.onmicrosoft.com，请使用 contoso。 如果没有租户名称，请了解如何 阅读租户详细信息。
   2. Enter_the_Application_Id_Here 并将其替换为之前注册的应用 的应用程序（客户端）ID 。
3. 在 Visual Studio 中，打开 ms-identity-ciam-dotnet-tutorial-main/1-Authentication/2-sign-in-maui/Platforms/Android/AndroidManifest.xml 文件。
4. 查找占位符：
   1. Enter_the_Application_Id_Here 并将其替换为之前注册的应用 的应用程序（客户端）ID 。

若要启用对 Microsoft Graph 资源的身份验证和访问，请执行以下步骤配置示例：

1. 在 Xcode 中，打开克隆的项目。

2. 打开 /MSALiOS/Configuration.swift 文件。

3. 查找占位符：

   • Enter_the_Application_Id_Here 并将其替换为之前注册的应用 的应用程序（客户端）ID 。
   • Enter_the_Redirect_URI_Here 并将其替换为在添加平台重定向 URL 时之前下载的 Microsoft 身份验证库 （MSAL） 配置文件中的 kRedirectUri 值。
   • Enter_the_Protected_API_Scopes_Here 并将其替换为 授予管理员同意中记录的范围。 如果尚未记录任何范围，可以将此范围列表留空。
   • Enter_the_Tenant_Subdomain_Here 并将其替换为 Directory （tenant） 子域。 例如，如果租户主域为 contoso.onmicrosoft.com，请使用 contoso。 如果不知道租户子域，请了解如何 阅读租户详细信息。

你已配置应用，并且已准备好运行。

若要生成并运行应用，请执行以下步骤：

1. 在工具栏中，从“运行配置”菜单中选择你的应用。

2. 在目标设备菜单中，选择要在其中运行应用的设备。

   如果没有配置任何设备，则需要创建 Android 虚拟设备以使用 Android 模拟器或连接物理 Android 设备。

3. 选择“ 运行 ”按钮。

4. 选择“ 以交互方式获取令牌 ”以请求访问令牌。

5. 如果选择 API - 执行 GET 以调用受保护的 ASP.NET 核心 Web API，则会收到错误。

有关调用受保护 Web API 的详细信息，请参阅后续 步骤

.NET MAUI 应用设计为在多个作系统和设备上运行。 需要选择要使用哪个目标来测试和调试应用。

将 Visual Studio 工具栏中的 “调试目标 ”设置为要调试和测试的设备。 以下步骤演示如何将 调试目标 设置为 Android：

1. 选择 “调试目标 ”下拉列表。
2. 选择 Android 模拟器。
3. 选择模拟器设备。

通过按 F5 或选择 Visual Studio 顶部的 播放按钮 来运行应用。

1. 现在可以测试示例 .NET MAUI Android 应用。 运行应用后，Android 应用窗口会显示在模拟器中：

   

2. 在显示的 Android 窗口中，选择“ 登录 ”按钮。 此时会打开浏览器窗口，系统会提示你登录。

   

   在登录过程中，系统会提示你授予各种权限（允许应用程序访问数据）。 成功登录和同意后，应用程序屏幕将显示主页。

   

若要生成并运行应用，请执行以下步骤：

1. 若要生成并运行代码，请从 Xcode 中的“产品”菜单中选择“运行”。 成功生成后，Xcode 将在模拟器中启动示例应用。
2. 选择“ 以交互方式获取令牌 ”以请求访问令牌。
3. 如果选择 API - 执行 GET 以调用受保护的 ASP.NET 核心 Web API，则会收到错误。

有关调用受保护的 Web API 的详细信息，请参阅后续 步骤

• 在示例 Android （Kotlin） 应用中登录用户并调用受保护的 Web API。

• 自定义默认品牌。
• 使用 Google 配置登录。

• 在示例 iOS （Swift） 应用中登录用户并调用受保护的 Web API。