Dps Certificate - Verify Certificate

Ссылка

Service:: IoT Hub Device Provisioning Service

API Version:: 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

With optional parameters:

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	Base-64 — представление сертификата X509 .cer файла или просто содержимого PEM-файла.

Ответы

Имя	Тип	Описание
200 OK	CertificateResponse	ОК
Other Status Codes	ErrorDetails	Ответ об ошибке по умолчанию.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

DPSVerifyCertificate

Sample Request

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": "#####################################"
}

Sample Response

Status code:: 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.
CertificatePurpose	Опишите назначение сертификата.
CertificateResponse	Сертификат X509.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorDetails	Сведения об ошибке.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
VerificationCodeRequest	Сериализованный конечный сертификат JSON

CertificateProperties

Описание сертификата ЦС X509.

Имя	Тип	Описание
certificate	string	Base-64 — представление сертификата X509 .cer файла или просто содержимого PEM-файла.
created	string	Дата и время создания сертификата.
expiry	string	Дата и время окончания срока действия сертификата.
isVerified	boolean	Определяет, проверен ли сертификат.
subject	string	Имя субъекта сертификата.
thumbprint	string	отпечаток сертификата.
updated	string	Дата и время последнего обновления сертификата.

CertificatePurpose

Опишите назначение сертификата.

Имя	Тип	Описание
clientAuthentication	string
serverAuthentication	string

CertificateResponse

Сертификат X509.

Имя	Тип	Описание
etag	string	Тег сущности.
id	string	Идентификатор ресурса.
name	string	Имя сертификата.
properties	CertificateProperties	свойства сертификата
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.
type	string	Тип ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Сведения об ошибке.

Имя	Тип	Описание
code	integer	Код ошибки.
details	string	Сведения об ошибке.
httpStatusCode	string	Код состояния HTTP.
message	string	Сообщение об ошибке.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое последним изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, которое последним изменял ресурс.

VerificationCodeRequest

Сериализованный конечный сертификат JSON

Имя	Тип	Описание
certificate	string	Base-64 — представление сертификата X509 .cer файла или просто содержимого PEM-файла.

Share via