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	OK
Other Status Codes	ErrorDetails	既定のエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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	リソースを作成した ID の種類。
ErrorDetails	エラーの詳細。
systemData	リソースの作成と最後の変更に関連するメタデータ。
VerificationCodeRequest	JSON でシリアル化されたリーフ証明書

CertificateProperties

X509 CA 証明書の説明。

名前	型	説明
certificate	string	x509 証明書の base-64 表現.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

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

エラーの詳細。

名前	型	説明
code	integer	エラーコード。
details	string	エラーの詳細です。
httpStatusCode	string	HTTP 状態コード。
message	string	エラーメッセージ。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

VerificationCodeRequest

JSON でシリアル化されたリーフ証明書

名前	型	説明
certificate	string	x509 証明書の base-64 表現.cerファイルまたは .pem ファイルの内容のみ。

次の方法で共有