通过

identityApiConnector：uploadClientCertificate

命名空间：microsoft.graph

将 PKCS 12 格式密钥 (.pfx) 上传到 API 连接器的身份验证配置。 输入是 PKCS 12 证书内容的 base-64 编码值。 此方法返回 apiConnector。

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

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

权限

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

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） APIConnectors.ReadWrite.All 不可用。
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 APIConnectors.ReadWrite.All 不可用。

重要

在具有工作或学校帐户的委托方案中，必须为登录用户分配受支持的Microsoft Entra角色或具有支持的角色权限的自定义角色。 外部 ID用户流管理员是此操作支持的最低特权角色。

HTTP 请求

POST /identity/apiconnectors/{id}/uploadClientCertificate

请求标头

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

请求正文

在请求正文中，提供具有以下参数的 JSON 对象。

属性 类型 说明
pkcs12Value String 这是用于发送 pfx 内容的字段。 该值应是实际证书内容的 base-64 编码版本。 必填。
密码 String 这是 pfx 文件的密码。 必填。 如果未使用密码，则仍必须提供 值 ""。

响应

如果成功，此方法将返回响应 200 OK 代码和 apiConnector ，其中包含 authenticationConfiguration 客户端证书的公共信息。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/identity/apiconnectors/{id}/uploadClientCertificate
Content-type: application/json

{
    "pkcs12Value": "eyJhbGciOiJSU0EtT0FFUCIsImVuYyI6IkEyNTZHQ00ifQ...kDJ04sJShkkgjL9Bm49plA",
    "password": "<password>"
}

响应

以下示例显示了相应的响应。

注意：authenticationConfiguration 响应的类型为 microsoft.graph.clientCertificateAuthentication ，因为这表示上传的证书的公共信息。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/apiConnectors/$entity",
    "id": "45715bb8-13f9-4bf6-927f-ef96c102d394",
    "displayName": "My API connector",
    "targetUrl": "https://api.contoso.com/endpoint",
    "authenticationConfiguration": {
        "@odata.type": "#microsoft.graph.clientCertificateAuthentication",
        "certificateList": [
            {
                "thumbprint": "0EB255CC895477798BA418B378255204304897AD",
                "notAfter": 1666350522,
                "notBefore": 1508670522,
                "isActive": true
            }
        ]
    }
}