命名空间:microsoft.graph
在用户上创建新的 temporaryAccessPassAuthenticationMethod 对象。 用户只能有一个可在其指定生存期内可用的临时访问通行证。 如果用户在当前临时访问通行证有效时需要新的临时访问通行证,则管理员可以为用户创建新的临时访问通行证,删除以前的临时访问通行证,并创建新的临时访问通行证。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
对其他用户执行操作的权限
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | UserAuthenticationMethod.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用程序 | UserAuthenticationMethod.ReadWrite.All |
对于管理员对另一用户执行操作的委派方案,管理员需要以下 Azure AD 角色之一:
- 全局管理员
- 特权身份验证管理员
- 身份验证管理员
HTTP 请求
POST /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | Bearer {token}。必需。 |
| Content-Type | application/json. Required. |
请求正文
在请求正文中,提供 temporaryAccessPassAuthenticationMethod 对象的 JSON 表示形式。
下表描述了创建 temporaryAccessPassAuthenticationMethod 时可以使用的可选属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| isUsableOnce | 布尔值 | 可选。 确定传递是否限制为一次性使用。 如果 true可以使用传递一次,则 false可在其生存期内多次使用该传递 InMinutes 设置。 多用临时访问传递 (isUsableOnce = false) ,只有在 临时访问传递身份验证方法策略允许的情况下,才能创建并用于登录。 |
| lifetimeInMinutes | Int32 | 可选。 临时AccessPass 的生存期(以分钟为单位),从创建时间开始,或者在 startDateTime(如果设置)。 必须介于 10 到 43200 (等效于 30 天) 。 如果未指定,则应用 临时访问密码身份验证方法策略中的 defaultLifetimeInMinutes 设置。 |
| startDateTime | DateTimeOffset | 可选。 临时AccessPass可供使用的日期和时间。 如果未指定,则临时访问密码在创建后可立即使用。 |
响应
如果成功,此方法在响应正文中返回 201 Created 响应代码和 temporaryAccessPassAuthenticationMethod 对象。
示例
请求
HTTP
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
}
C#
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var temporaryAccessPassAuthenticationMethod = new TemporaryAccessPassAuthenticationMethod
{
StartDateTime = DateTimeOffset.Parse("2022-06-05T00:00:00Z"),
LifetimeInMinutes = 60,
IsUsableOnce = false
};
await graphClient.Users["{user-id}"].Authentication.TemporaryAccessPassMethods
.Request()
.AddAsync(temporaryAccessPassAuthenticationMethod);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
JavaScript
const options = {
authProvider,
};
const client = Client.init(options);
const temporaryAccessPassAuthenticationMethod = {
startDateTime: '2022-06-05T00:00:00.000Z',
lifetimeInMinutes: 60,
isUsableOnce: false
};
await client.api('/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods')
.post(temporaryAccessPassAuthenticationMethod);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
Java
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
TemporaryAccessPassAuthenticationMethod temporaryAccessPassAuthenticationMethod = new TemporaryAccessPassAuthenticationMethod();
temporaryAccessPassAuthenticationMethod.startDateTime = OffsetDateTimeSerializer.deserialize("2022-06-05T00:00:00Z");
temporaryAccessPassAuthenticationMethod.lifetimeInMinutes = 60;
temporaryAccessPassAuthenticationMethod.isUsableOnce = false;
graphClient.users("071cc716-8147-4397-a5ba-b2105951cc0b").authentication().temporaryAccessPassMethods()
.buildRequest()
.post(temporaryAccessPassAuthenticationMethod);
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
Go
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
requestBody := msgraphsdk.NewTemporaryAccessPassAuthenticationMethod()
startDateTime, err := time.Parse(time.RFC3339, "2022-06-05T00:00:00.000Z")
requestBody.SetStartDateTime(&startDateTime)
lifetimeInMinutes := int32(60)
requestBody.SetLifetimeInMinutes(&lifetimeInMinutes)
isUsableOnce := false
requestBody.SetIsUsableOnce(&isUsableOnce)
userId := "user-id"
result, err := graphClient.UsersById(&userId).Authentication().TemporaryAccessPassMethods().Post(requestBody)
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
PowerShell
Import-Module Microsoft.Graph.Identity.SignIns
$params = @{
StartDateTime = [System.DateTime]::Parse("2022-06-05T00:00:00.000Z")
LifetimeInMinutes = 60
IsUsableOnce = $false
}
New-MgUserAuthenticationTemporaryAccessPassMethod -UserId $userId -BodyParameter $params
有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息,请参阅 SDK 文档。
响应
注意: 为了提高可读性,可能缩短了此处显示的响应对象。
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"
}
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 tilarso)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
