如何将重定向 URI 添加到应用程序

若要登录用户,应用程序必须向 Microsoft Entra 授权终结点发送登录请求,并将重定向 URI 指定为参数。 重定向 URI 是一项关键安全功能,可确保 Microsoft Entra 身份验证服务器仅向预期收件人发送授权代码和访问令牌。

先决条件

添加重定向 URI

重定向 URI 是Microsoft标识平台在身份验证后发送安全令牌的位置。 重定向 URI 在 Microsoft Entra 管理中心的 平台配置 中进行配置。 对于 Web单页应用程序,需要手动指定重定向 URI。 对于 移动和桌面 平台,可以从生成的重定向 URI 中进行选择。

按照以下步骤根据目标平台或设备配置设置:

  1. 在 Microsoft Entra 管理中心门户中,在“应用注册”中选择你的应用。

  2. 在“管理”下,选择“身份验证”。

  3. 在“平台配置”下,选择“添加平台” 。

  4. 配置平台中,选择与应用程序类型(平台)对应的磁贴来配置其设置。

    Azure 门户中的“平台配置”窗格的屏幕截图。

    平台 配置参数 示例:
    网络 输入服务器上运行的 Web 应用的 重定向 URI 。 还可以添加前通道注销 URL Node.js:
    http://localhost:3000/auth/redirect
    ASP.NET Core:
    https://localhost:7274/signin-oidc
    https://localhost:7274/signout-callback-oidc(前通道注销 URL)
    蟒:
    http://localhost:3000/getAToken
    单页应用程序 使用 JavaScript、Angular、React.js或 Blazor WebAssembly 为客户端应用输入 重定向 URI 。 还可以添加前通道注销 URL JavaScript、React:
    http://localhost:3000
    Angular:
    http://localhost:4200/
    iOS/macOS 输入应用程序中的 Bundle ID,这将为您生成重定向 URI。 可以在 Xcode 的“生成设置”或 Info.plist 中找到它。
    工作人员租户:
    com.<yourname>.identitysample.MSALMacOS
    安卓 输入应用 包名称,该名称会为你生成重定向 URI。 可在 AndroidManifest.xml 文件中找到它。 也请生成签名哈希并输入它 Kotlin:
    com.azuresamples.msaldelegatedandroidkotlinsampleapp
    .NET MAUI:
    msal{CLIENT_ID}://auth
    爪哇岛:
    com.azuresamples.msalandroidapp
    移动和桌面应用程序 为不使用 MSAL 或中转站的桌面应用或移动应用选择此平台。 选择建议的 重定向 URI,或指定一个或多个 自定义重定向 URI 嵌入式浏览器桌面应用:
    https://login.partner.microsoftonline.cn/common/oauth2/nativeclient
    系统浏览器桌面应用:
    http://localhost
  5. 选择“配置”以完成平台配置。

重定向 URI 限制

对于添加到应用注册的重定向 URI,其格式方面存在某些限制。 有关这些限制的详细信息,请参阅重定向 URI(回复 URL)的限制和局限