Dps Certificate - Verify Certificate

Başvuru

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Sertifikanın özel anahtarına sahip olduğunu doğrulayın.
Önceden karşıya yüklenen sertifikayı doğrulama tarafından verilen yaprak sertifikayı sağlayarak sertifikanın özel anahtarının sahip olduğunu doğrular.

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
certificateName	path	True	string	Sağlama hizmetinin erişmek için kullandığı sertifikanın zorunlu mantıksal adı.
provisioningServiceName	path	True	string	Sağlama hizmeti adı.
resourceGroupName	path	True	string	Kaynak grubu adı.
subscriptionId	path	True	string	Abonelik tanımlayıcısı.
api-version	query	True	string	API sürümü.
certificate.created	query		string date-time	Sertifika oluşturma zamanı.
certificate.hasPrivateKey	query		boolean	Sertifikanın özel anahtar içerip içermediğini gösterir.
certificate.isVerified	query		boolean	Sertifikanın özel anahtarın sahibi tarafından doğrulandığını gösterir.
certificate.lastUpdated	query		string date-time	Sertifika son güncelleştirme zamanı.
certificate.name	query		string	Sertifikanın Ortak Adı.
certificate.nonce	query		string	Sahip Olma Kanıtı'nın gösterilmesi için rastgele sayı oluşturuldu.
certificate.purpose	query		CertificatePurpose	Sertifikanın amacını açıklama.
certificate.rawBytes	query		string byte	Sertifikanın ham verileri.

İstek Başlığı

Name	Gerekli	Tür	Description
If-Match	True	string	Sertifikanın ETag'i.

İstek Gövdesi

Name	Tür	Description
certificate	string	X509 sertifikası .cer dosyasının veya yalnızca .pem dosya içeriğinin temel-64 gösterimi.

Yanıtlar

Name	Tür	Description
200 OK	CertificateResponse	Tamam
Other Status Codes	ErrorDetails	Varsayılan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

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="
}

Tanımlar

Name	Description
CertificateProperties	X509 CA Sertifikasının açıklaması.
CertificatePurpose	Sertifikanın amacını açıklama.
CertificateResponse	X509 Sertifikası.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorDetails	Hata ayrıntıları.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
VerificationCodeRequest	JSON serileştirilmiş yaprak sertifikası

CertificateProperties

X509 CA Sertifikasının açıklaması.

Name	Tür	Description
certificate	string	X509 sertifikası .cer dosyasının veya yalnızca .pem dosya içeriğinin temel-64 gösterimi.
created	string	Sertifikanın oluşturma tarihi ve saati.
expiry	string	Sertifikanın son kullanma tarihi ve saati.
isVerified	boolean	Sertifikanın doğrulanıp doğrulanmamış olduğunu belirler.
subject	string	Sertifikanın konu adı.
thumbprint	string	Sertifikanın parmak izi.
updated	string	Sertifikanın son güncelleştirme tarihi ve saati.

CertificatePurpose

Sertifikanın amacını açıklama.

Name	Tür	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

X509 Sertifikası.

Name	Tür	Description
etag	string	Varlık etiketi.
id	string	Kaynak tanımlayıcısı.
name	string	Sertifikanın adı.
properties	CertificateProperties	sertifikanın özellikleri
systemData	systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
type	string	Kaynak türü.

createdByType

Kaynağı oluşturan kimliğin türü.

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Hata ayrıntıları.

Name	Tür	Description
code	integer	Hata kodu.
details	string	Hata ayrıntıları.
httpStatusCode	string	HTTP durum kodu.
message	string	Hata iletisi.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimliğin türü.

VerificationCodeRequest

JSON serileştirilmiş yaprak sertifikası

Name	Tür	Description
certificate	string	X509 sertifikası .cer dosyasının veya yalnızca .pem dosya içeriğinin temel-64 gösterimi.

Share via