機密コンピューティングのリモートアテステーション

チャレンジ・レスポンス・セッションを作成するには、ベリファイア・サーバーのベースURIの次のエンドポイントにPOSTリクエストを送信します。

POST /challenge-response/v1/newSession

POSTリクエストには、次の相互に排他的なGET変数を含めることができます。

• nonce: 事前生成されたURLセーフなnonce。次のコマンドを実行してnonceを生成できます。

  nonce=$(openssl rand 64 | openssl base64 | tr '+/' '-_' | tr -d '=' | head -c 64)

• nonceSize: 64バイトのnonceの場合は64に設定することをお薦めします。サービスでnonceを生成する必要がある場合は、このオプションを使用します。nonceはレスポンス本文で返されますが、返されたnonceはURLセーフではなく、チャレンジ・レスポンス・セッション中に他のリクエストで使用するためにクリーンアップする必要があることに注意してください。

レスポンスには、ベリファイア・サーバーとの他の相互作用を実行するときにセッションを追跡するために使用されるロケーション・ヘッダー・エントリが含まれます。

location: session/657f1750-7916-11f0-a190-333334633039

レスポンス本文には、nonce、expiry timeおよび受け入れられる形式のリストが含まれます。例:

{
 "status": "waiting",
 "nonce":  "oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg==",
 "expiry": "2025-08-13T19:13:24.96426094Z",
 "accept": [
     "application/vnd.parallaxsecond.key-attestation.tpm",
     "application/psa-attestation-token",
     "application/eat+cwt; eat_profile=\"tag:psacertified.org,2023:psa#tfm\"",
     "application/vnd.veraison.tsm-report+cbor",
     "application/vnd.enacttrust.tpm-evidence",
     "application/eat-cwt; profile=\"http://arm.com/psa/2.0.0\"",
     "application/eat+cwt; eat_profile=\"tag:psacertified.org,2019:psa#legacy\"",
     "application/pem-certificate-chain",
     "application/vnd.veraison.configfs-tsm+json",
     "application/vnd.parallaxsecond.key-attestation.cca",
     "application/eat+cwt; eat_profile=\"tag:github.com,2025:veraison/ratsd/cmw\"",
     "application/eat-collection; profile=\"http://arm.com/CCA-SSD/1.0.0\""
 ]
}                    

エビデンスがベリファイア・サーバーに発行されるときに使用するレスポンス・ヘッダーのlocation値を格納します。

この問合せのnonceを事前に生成しなかった場合は、nonceをHTTPレスポンス本文に格納します。nonceは、アテスタからエビデンスを収集するときに使用され、アテスタによって返されたアテステーション・レポートに表示されます。

echo "oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg==" | tr '+/' '-_' | tr -d '='

次のコマンド例は、新しいセッションのnonceを生成する方法を示しています。

curl -X POST https://veraison-services.example.com:8443/challenge-response/v1/newSession?nonceSize=64

出力は次のようになります:

HTTP/2 201 
content-type: application/vnd.veraison.challenge-response-session+json
location: session/657f1750-7916-11f0-a190-333334633039
content-length: 837
date: Thu, 14 Aug 2025 13:55:54 GMT
                            
{"status":"waiting",
 "nonce":"oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg==",
 "expiry":"2025-08-14T13:58:24.75546442Z","accept":["application/vnd.parallaxsecond.key-attestation.cca",
 "application/eat+cwt; eat_profile=\"tag:github.com,2025:veraison/ratsd/cmw\"",
 "application/eat-collection; profile=\"http://arm.com/CCA-SSD/1.0.0\"","application/vnd.parallaxsecond.key-attestation.tpm",
 "application/psa-attestation-token","application/eat+cwt; eat_profile=\"tag:psacertified.org,2023:psa#tfm\"",
 "application/vnd.veraison.tsm-report+cbor","application/vnd.enacttrust.tpm-evidence",
 "application/eat-cwt; profile=\"http://arm.com/psa/2.0.0\"","application/eat+cwt; eat_profile=\"tag:psacertified.org,2019:psa#legacy\"",
 "application/pem-certificate-chain","application/vnd.veraison.configfs-tsm+json"]}

veraison-ratsdサービスからエビデンスを取得するには、アテスタ・ホスト・ベースURIの次のエンドポイントにPOSTリクエストを送信します。

POST /ratsd/chares

リクエスト本文には、チャレンジ・レスポンス・セッションで使用されるURLセーフ・ノンスが含まれている必要があります。

{
  "nonce": "oWTtIjdJf8CR-ASRW70UOzeFHj5SdlFLBqan10pardkBK_7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg"
}

レスポンスには、前のステップで指定した形式のエビデンスが含まれます。

{"cmw":"eyJfX2Ntd2NfdCI6InRhZzpnaX29uIiwiZXlKaGRYaGliRzl..9pSm1ZV3RsWEc0aWZRIl19",
 "eat_nonce":"TUlEQk5IMjhpaW9pc2pQeXh4eHh4eHh4eHh4eHh4eHhNSURCTkgyOGlpb2lzalB5eHh4eHh4eHh4eHh4eHh4eA",
 "eat_profile":"tag:github.com,2024:veraison/ratsd"}                        

cmwキーの値は、JSON Webトークン(JWT)としてのエビデンス・クレームのシリアライズです。この問合せに対するレスポンスの完全な出力を格納し、ベリファイア・サーバーによる検証のためにそのまま送信できます。

次のコマンド例は、セッションnonceを指定することによって、アテスタホストからエビデンスを取得する方法を示しています。

curl -X POST http://instance.example.com:8895/ratsd/chares \
 -H "Content-type: application/vnd.veraison.chares+json" \
 -d '{"nonce": "oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg=="}' \ 
 -o evidence

このコマンドからの出力は、evidenceという名前のファイルに格納されます。このファイルは、ベリファイアからアテステーション結果のリクエストを送信するときに使用できます。

エンド・ツー・エンドの例は、veraison-ratsdバージョン1.0.9以降で使用可能な/usr/share/doc/veraison-ratsd/examples/attestation-sample.pyを参照してください。

veraison-servicesからアテステーション結果を取得するには、ベリファイア・ホストURI権限の次のエンドポイントにPOSTリクエストを送信します。

POST /challenge-response/v1/<session_location>

リクエスト・エンドポイントには、nonceがベリファイア・サーバーによって生成されたときに元のチャレンジ・レスポンスのヘッダーに返されるsession_locationが含まれます。「アテスタからのエビデンスの取得」「チャレンジ・レスポンス・セッションの作成」を参照してください。

リクエスト・ヘッダーには、アテスタ・ホスト・ベースURIと一致するHost値、エビデンスが収集された形式に設定されたContent-Type、および目的のレスポンス形式を表すAccept値が含まれます。例:

Host: instance.example.com:8443
Content-Type: application/eat+cwt; eat_profile="tag:github.com,2025:veraison/ratsd/cmw"            
Accept: application/vnd.veraison.challenge-response-session+json

リクエスト本文ペイロードには、veraison-ratsdサービスを実行しているアテスタから取得したエビデンスが含まれている必要があります。Get Evidence From an Attesterを参照してください。

応答にはエビデンスとEATアテステーションの結果が含まれます。

{
 "status": "complete",
 "nonce": "oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg==",
 "expiry": "2025-08-14T16:44:22.733250762Z",
 "accept": [
  "application/eat-cwt; profile=\"http://arm.com/psa/2.0.0\"",
  "application/eat+cwt; eat_profile=\"tag:psacertified.org,2019:psa#legacy\"",
  "application/pem-certificate-chain",
  "application/vnd.veraison.configfs-tsm+json",
  "application/vnd.parallaxsecond.key-attestation.cca",
  "application/eat+cwt; eat_profile=\"tag:github.com,2025:veraison/ratsd/cmw\"",
  "application/eat-collection; profile=\"http://arm.com/CCA-SSD/1.0.0\"",
  "application/vnd.parallaxsecond.key-attestation.tpm",
  "application/psa-attestation-token",
  "application/eat+cwt; eat_profile=\"tag:psacertified.org,2023:psa#tfm\"",
  "application/vnd.veraison.tsm-report+cbor",
  "application/vnd.enacttrust.tpm-evidence"
 ],
 "evidence": {
  "type": "application/eat+cwt; eat_profile=\"tag:github.com,2025:veraison/ratsd/cmw\"",
  "value": "eyJjbXciOiJleUpmWDJOdGQyTmZkQ0k2SW5SaFp6cG5hWF...DI0OnZlcmFpc29uL3JhdHNkIn0="
 },
 "result": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...t4sZ_dmpPK-BX8tnCmdmCyqoMUg"
}

次のリクエスト例では、Get Evidence From an Attesterのサンプル・リクエストから取得されたevidenceという名前のファイルからデータ・ペイロードがロードされます。curlコマンドを使用する場合、ファイルからデータをロードするには、ファイル名の前に@文字を使用する必要があります。

curl -X POST https://veraison-services.example.com:8443/challenge-response/v1/session/94e9ea97-792d-11f0-a190-333334633039 \
 -H "Host: instance.example.com:8443" \
 -H "content-type: application/eat+cwt; eat_profile=\"tag:github.com,2025:veraison/ratsd/cmw\"" \
 -H "accept: application/vnd.veraison.challenge-response-session+json" \
 --data "@evidence"

指定された問合せからのレスポンスの場合は、任意のJSON Webトークン・ビューアまたはライブラリを使用して結果をデコードし、標準のJSON形式にデコードできます。デコードされた出力は次のようになります。

{
 "ear.verifier-id": {
   "build": "N/A",
   "developer": "Veraison Project"
 },
 "eat_nonce": "oWTtIjdJf8CR+ASRW70UOzeFHj5SdlFLBqan10pardkBK/7lOoSLMsdvhMF0DcqTpgg4nN08Ql2MWAmLFy97cg==",
 "eat_profile": "tag:github.com,2023:veraison/ear",
 "iat": 1755189767,
 "submods": {
   "SEVSNP": {
    "ear.appraisal-policy-id": "policy:SEVSNP",
    "ear.status": "affirming",
    "ear.trustworthiness-vector": {
        "configuration": 0,
        "executables": 0,
        "file-system": 0,
        "hardware": 2,
        "instance-identity": 0,
        "runtime-opaque": 2,
        "sourced-data": 0,
        "storage-opaque": 0
     },
    "ear.veraison.annotated-evidence": {
      "environment": {
        "class": {
          "id": {
            "type": "oid",
            "value": "1.3.6.1.4.1.3704.3.2"
          }
        }
       },
      "measurements": [
        {
         ...
        }
      ]
     }
    }
  }
}

SEV-SNP信頼性のインスタンスの評価は、SEVSNPサブモジュールの結果に重点を置いています。ear.statusを評価して、アテスタ・ホストが信頼できる実行環境で実行されているかどうかを決定できます。「確認」とマークされている場合、ホストは請求の評価に基づいて信頼されます。

ear.trustworthiness-vectorは、ベリファイアによって検証された様々な要求の結果を示します。