View a markdown version of this page

を使用した AWS Private Certificate Authority API コールのログ記録 AWS CloudTrail - AWS Private Certificate Authority

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した AWS Private Certificate Authority API コールのログ記録 AWS CloudTrail

AWS Private Certificate Authority は、ユーザー AWS CloudTrail、ロール、または のサービスによって実行されたアクションを記録する AWS サービスである と統合されています AWS Private CA。CloudTrail は、 の API コールと署名オペレーションをイベント AWS Private CA としてキャプチャします。キャプチャされた呼び出しには、 AWS Private CA コンソールからの呼び出しと AWS Private CA API オペレーションへのコード呼び出しが含まれます。証跡を作成する場合は、イベントを含む Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます AWS Private CA。証跡を設定しない場合でも、CloudTrail コンソールの [イベント履歴] で最新のイベントを表示できます。CloudTrail によって収集された情報を使用して、リクエストの実行元の IP アドレス AWS Private CA、リクエストの実行者、リクエストの実行日時などの詳細を確認できます。

CloudTrail の詳細については、「AWS CloudTrail ユーザーガイド」を参照してください。

AWS Private CA CloudTrail の情報

CloudTrail は、アカウントの作成 AWS アカウント 時に で有効になります。アクティビティが発生すると AWS Private CA、そのアクティビティはイベント履歴の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。で最近のイベントを表示、検索、ダウンロードできます AWS アカウント。詳細については、「CloudTrail イベント履歴でのイベントの表示」を参照してください。

のイベントなど AWS アカウント、 のイベントの継続的な記録については AWS Private CA、証跡を作成します。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成するときに、証跡がすべての AWS リージョンに適用されます。証跡は、 AWS パーティション内のすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については、次を参照してください:

すべての AWS Private CA アクションは CloudTrail によってログに記録され、AWS Private CA API リファレンスに記載されています。例えば、ImportCACertificate、IssueCertificate、CreateAuditReport の各アクションを呼び出すと、CloudTrail ログファイルにエントリが生成されます。

各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。

  • リクエストがルートまたは AWS Identity and Access Management (IAM) ユーザー認証情報を使用して行われたかどうか。

  • リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。

  • リクエストが別の AWS サービスによって行われたかどうか。

詳細については、「CloudTrail userIdentity エレメント」を参照してください。

注記

Amazon S3 に加えて Amazon CloudWatch Logs にイベントを配信するように CloudTrail 証跡を設定できます。 Amazon S3 設定すると、CloudWatch Logs は S3 バケットに配信されるのと同じ AWS Private CA イベントを受け取ります。 AWS Private CA は CloudWatch Logs に直接イベントを発行しません。詳細については、「 AWS CloudTrail ユーザーガイド」のCloudWatch Logs へのイベントの送信」を参照してください。

配信タイミング、耐久性、他の AWS サービスとの統合など、CloudTrail がイベントを配信する方法については、CloudTrail ログファイルの取得と表示」およびAWS CloudTrail 「サービスレベルアグリーメント」を参照してください。

AWS Private CA 管理イベント

AWS Private CA は CloudTrail と統合して、ユーザー、ロール、または AWS のサービスによって実行された API アクションを記録します AWS Private CA。CloudTrail を使用して AWS Private CA API リクエストをリアルタイムでモニタリングし、Amazon Simple Storage Service、Amazon CloudWatch Logs、Amazon CloudWatch Events にログを保存できます。 は、CloudTrail ログファイルにイベントとして以下のアクションとオペレーションのログ記録 AWS Private CA をサポートします。

注記

CloudTrail は、API コールと署名オペレーションのリアルタイムイベントストリームを提供します。有効日や失効ステータスなど、プライベート CA が発行または取り消したすべての証明書の完全なpoint-in-timeインベントリについては、「」を参照してくださいプライベート CA で監査レポートを使用する。

元のリクエスタの識別

中間サービスがエンドユーザーまたはワークロードIssueCertificateに代わって を呼び出すと、CloudTrail イベントは、元のリクエスタではなく userIdentityフィールドに中間サービスの IAM ID を記録します。

証明書の発行を元のリクエスタにトレースするために、中間サービスは標準の IAM メカニズムを使用して ID 情報を伝達できます。

  • セッションタグ — 中間サービスは、IAM ロールを引き受けるときに、識別情報 (元のリクエスタの ID など) をセッションタグとして渡します AWS STS。これらのタグは、 の CloudTrail イベントの userIdentityブロックに表示されますsessionContext。詳細については、「AWS STSでのセッションタグの受け渡し」を参照してください。

  • ソース ID — 中間サービスは、ロールを引き受けるときにソース ID を設定します。ソース ID はロールチェーン間でイミュータブルであり、CloudTrail には として表示されますsourceIdentity。詳細については、「引き受けたロールで実行されたアクションのモニタリングと制御」を参照してください。

  • IAM Roles Anywhere — 呼び出し元のワークロードが IAM Roles Anywhere を介して X.509 証明書で認証された場合、証明書のサブジェクト、発行者、サブジェクト代替名 (SAN) フィールドは自動的にセッションプリンシパルタグにマッピングされます。たとえば、SAN の SPIFFE ID は として表示されますaws:PrincipalTag/x509SAN/URI。詳細については、「IAM Roles Anywhere 信頼モデル」を参照してください。

これらの ID 属性は、 AWS Private CA API オペレーションを含むすべての AWS サービスコールの CloudTrail イベントに記録されます。

AWS Private CA サービスイベント

API コールから記録された管理イベントに加えて、 はユーザーに代わって実行される内部オペレーションを可視化するサービスイベント AWS Private CA を生成します。これらのイベントは eventTypeの AwsServiceEvent を持ち、CloudTrail 証跡に自動的に記録されます。

IssueCertificateDetails イベント

AWS Private CA は、証明書の発行の試行が完了するとIssueCertificateDetailsイベントを生成します。イベントは、証明書が正常に発行されたか、発行に失敗したかなどの結果を記録し、次のような詳細を含む証明書の発行プロセスを記述します。

  • TBS (to-be-signed) 証明書構造 (base64 でエンコードされた DER)

  • 発行元 CA の名前、権限キー識別子、シリアル番号

  • 発行された証明書のシリアル番号、件名、有効期間

  • 使用する署名アルゴリズムとテンプレート

  • 該当する場合、失敗の理由を含む発行ステータス

共有 CA から証明書が発行されると、イベントは CA 所有者のアカウントとリクエスタのアカウントの両方に配信されます。発行の試行が失敗した場合、イベントには失敗の原因を説明する statusReasonフィールドが含まれることがあります。

注記

IssueCertificateDetails イベントは、障害の詳細や完全な TBS 証明書コンテンツなど、発行に関する追加のメタデータを提供することで、既存のSignCertificateイベントを補完します。

例: 証明書の発行成功

次の例は、正常に発行された証明書のIssueCertificateDetailsイベントを示しています。

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111122223333", "invokedBy": "acm-pca.amazonaws.com" }, "eventTime": "2026-08-10T15:27:20Z", "eventSource": "acm-pca.amazonaws.com", "eventName": "IssueCertificateDetails", "awsRegion": "us-west-2", "sourceIPAddress": "acm-pca.amazonaws.com", "userAgent": "acm-pca.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "83fecbfe-7e3a-4a14-8968-c99ad2d30d39", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::ACMPCA::CertificateAuthority", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01" }, { "accountId": "111122223333", "type": "AWS::ACMPCA::Certificate", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01/certificate/1a98eb0323009660dff81ac79ab4539e" } ], "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "serviceEventDetails": { "tbsCertificate": "MIIBZaADAgECAhAamOsDIwCWYN...", "issuerAuthorityKeyIdentifier": "16:E9:CC:B3:8A:DE:98:0F:10:BB:48:53:A4:1D:FD:A5:F2:EC:FE:5D", "issuerSerialNumber": "01", "issuerName": "CN=Example Intermediate CA", "subject": "CN=www.example.com", "serialNumber": "1A:98:EB:03:23:00:96:60:DF:F8:1A:C7:9A:B4:53:9E", "notBefore": "2026-08-10T14:27:20Z", "notAfter": "2026-08-17T15:27:20Z", "issuedAt": "2026-08-10T15:27:20Z", "templateArn": "arn:aws:acm-pca:::template/EndEntityCertificate/V1", "signingAlgorithm": "ECDSAWITHSHA256", "status": "ISSUED" }, "eventCategory": "Management" }
例: 証明書の発行に失敗した

次の例は、証明書の発行に失敗したIssueCertificateDetailsイベントを示しています。発行が失敗した場合、 statusフィールドは FAILEDで、 statusReasonフィールドは原因を記述します。有効フィールド (notBefore、notAfter) と issuedAtは、証明書が発行されなかったため省略されます。TBS 証明書 (tbsCertificate、subject、、issuerName、issuerAuthorityKeyIdentifier) から派生したフィールドはserialNumber、 が TBS 証明書 AWS Private CA を生成した後に障害が発生した場合にのみ存在します。

{ "eventVersion": "1.11", "userIdentity": { "accountId": "111122223333", "invokedBy": "acm-pca.amazonaws.com" }, "eventTime": "2026-08-10T15:27:20Z", "eventSource": "acm-pca.amazonaws.com", "eventName": "IssueCertificateDetails", "awsRegion": "us-west-2", "sourceIPAddress": "acm-pca.amazonaws.com", "userAgent": "acm-pca.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "fedcba98-7654-3210-fedc-ba9876543210", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::ACMPCA::CertificateAuthority", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01" }, { "accountId": "111122223333", "type": "AWS::ACMPCA::Certificate", "ARN": "arn:aws:acm-pca:us-west-2:111122223333:certificate-authority/9bb0e8f5-b024-4517-b0bb-e886cb34ac01/certificate/d6b81f1bf0563e97c29584a55c3ea553" } ], "eventType": "AwsServiceEvent", "managementEvent": true, "recipientAccountId": "111122223333", "serviceEventDetails": { "tbsCertificate": "MIIBZaADAgECAhAamOsDIwCWYN...", "issuerAuthorityKeyIdentifier": "16:E9:CC:B3:8A:DE:98:0F:10:BB:48:53:A4:1D:FD:A5:F2:EC:FE:5D", "issuerSerialNumber": "01", "issuerName": "CN=Example Intermediate CA", "subject": "CN=www.example.com", "serialNumber": "D6:B8:1F:1B:F0:56:3E:97:C2:95:84:A5:5C:3E:A5:53", "templateArn": "arn:aws:acm-pca:::template/EndEntityCertificate/V1", "signingAlgorithm": "ECDSAWITHSHA256", "status": "FAILED", "statusReason": "Name Constraints violation: DNS name not found in a permitted subtree." }, "eventCategory": "Management" }

次の表に、 serviceEventDetails オブジェクトのフィールドを示します。

フィールド 説明
tbsCertificate TBS (to-be-signed) 証明書構造の base64 エンコードされた DER 表現。発行された証明書に表示されるのと同じ情報が含まれます。発行に失敗した場合は、TBS 証明書の生成後に障害が発生した場合にのみ表示されます。
issuerAuthorityKeyIdentifier TBS 証明書拡張機能から抽出され、コロン区切りの 16 進バイトとしてフォーマットされた、発行元の CA の権限キー識別子。証明書に権限キー識別子拡張 (自己署名ルート CA 証明書など) が含まれていない場合は省略され、TBS 証明書の生成前に障害が発生した場合は発行に失敗します。
issuerSerialNumber コロンで区切られた 16 進バイト形式の発行 CA 証明書のシリアル番号。CA 証明書が使用できない場合に省略されます。
issuerName TBS 証明書からの発行 CA の識別名 (DN)。発行に失敗した場合は、TBS 証明書の生成後に障害が発生した場合にのみ表示されます。
subject TBS 証明書からの証明書サブジェクトの識別名 (DN)。発行に失敗した場合は、TBS 証明書の生成後に障害が発生した場合にのみ表示されます。
serialNumber 証明書のシリアル番号。コロン区切りの 16 進バイトとしてフォーマットされます。発行に失敗した場合は、TBS 証明書の生成後に障害が発生した場合にのみ表示されます。
notBefore ISO 8601 形式の証明書有効期間の開始。発行が失敗した場合は省略されます。
notAfter ISO 8601 形式の証明書の有効期間の終了。発行が失敗した場合は省略されます。
issuedAt 証明書が ISO 8601 形式で発行されたタイムスタンプ。発行が失敗した場合は省略されます。
templateArn 発行に使用される証明書テンプレートの ARN。
signingAlgorithm 使用される署名アルゴリズム (例: ECDSAWITHSHA256または SHA256WITHRSA)。
status 発行試行の結果: ISSUEDまたは FAILED. AWS Private CA は、発行がこれらの終了状態のいずれかに達した後にのみIssueCertificateDetailsイベントを記録するため、このフィールドが になることはありませんPENDING。まだ処理中の証明書は、発行が成功または失敗するまでイベントを生成しません。GetCertificate を使用して、イベントがまだ表示されていない証明書のステータスを確認します。
statusReason 発行失敗の理由。失敗の理由が利用可能な場合にのみ表示されます。失敗した発行イベントの中には、このフィールドが含まれていないものがあります。
requesterAccountId 証明書をリクエストした AWS アカウント ID。ユーザーに代わって AWS サービスによってリクエストが行われなかった場合にのみ表示されます。
requesterArn 証明書をリクエストしたプリンシパルの ARN。ユーザーに代わって AWS サービスによってリクエストが行われなかった場合にのみ表示されます。
requesterServicePrincipal ユーザーに代わって証明書をリクエストした AWS サービスプリンシパル ( などacm.amazonaws.com)。 AWS サービスがリクエストを行った場合にのみ表示されます。
注記

一部の証明書発行は、顧客プリンシパルではなく内部 AWS プロセスに起因します。このような場合、イベントには requesterAccountId、、requesterArnまたは requesterServicePrincipalフィールドは含まれません。これら 3 つのフィールドのいずれかが常に存在すると想定しないでください。

AWS Private CA イベントの例

「トレイル」は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail のログファイルは、単一か複数のログエントリを含みます。イベントは、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API 呼び出しの順序付けられたスタックトレースではないため、特定の順序では表示されません。

AWS Private CA CloudTrail イベントの例を次に示します。

例 1: 管理イベント、 IssueCertificate

以下の例は、IssueCertificate アクションを示す CloudTrail ログエントリです。

{ "version":"0", "id":"event_ID", "detail-type":"ACM Private CA Certificate Issuance", "source":"aws.acm-pca", "account":"account", "time":"2019-11-04T19:57:46Z", "region":"region", "resources":[ "arn:aws:acm-pca:us-east-1:111122223333:certificate-authority/11223344-1234-1122-2233-112233445566", "arn:aws:acm-pca:region:account:certificate-authority/CA_ID/certificate/certificate_ID" ], "detail":{ "result":"success" } }
例 2: 管理イベント、 ImportCertificateAuthorityCertificate

以下の例は、ImportCertificateAuthorityCertificate アクションを示す CloudTrail ログエントリです。

{ "eventVersion":"1.05", "userIdentity":{ "type":"IAMUser", "principalId":"account", "arn":"arn:aws:iam::account:user/name", "accountId":"account", "accessKeyId":"key_ID" }, "eventTime":"2018-01-26T21:53:28Z", "eventSource":"acm-pca.amazonaws.com", "eventName":"ImportCertificateAuthorityCertificate", "awsRegion":"region", "sourceIPAddress":"IP_address", "userAgent":"agent", "requestParameters":{ "certificateAuthorityArn":"arn:aws:acm-pca:us-east-1:111122223333:certificate-authority/11223344-1234-1122-2233-112233445566", "certificate":{ "hb":[ 45, 45, ...10 ], "offset":0, "isReadOnly":false, "bigEndian":true, "nativeByteOrder":false, "mark":-1, "position":1257, "limit":1257, "capacity":1257, "address":0 }, "certificateChain":{ "hb":[ 45, 45, ...10 ], "offset":0, "isReadOnly":false, "bigEndian":true, "nativeByteOrder":false, "mark":-1, "position":1139, "limit":1139, "capacity":1139, "address":0 } }, "responseElements":null, "requestID":"request_ID", "eventID":"event_ID", "eventType":"AwsApiCall", "recipientAccountId":"account" }