Method: challenge.verify

challenge.verify API

HTTP リクエスト

POST https://verifiedaccess.googleapis.com/v1/challenge:verify

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "challengeResponse": {
    object (SignedData)
  },
  "expectedIdentity": string
}
フィールド
challengeResponse

object (SignedData)

チャレンジに対して生成されたレスポンス
expectedIdentity

string

サービスは必要に応じて、鍵に関連付けられているデバイスまたはユーザーに関する ID 情報を提供できます。EMK の場合、この値は登録されているドメインです。EUK の場合、この値はユーザーのメールアドレスになります。存在する場合、この値はレスポンスの内容と照合され、一致しない場合は検証は失敗します。

レスポンスの本文

VerifiedAccess.VerifyChallengeResponse の結果メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "verificationOutput": string,
  "devicePermanentId": string,
  "signedPublicKeyAndChallenge": string,
  "deviceEnrollmentId": string,
  "attestedDeviceId": string
}
フィールド
verificationOutput
(deprecated)

string

EMCert チェックの場合は、デバイスの永続 ID がここに返されます。EUCert チェックの場合、signedPublicKeyAndChallenge [base64 エンコード済み] が存在する場合は返され、それ以外の場合は空の文字列が返されます。このフィールドは非推奨です。devicePermanentId または signedPublicKeyAndChallenge フィールドを使用してください。
devicePermanentId

string

このフィールドにはデバイスの永続 ID が返されます（マシンの応答の場合のみ）。
signedPublicKeyAndChallenge

string

このフィールドで、証明書署名リクエスト（SPKAC 形式、base64 エンコード）が返されます。このフィールドは、デバイスのチャレンジ レスポンスに CSR が含まれている場合のみ設定されます。（CSR を含めるオプションは、ユーザーとマシンの両方の応答で使用可能になりました）
deviceEnrollmentId

string

このフィールドには、デバイス登録 ID が返されます（マシンのレスポンスの場合のみ）。
attestedDeviceId

string

デバイスの証明済みデバイス ID（ADID）。確認済みデータから読み取られます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/verifiedaccess

詳細については、認証の概要をご覧ください。