Dps Certificate - Verify Certificate

Referensi

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Verifikasi kepemilikan kunci privat sertifikat.
Memverifikasi kepemilikan kunci privat sertifikat dengan menyediakan sertifikasi daun yang dikeluarkan oleh verifikasi sertifikat yang diunggah sebelumnya.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
certificateName	path	True	string	Nama logis wajib sertifikat, yang digunakan layanan provisi untuk mengakses.
provisioningServiceName	path	True	string	Nama layanan provisi.
resourceGroupName	path	True	string	Nama grup sumber daya.
subscriptionId	path	True	string	Pengidentifikasi langganan.
api-version	query	True	string	Versi API.
certificate.created	query		string date-time	Waktu pembuatan sertifikat.
certificate.hasPrivateKey	query		boolean	Menunjukkan apakah sertifikat berisi kunci privat.
certificate.isVerified	query		boolean	Menunjukkan apakah sertifikat telah diverifikasi oleh pemilik kunci privat.
certificate.lastUpdated	query		string date-time	Waktu terakhir diperbarui sertifikat.
certificate.name	query		string	Nama Umum untuk sertifikat.
certificate.nonce	query		string	Angka acak yang dihasilkan untuk menunjukkan Bukti Kepemilikan.
certificate.purpose	query		CertificatePurpose	Menjelaskan tujuan sertifikat.
certificate.rawBytes	query		string byte	Data mentah sertifikat.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
If-Match	True	string	ETag sertifikat.

Isi Permintaan

Nama	Jenis	Deskripsi
certificate	string	representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.

Respons

Nama	Jenis	Deskripsi
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Respons kesalahan default.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

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

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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

Definisi

Nama	Deskripsi
CertificateProperties	Penjabaran dari Sertifikat CA X509.
CertificatePurpose	Menjelaskan tujuan sertifikat.
CertificateResponse	Sertifikat X509.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorDetails	Detail kesalahan.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
VerificationCodeRequest	Sertifikat daun berseri JSON

CertificateProperties

Penjabaran dari Sertifikat CA X509.

Nama	Jenis	Deskripsi
certificate	string	representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.
created	string	Tanggal dan waktu pembuatan sertifikat.
expiry	string	Tanggal dan waktu kedaluwarsa sertifikat.
isVerified	boolean	Menentukan apakah sertifikat telah diverifikasi.
subject	string	Nama subjek sertifikat.
thumbprint	string	Thumbprint sertifikat.
updated	string	Tanggal dan waktu pembaruan terakhir sertifikat.

CertificatePurpose

Menjelaskan tujuan sertifikat.

Nama	Jenis	Deskripsi
clientAuthentication	string
serverAuthentication	string

CertificateResponse

Sertifikat X509.

Nama	Jenis	Deskripsi
etag	string	Tag entitas.
id	string	Pengidentifikasi sumber daya.
name	string	Nama sertifikat.
properties	CertificateProperties	properti sertifikat
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type	string	Jenis sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detail kesalahan.

Nama	Jenis	Deskripsi
code	integer	Kode kesalahan.
details	string	Detail kesalahan.
httpStatusCode	string	Kode status HTTP.
message	string	Pesan kesalahan.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir memodifikasi sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah sumber daya.

VerificationCodeRequest

Sertifikat daun berseri JSON

Nama	Jenis	Deskripsi
certificate	string	representasi base-64 dari sertifikat X509 .cer file atau hanya konten file .pem.

Share via