你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Dps Certificate - Verify Certificate

服务:

IoT Hub Device Provisioning Service

API 版本:

2022-12-12

验证证书的私钥所有权。
通过提供验证预上传证书颁发的叶证书来验证证书的私钥所有权。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify?api-version=2022-12-12

具有可选参数:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12

URI 参数

名称	在	必需	类型	说明
certificateName	path	True	string	预配服务用于访问的证书的必需逻辑名称。
provisioningServiceName	path	True	string	预配服务名称。
resourceGroupName	path	True	string	资源组名称。
subscriptionId	path	True	string	订阅标识符。
api-version	query	True	string	API 的版本。
certificate.created	query		string (date-time)	证书创建时间。
certificate.hasPrivateKey	query		boolean	指示证书是否包含私钥。
certificate.isVerified	query		boolean	指示是否已由私钥的所有者验证证书。
certificate.lastUpdated	query		string (date-time)	上次更新的证书时间。
certificate.name	query		string	证书的公用名。
certificate.nonce	query		string	生成的随机数以指示所有权证明。
certificate.purpose	query		CertificatePurpose	描述证书的用途。
certificate.rawBytes	query		string (byte)	证书的原始数据。

请求头

名称	必需	类型	说明
If-Match	True	string	证书的 ETag。

请求正文

名称	类型	说明
certificate	string	x509 证书的 base-64 表示形式.cer文件或仅 .pem 文件内容。

响应

名称	类型	说明
200 OK	CertificateResponse	还行
Other Status Codes	ErrorDetails	默认错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

DPSVerifyCertificate

示例请求

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert/verify?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12


{
  "certificate": "#####################################"
}

示例响应

状态代码:

200

{
  "properties": {
    "subject": "CN=andbucdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": true,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpTQ="
}

定义

名称	说明
CertificateProperties	X509 CA 证书的说明。
CertificatePurpose	描述证书的用途。
CertificateResponse	X509 证书。
createdByType	创建资源的标识的类型。
ErrorDetails	错误详细信息。
systemData	与创建和上次修改资源相关的元数据。
VerificationCodeRequest	JSON 序列化的叶证书

CertificateProperties

Object

X509 CA 证书的说明。

名称	类型	说明
certificate	string (byte)	x509 证书的 base-64 表示形式.cer文件或仅 .pem 文件内容。
created	string (date-time-rfc1123)	证书的创建日期和时间。
expiry	string (date-time-rfc1123)	证书的到期日期和时间。
isVerified	boolean	确定是否已验证证书。
subject	string	证书的使用者名称。
thumbprint	string	证书的指纹。
updated	string (date-time-rfc1123)	证书的上次更新日期和时间。

CertificatePurpose

枚举

描述证书的用途。

值	说明
clientAuthentication
serverAuthentication

CertificateResponse

Object

X509 证书。

名称	类型	说明
etag	string	实体标记。
id	string	资源标识符。
name	string	证书的名称。
properties	CertificateProperties	证书的属性
systemData	systemData	与创建和上次修改资源相关的元数据。
type	string	资源类型。

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

ErrorDetails

Object

错误详细信息。

名称	类型	说明
code	integer (int32)	错误代码。
details	string	错误详细信息。
httpStatusCode	string	HTTP 状态代码。
message	string	错误消息。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

VerificationCodeRequest

Object

JSON 序列化的叶证书

名称	类型	说明
certificate	string	x509 证书的 base-64 表示形式.cer文件或仅 .pem 文件内容。