创建 temporaryAccessPassMethod

命名空间:microsoft.graph

在用户上创建新的 temporaryAccessPassAuthenticationMethod 对象。 用户只能有一个在其指定生存期内可以使用的临时访问密码。 如果用户在当前临时访问密码有效时需要新的临时访问密码,则管理员可以为用户创建新的临时访问密码,将删除以前的临时访问密码,并创建新的临时访问密码。

此 API 可用于以下国家级云部署

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) UserAuthenticationMethod.Read UserAuthenticationMethod.ReadWrite.All、UserAuthenticationMethod.Read.All、UserAuthenticationMethod.ReadWrite
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 UserAuthenticationMethod.Read.All UserAuthenticationMethod.ReadWrite.All

重要

在具有工作或学校帐户的委托方案中,如果已登录用户对其他用户进行作,则必须为他们分配受支持的Microsoft Entra角色或具有受支持角色权限的自定义角色。 此作支持以下最低特权角色。

  • 身份验证管理员
  • 特权身份验证管理员

HTTP 请求

POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
Content-Type application/json. 必需。

请求正文

在请求正文中,提供 temporaryAccessPassAuthenticationMethod 对象的 JSON 表示形式。

下表描述了创建 temporaryAccessPassAuthenticationMethod 时可以使用的可选属性。

属性 类型 说明
isUsableOnce 布尔值 可选。 确定传递是否限制为一次性使用。 如果 true为 ,则传递可以使用一次;如果 false为 ,则可以在其生存期内多次使用该传递 InMinutes 设置。 多用途临时访问密码 (isUsableOnce = false) ,只有在 临时访问传递身份验证方法策略允许的情况下,才能创建并用于登录。
lifetimeInMinutes Int32 可选。 temporaryAccessPass 的生存期(以分钟为单位),从创建时开始或 startDateTime(如果已设置)。 必须介于 10 到 43200 (相当于 30 天) 。 如果未指定,则会应用临时访问传递身份验证方法策略中的 defaultLifetimeInMinutes 设置。
startDateTime DateTimeOffset 可选。 temporaryAccessPass 可供使用的日期和时间。 如果未指定,则临时访问密码可在创建后立即使用。

响应

如果成功,此方法在 201 Created 响应正文中返回响应代码和 temporaryAccessPassAuthenticationMethod 对象。

示例

请求

POST https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
Content-Type: application/json

{
    "startDateTime": "2022-06-05T00:00:00.000Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false
}

响应

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
    "id": "6f1967b7-15e8-4935-ac26-d50770ed07a7",
    "temporaryAccessPass": "+drkzqAD",
    "createdDateTime": "2022-06-02T16:21:09.765173Z",
    "startDateTime": "2022-06-05T00:00:00Z",
    "lifetimeInMinutes": 60,
    "isUsableOnce": false,
    "isUsable": false,
    "methodUsabilityReason": "NotYetValid"
}