通过

适用于 Linux 的 Microsoft 单一登录有哪些新增功能?

Microsoft 定期添加和修改 Microsoft 标识平台的特性和功能，以提高其安全性、可用性和标准符合性。

除非另有说明，否则此处所述更改仅适用于在所述更改生效日期之后注册的应用程序。

请定期查看本文以了解以下内容：

  • 已知问题和修复方案
  • 协议更改
  • 已弃用的功能

本文提供有关适用于 Linux Microsoft单一登录的最新更新的信息。

包存储库

Microsoft使用以下包存储库来分发 Microsoft适用于 Linux 的标识代理和Microsoft标识诊断。 包以任一 .deb 或 .rpm 格式提供，但仅支持 Ubuntu Long-Term 支持 （LTS） 和 Red Hat Enterprise Linux （LTS）。

Microsoft -Identity-Broker - 版本生命周期和支持矩阵

下表列出了当前支持的身份运行时 SDK 版本并获得安全修补程序。

主要版本 主要用途 最新版本 已支持 来源
稳定 生产工作负载 2.0.1 ✅ 是 Ubuntu 24.04 - Noble
Ubuntu 22.04 - Jammy
RHEL8
RHEL9
内测快速通道 测试即将发布的版本 2.5.x ❌ 否 Ubuntu 24.04 - Noble
Ubuntu 22.04 - Jammy
RHEL8
RHEL9
RHEL10

注释

当前生产版本 microsoft-identity-broker 为 2.0.1。

我们在 packages.microsoft.com 中引入了一个“高速内测频道”，以便测试版本号超过当前生产版本2.0.1的包。 此通道不适用于生产用途，可能包含中断性变更或不完整的功能。

版本 2.0.2 及更高版本的重要说明

警告

版本 2.0.2 及更高版本体现了主要的体系结构变更，即从基于 Java 的代理程序实现转换为基于 C++ 的实现。 如果您要从以前的版本（正式版：2.0.1 或更低版本，快速预览版：2.0.4 或更早版本）升级，在执行升级后，用户需要重新注册并重新加入他们的设备。

添加包存储库的说明

添加存储库

若要为 Linux 分发版添加适当的包存储库，请按照以下说明作：

  1. 安装Microsoft生产包签名密钥。

    sudo apt install curl gpg
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings
rm microsoft.gpg

  2. Microsoft Linux 存储库添加并更新到系统存储库列表。

    sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/ubuntu/$(lsb_release -rs)/prod $(lsb_release -cs) main" >> /etc/apt/sources.list.d/microsoft-ubuntu-$(lsb_release -cs)-prod.list'
sudo apt update

Changes

警告

从版本 2.0.2 或更低版本升级到 2.5.x 时，在执行早期版本的干净卸载后，用户需要重新注册并重新注册其设备。

2.5.2 - 2026 年 2 月 11 日 - （快速成员频道预览版）

  • （Linux）修复 GTK4 的智能卡对话框布局
  • （Linux）修复了在重复使用浏览器时的错误回调问题。

资产

2.5.1 - 2026 年 1 月 29 日 - （高速 Insiders 通道预览版）

  • （Linux）修复 GTK4 的智能卡对话框布局
  • （Linux）修复了在重复使用浏览器时的错误回调问题。
  • （Linux）在 CPP broker 中添加对 TLS 1.3 的 GetDeviceState 支持
  • （Linux）处理sem_timedwait失败，因为进程在 Msai：：SecureStorageLock 和 Msoa：：SystemMutex 中接收信号

资产

2.5.0 - 2026 年 1 月 13 日 - （快速体验通道预览版）

  • （Linux）更改包文件名以包含目标 OS
  • （Linux）杂项错误修复
  • （Linux）在 Linux 代理包中包含 LICENSE 文件和特定于代理的 CHANGELOG.md。
  • （Linux）更新嵌入式身份验证窗口的默认设置（标题/大小），并改进居中行为。
  • （Linux）添加对 RHEL 10 的支持
  • （Linux）添加用于设备注册管理和诊断的 dsreg 命令行工具
  • （Linux）更新 Linux 设备代理使用的证书/密钥位置
  • （Linux）在代理生成的遥测数据中包含代理版本
  • （xplat）添加 DUNA xplat 和 DUNA iOS CBA

资产

2.0.3 - 2025 年 10 月 21 日 - （快速预览体验成员频道预览版）

  • 添加了对 microsoft-identity-broker-diagnostics 包的支持。
  • 为了保持一致性，将服务组件 linux_broker 重命名为 microsoft-identity-broker。
  • 为了保持一致性，将服务组件 linux_devicebroker 重命名为 microsoft-identity-device-broker。
  • 更新 x-client-os 以使用发行版名称

资产

2.0.2 - 2025 年 9 月 19 日 - （Insiders 快速通道预览版）

预览更新，以便使用新重写的 C++ 代理，而不是以前的基于 Java 的代理。

  • 引入了对 Linux 设备上使用智能卡、基于证书的身份验证（CBA）或具有个人身份验证（PIV）配置文件的 FIDO2 密钥来支持抗网络钓鱼的多因素身份验证（PRMFA）的支持。
  • 添加了令牌请求的标头，以便区分不同版本的身份代理。
  • 当用户使用新的 Linux 设备配置单一登录时，设备会进行 Microsoft Entra 加入，而非 Microsoft Entra 注册。 联接会导致建立与整个设备的信任，而注册仅限于在用户配置文件内创建信任。 加入信任是将来启用 platformSSO 的先决条件步骤。
  • 已将设备代理服务重命名为 microsoft-identity-devicebroker。
  • 不再有名为 microsoft-identity-broker 的用户代理服务。 用户代理现在是通过 dbus 连接调用的可执行文件
  • 设备证书从密钥链移动到 /etc/ssl/private。 在 private 目录中，代理为每个租户创建设备证书、每个租户的会话传输密钥以及存储在该目录中的无设备密钥。 所有其他用户数据（如 AT/RT）都存储在 KeyChain 中，并通过Microsoft Authentication Library（MSAL）进行访问。

资产

Linux 上的 MSAL Python 和 MSAL .NET代理支持 - 2025 年 6 月 13 日

2.0.1 - 2024 年 11 月 18 日

  • 发布对 ubuntu 24.04 的包支持

资产

2.0.0 - 2024 年 3 月 21 日

  • 故障修复

资产

1.7.0 - 2024 年 1 月 31 日

  • 解决注册失败时的 1001错误代码
  • 更新 Red Hat Enterprise Linux Broker 的安装脚本
  • 将许可证添加到 Linux 代理包

1.6.1 - 2023 年 8 月 17 日

  • [PATCH]在 Linux Broker 中为 X509 证书执行安全反序列化（#2483）

资产

1.6.0 - 2023 年 6 月 29 日

  • 添加了对 Red Hat Enterprise Linux 8 和 9 的支持。

资产

1.5.1 - 2023 年 5 月 9 日

  • 更新序列化库
  • 未考虑内存消耗的变化
  • 机密服务版本升级 - kubuntu

资产

1.4.1 - 2022 年 10 月 22 日

  • 资源所有者密码凭据（ROPC）测试钩子。
  • 添加了密钥控制“1001”错误的日志记录。

资产

1.4.0 - 2022 年 10 月 26 日

  • Java 17 支持
  • Ubuntu 22 支持

资产

1.3.0 - 2022 年 10 月 26 日

资产

1.2.0 - 2022 年 10 月 26 日

资产

Microsoft-Identity-Diagnostics

2.0.3 - 2025 年 10 月 21 日 - （预览版）

  • 添加了对 microsoft-identity-broker-diagnostics 包的支持。
  • 将linux_broker重命名为 microsoft-identity-broker

资产

1.01 - 2022 年 11 月 29 日

资产

1.0.1 - 2022 年 8 月 7 日

资产

版本故障排除

版本兼容性

在升级之前：

  • 检查当前版本： dpkg -l microsoft-identity-broker
  • 查看目标版本中的重大更改
  • 规划潜在的设备重新注册

常见迁移问题

Java到 C++ Broker 迁移（2.0.1 → 2.0.2+）：

  • 症状：升级后身份验证失败
  • 解决方案：需要完整卸载并清理重新安装
  • 步骤：删除所有代理状态，重新安装新版本，重新注册设备

包安装问题：

  • 验证存储库配置是否与 Ubuntu/RHEL 版本匹配
  • 检查与 packages.microsoft.com 的网络连接
  • 确保有足够的磁盘空间进行安装

获取帮助

对于特定于版本的问题：

  • 查看版本说明中的已知问题

  • 验证是否满足系统要求

  • 查看日志使用：journalctl --user -u microsoft-identity-broker.service

  • 考虑使用 microsoft-identity-diagnostics 包进行详细的故障排除

  • Last updated on