Entra ID 的硝基配置¶
Compatible Nitrokeys |
|||||||
|---|---|---|---|---|---|---|---|
✓ active |
✓ active |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
Nitrokey 3 和 Nitrokey Passkey 密钥支持为 Microsoft Entra 配置凭据,以便在企业场景中实现员工的无缝入职。
设置¶
需要一个 Microsoft Entra 应用程序,才能通过编程方式注册用户凭据。在此,我们为您提供相应的配置指南,前提是您具备相应的权限。
Login to Entra Admin portal. Take a note of the primary domain which you will need later. Go to App Registrations on the left blade.
选择“新注册”。
创建一个新应用并设置名称。点击“注册”。
请在此处记下客户端 ID 和租户 ID。稍后您会用到它们。转到应用程序面板中的“API 权限”。
Click on Add a permission.
Select Microsoft Graph.
选择“应用权限”。
搜索 UserAuthenticationMethod.ReadWrite.All 并将其选中。
搜索 User.ReadWrite.All 并选中它(仅当您希望能够通过 pynitrokey 创建用户时才需执行此操作)。点击“添加权限”按钮。
请核对已授予的权限。
点击“授予管理员同意”,然后予以批准。
返回应用主页,然后从左侧面板中选择“证书和密钥”
点击“新建客户端密钥”
输入名称和有效期,然后点击“添加”
请记下客户端密钥(之后将无法查看该密钥)。
在左侧窗格中单击“身份验证方法”。
Select Passkey (FIDO2).
Click on the Configure tab.
Click on Default Passkey profile
取消勾选“强制验证”(仅当您使用的硝基未获得 FIDO Alliance 认证时。在撰写本文时,仅硝基 3A Mini 具备此项认证。)
Click Save.
您已在该流程中记录了租户 ID、客户端 ID、客户端密钥和主域名。请使用这些信息创建一个 config.json 文件。示例如下所示。
{ "tenant": "49d2c4c8-9144-49ea-b5f3-fc11b848cd72", "client": "e9f25c9c-3870-4aa8-9659-a40f09de093e", "secret": "************************************", "domain": "Cryptane.onmicrosoft.com" }
使用方法¶
您可以使用 pynitrokey 工具为租户中的用户配置硝基。
nitropy fido2 provision-credential entra -c config.json <username> --create-user
此处的 <username> 可以是用户的电子邮件地址(即微软术语中的“用户主体”),也可以是该地址中 @ 符号前面的部分。--create-user 参数指示该工具,如果该用户在 Entra 租户中不存在,则创建该用户。
Verification¶
用户可使用新分配的 Nitrokey 登录其 Microsoft 账户。请访问`,并参考“使用 Nitrokey 登录 Microsoft 的示例”<passwordless-microsoft.html#sample-login-to-microsoft-with-the-nitrokey-fido2>`__,了解如何使用这枚新分配的 Nitrokey 进行登录。
您可以按照以下步骤,在 Entra 管理门户中验证已配置的凭据。
在 Entra 管理中心左侧面板中,转到“用户”选项。
如果该用户是通过 --create-user 选项创建的,您可能在列表中找到该条目。如果是已存在的用户,该条目也会出现在列表中。点击已绑定凭证的用户。
Click on Authentication methods on the user blade.
将显示包含硝基 UUID 前 5 个字符的已注册凭据。您可以点击三个点,然后点击“查看详情”,以查看该已注册凭据的详细信息。
将显示有关该凭证的更多信息。您可以对其进行验证。