MCP mTLS CA 証明書が無効

このページ の内容は Apigee ハイブリッドに適用されます。Apigee には適用されません。

このトピックに対応する Apigee Edge のドキュメントはありません。

症状

apigee Namespace のリソースを表示したときに、ApigeeIssue(Reason = AIS_MCP_MTLS_CA_CERT_INVALID)が表示されます。

この問題は、mcpMtls ブロックでチェーン検証が有効になっている(デフォルト)環境グループでのみ発生します。mcpMtls.disableChainValidation: true を含むグループの場合、MCP データプレーンは CA 証明書を使用せず、-cacert シークレットはスキャンされません。

エラー メッセージ

kubectl -n apigee get apigeeissues を実行すると、次のようなエラーが表示されます。

NAME                                        SEVERITY   REASON                         DOCUMENTATION                                                                              AGE
mcp-ca-cert-invalid-my-org-my-virtualhost   ERROR      AIS_MCP_MTLS_CA_CERT_INVALID   https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CA_CERT_INVALID   5h18m

考えられる原因

この問題で考えられる原因は次のとおりです。

原因 説明
MCP mTLS CA 証明書の Secret またはエントリがない -cacert シークレットが存在しないか、使用可能な cacert エントリがありません。
MCP mTLS CA 証明書が PEM エンコードされていない cacert エントリに PEM 証明書ブロックがないか、PEM ブロック外のバイトが含まれています。
MCP mTLS CA 証明書が不正な形式であるか、CA 証明書ではない cacert エントリのブロックが証明書ではない、解析されない、または CA 証明書ではない。

原因: MCP mTLS CA 証明書の Secret またはエントリがない

MCP データプレーンが Ingress ゲートウェイを検証する CA 証明書を保持する Kubernetes Secret が apigee 名前空間に存在しないか、空でない cacert エントリなしで存在しています。名前は、クライアント証明書シークレットの名前に -cacert を追加したものです。この Secret は、証明書ファイルを使用する場合にのみ作成されます。sslSecret を使用する場合は、自分で作成する必要があります。この問題の最も一般的な原因は、この Secret の作成を忘れることです。

診断

次のコマンドを実行します。

kubectl -n apigee describe apigeeissue ISSUE_NAME

ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

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

Name:         mcp-ca-cert-invalid-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_MCP_MTLS_CA_CERT_INVALID
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2026-11-12T17:03:43Z
  Generation:          1
  Owner References:
    API Version:     apigee.cloud.google.com/v1alpha2
    Kind:            ApigeeOrganization
    Name:            my-org
    UID:             7e83a52c-ce00-4bed-98be-55835ada1817
  Resource Version:  3281563
  UID:               adc775c2-376d-4bf9-9860-500b2b2b8273
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: secret not found: secrets "my-org-my-virtualhost-mcp-cacert" not found
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CA_CERT_INVALID
  Reason:         AIS_MCP_MTLS_CA_CERT_INVALID
  Severity:       ERROR
Events:           <none>
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: secret not found: secrets "my-org-my-virtualhost-mcp-cacert" not found

Spec.Details の内容は、Secret、ApigeeRouteConfig、問題の内容を示します。次に例を示します。

  • secret not found
  • secret has no usable "cacert" entry

解決策

  1. kubectl describe を使用して、Kubernetes Secret の名前と、問題が属する ApigeeRouteConfig を表示します。

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

    この例では、ApigeeRouteConfig my-org-my-virtualhost が Secret my-org-my-virtualhost-mcp-cacert を参照しています。

  2. ApigeeRouteConfig から virtualhost の名前を特定します。

    ApigeeRouteConfig の名前は <Apigee organization>-<virtualhost name> の形式になっています。

    この例では、Apigee 組織は my-org で、仮想ホスト名は my-virtualhost です。

  3. overrides.yaml で対応する仮想ホストを探し、mcpMtls ブロックで使用されている形式を確認します(MCP データプレーンと Ingress ゲートウェイ間の mTLS を構成するをご覧ください)。該当するタブを選択し、そのタブの手順に沿って操作します。

証明書ファイル

ファイルパス(sslCertPath、sslKeyPath、caCertPath)を使用すると、virtualhost チャートはファイルの内容から Secret を作成して管理します。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  caCertPath: ./certs/ca.pem
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
  mcpMtls:
    caCertPath: ./certs/mcp-ca.pem
    sslCertPath: ./certs/mcp-client.pem
    sslKeyPath: ./certs/mcp-client.key
...
  1. Secret が存在し、cacert エントリがあるかどうかを確認します。ここで、MCP_CA_SECRET_NAME は Spec.Details で指定された Secret です。

    kubectl -n apigee describe secret MCP_CA_SECRET_NAME

    Secret がないか、エントリがない場合は、mcpMtls.caCertPath で参照されているファイルが存在し、空でないことを確認します。次のステップでは、このファイルからシークレットを復元します。チェーン検証なしで実行する場合は、mcpMtls.disableChainValidation: true を設定し、mcpMtls.caCertPath を削除します(チャートは 2 つを同時に拒否します)。これにより、MCP データプレーンによる Ingress ゲートウェイの証明書の検証が無効になります。

  2. チャートが Secret を書き換えるように、仮想ホストをアップグレードします。

    helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
      --namespace apigee \
      --set envgroup=ENV_GROUP_NAME \
      -f overrides.yaml

Kubernetes Secret

Kubernetes Secret 参照(sslSecret)を使用すると、MCP データプレーンは作成した Secret から証明書値を直接読み取り、更新が自動的に適用されます。helm upgrade は不要です。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  sslSecret: my-ingress-secret
  mcpMtls:
    sslSecret: my-mcp-client-secret
...
  1. cacert エントリにその名前の Secret が存在することを確認します。ここで、MCP_CLIENT_SECRET_NAME は mcpMtls.sslSecret という名前のクライアント証明書 Secret です。

    kubectl -n apigee describe secret MCP_CLIENT_SECRET_NAME-cacert

    helm template はシークレットが存在するかどうかを確認しません。helm install と helm upgrade のみが確認するため、helm template が正常に実行されたとしても、このシークレットが存在する証拠にはなりません。チェーン検証なしで実行する場合は、シークレットを省略するだけでは不十分です。overrides.yaml で mcpMtls.disableChainValidation: true を設定し、仮想ホストをアップグレードします。これにより、MCP データプレーンによる Ingress ゲートウェイの証明書の検証が無効になります。

  2. CA 証明書シークレットを作成または更新します。ここで、MCP_CLIENT_SECRET_NAME は mcpMtls.sslSecret の値、CA 証明書シークレットは -cacert が追加された名前、MCP_TRUST_CA_FILE は CA 証明書ファイルです。

    kubectl -n apigee create secret generic MCP_CLIENT_SECRET_NAME-cacert \
      --from-file=cacert=MCP_TRUST_CA_FILE \
      --dry-run=client -o yaml | kubectl apply -f -

MCP データプレーンは、通常数分以内に、Pod を再起動することなく、次の定期的な更新で修正された Secret を取得します。ApigeeIssue は次のスキャンで取り消されます。

原因: MCP mTLS CA 証明書が PEM エンコードされていない

cacert エントリに PEM エンコードのテキスト ブロックがないか、最後の -----END CERTIFICATE----- 行の後に PEM 以外のコンテンツがあります。MCP データプレーンはこれを読み込みません。

診断

次のコマンドを実行します。

kubectl -n apigee describe apigeeissue ISSUE_NAME

ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

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

Name:         mcp-ca-cert-invalid-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_MCP_MTLS_CA_CERT_INVALID
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2026-11-12T17:03:43Z
  Generation:          1
  Owner References:
    API Version:     apigee.cloud.google.com/v1alpha2
    Kind:            ApigeeOrganization
    Name:            my-org
    UID:             7e83a52c-ce00-4bed-98be-55835ada1817
  Resource Version:  3281563
  UID:               adc775c2-376d-4bf9-9860-500b2b2b8273
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: holds 1289 trailing bytes that are not PEM
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CA_CERT_INVALID
  Reason:         AIS_MCP_MTLS_CA_CERT_INVALID
  Severity:       ERROR
Events:           <none>
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: holds 1289 trailing bytes that are not PEM

Spec.Details の内容は、Secret、ApigeeRouteConfig、問題の内容を示します。次に例を示します。

  • entry holds no PEM encoded certificate
  • holds N trailing bytes that are not PEM

解決策

  1. kubectl describe を使用して、Kubernetes Secret の名前と、問題が属する ApigeeRouteConfig を表示します。

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

    この例では、ApigeeRouteConfig my-org-my-virtualhost が Secret my-org-my-virtualhost-mcp-cacert を参照しています。

  2. ApigeeRouteConfig から virtualhost の名前を特定します。

    ApigeeRouteConfig の名前は <Apigee organization>-<virtualhost name> の形式になっています。

    この例では、Apigee 組織は my-org で、仮想ホスト名は my-virtualhost です。

  3. overrides.yaml で対応する仮想ホストを探し、mcpMtls ブロックで使用されている形式を確認します(MCP データプレーンと Ingress ゲートウェイ間の mTLS を構成するをご覧ください)。該当するタブを選択し、そのタブの手順に沿って操作します。

証明書ファイル

ファイルパス(sslCertPath、sslKeyPath、caCertPath)を使用すると、virtualhost チャートはファイルの内容から Secret を作成して管理します。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  caCertPath: ./certs/ca.pem
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
  mcpMtls:
    caCertPath: ./certs/mcp-ca.pem
    sslCertPath: ./certs/mcp-client.pem
    sslKeyPath: ./certs/mcp-client.key
...
  1. mcpMtls.caCertPath で参照されているファイルの内容を検証し、必要に応じて修正します。コンテンツに、完全な証明書ブロックのみが含まれていることを確認します。各ブロックには、開始行と終了行があります。次に例を示します。

    -----BEGIN CERTIFICATE-----
    MIIDYTCCAkmgAwIBAgIUSXeU0pQYRFzYlqZpKhNNJdBLFBIwDQYJKoZIhvcNAQEL
    ... <contents omitted> ...
    QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVowMTIzNDU2Nzg5QUJDREVGR0hJSktM
    MMM=
    -----END CERTIFICATE-----
  2. チャートが Secret を書き換えるように、仮想ホストをアップグレードします。

    helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
      --namespace apigee \
      --set envgroup=ENV_GROUP_NAME \
      -f overrides.yaml

Kubernetes Secret

Kubernetes Secret 参照(sslSecret)を使用すると、MCP データプレーンは作成した Secret から証明書値を直接読み取り、更新が自動的に適用されます。helm upgrade は不要です。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  sslSecret: my-ingress-secret
  mcpMtls:
    sslSecret: my-mcp-client-secret
...
  1. Secret の cacert エントリに保存する CA 証明書ファイル(MCP_TRUST_CA_FILE)の内容を検証し、必要に応じて修正します。コンテンツに、開始行と終了行を含む完全な証明書ブロックのみが含まれていることを確認します。次に例を示します。

    -----BEGIN CERTIFICATE-----
    MIIDYTCCAkmgAwIBAgIUSXeU0pQYRFzYlqZpKhNNJdBLFBIwDQYJKoZIhvcNAQEL
    ... <contents omitted> ...
    QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVowMTIzNDU2Nzg5QUJDREVGR0hJSktM
    MMM=
    -----END CERTIFICATE-----
  2. CA 証明書 Secret を更新します。ここで、MCP_CLIENT_SECRET_NAME は mcpMtls.sslSecret の値、CA 証明書 Secret は -cacert が追加された名前、MCP_TRUST_CA_FILE は CA 証明書ファイルです。

    kubectl -n apigee create secret generic MCP_CLIENT_SECRET_NAME-cacert \
      --from-file=cacert=MCP_TRUST_CA_FILE \
      --dry-run=client -o yaml | kubectl apply -f -

MCP データプレーンは、通常数分以内に、Pod を再起動することなく、次の定期的な更新で修正された Secret を取得します。ApigeeIssue は次のスキャンで取り消されます。

原因: MCP mTLS CA 証明書が不正な形式であるか、CA 証明書ではない

cacert エントリのすべての PEM ブロックは、解析され、CA 基本制約を持つ CERTIFICATE ブロックである必要があります。秘密鍵ブロック、リーフ証明書(Ingress ゲートウェイ独自のサーバー証明書など)、または破損したブロックにより、エントリが使用できなくなり、MCP データプレーンはそれを読み込みません。

診断

次のコマンドを実行します。

kubectl -n apigee describe apigeeissue ISSUE_NAME

ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

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

Name:         mcp-ca-cert-invalid-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_MCP_MTLS_CA_CERT_INVALID
Annotations:  <none>
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2026-11-12T17:03:43Z
  Generation:          1
  Owner References:
    API Version:     apigee.cloud.google.com/v1alpha2
    Kind:            ApigeeOrganization
    Name:            my-org
    UID:             7e83a52c-ce00-4bed-98be-55835ada1817
  Resource Version:  3281563
  UID:               adc775c2-376d-4bf9-9860-500b2b2b8273
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: block 1 is not a CA certificate
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CA_CERT_INVALID
  Reason:         AIS_MCP_MTLS_CA_CERT_INVALID
  Severity:       ERROR
Events:           <none>
Spec:
  Details:        MCP mTLS CA certificate in secret "my-org-my-virtualhost-mcp-cacert" for ApigeeRouteConfig "my-org-my-virtualhost" is not usable: block 1 is not a CA certificate

Spec.Details の内容は、Secret、ApigeeRouteConfig、問題の内容を示します。次に例を示します。

  • no PEM block parsed as a certificate: ...: どの証明書ブロックも解析できません(たとえば、唯一の証明書が破損している場合)。
  • block N is a "..." block, want CERTIFICATE: ブロック N が証明書ではありません(秘密鍵など)。
  • block N does not parse: ブロック N は破損した証明書です。
  • block N is not a CA certificate: ブロック N は証明書ですが、CA ではありません(リーフ証明書など)。

ブロックには 0 から番号が付けられます。

解決策

  1. kubectl describe を使用して、Kubernetes Secret の名前と、問題が属する ApigeeRouteConfig を表示します。

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    ISSUE_NAME は、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhost など)に置き換えます。

    この例では、ApigeeRouteConfig my-org-my-virtualhost が Secret my-org-my-virtualhost-mcp-cacert を参照しています。

  2. ApigeeRouteConfig から virtualhost の名前を特定します。

    ApigeeRouteConfig の名前は <Apigee organization>-<virtualhost name> の形式になっています。

    この例では、Apigee 組織は my-org で、仮想ホスト名は my-virtualhost です。

  3. overrides.yaml で対応する仮想ホストを探し、mcpMtls ブロックで使用されている形式を確認します(MCP データプレーンと Ingress ゲートウェイ間の mTLS を構成するをご覧ください)。該当するタブを選択し、そのタブの手順に沿って操作します。

証明書ファイル

ファイルパス(sslCertPath、sslKeyPath、caCertPath)を使用すると、virtualhost チャートはファイルの内容から Secret を作成して管理します。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  caCertPath: ./certs/ca.pem
  sslCertPath: ./certs/vhost.pem
  sslKeyPath: ./certs/vhost.key
  mcpMtls:
    caCertPath: ./certs/mcp-ca.pem
    sslCertPath: ./certs/mcp-client.pem
    sslKeyPath: ./certs/mcp-client.key
...
  1. mcpMtls.caCertPath で参照されているファイルを再ビルドして、Ingress ゲートウェイの証明書に署名した CA 証明書(またはチェーン)のみを保持するようにします。次に、すべてのブロックが CA 証明書であることを確認します。ここで、MCP_TRUST_CA_FILE はそのファイルです。

    openssl storeutl -noout -text -certs MCP_TRUST_CA_FILE | grep -E 'Subject:|CA:'
    # every certificate must show CA:TRUE
  2. チャートが Secret を書き換えるように、仮想ホストをアップグレードします。

    helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \
      --namespace apigee \
      --set envgroup=ENV_GROUP_NAME \
      -f overrides.yaml

Kubernetes Secret

Kubernetes Secret 参照(sslSecret)を使用すると、MCP データプレーンは作成した Secret から証明書値を直接読み取り、更新が自動的に適用されます。helm upgrade は不要です。

virtualhosts:
...
- name: my-virtualhost
  selector:
    app: apigee-ingressgateway
  tlsMode: MUTUAL
  sslSecret: my-ingress-secret
  mcpMtls:
    sslSecret: my-mcp-client-secret
...
  1. CA 証明書ファイル(MCP_TRUST_CA_FILE)を再ビルドして、Ingress ゲートウェイの証明書に署名した CA 証明書(またはチェーン)のみを保持するようにします。次に、すべてのブロックが CA 証明書であることを確認します。

    openssl storeutl -noout -text -certs MCP_TRUST_CA_FILE | grep -E 'Subject:|CA:'
    # every certificate must show CA:TRUE
  2. CA 証明書 Secret を更新します。ここで、MCP_CLIENT_SECRET_NAME は mcpMtls.sslSecret の値、CA 証明書 Secret は -cacert が追加された名前、MCP_TRUST_CA_FILE は CA 証明書ファイルです。

    kubectl -n apigee create secret generic MCP_CLIENT_SECRET_NAME-cacert \
      --from-file=cacert=MCP_TRUST_CA_FILE \
      --dry-run=client -o yaml | kubectl apply -f -

MCP データプレーンは、通常数分以内に、Pod を再起動することなく、次の定期的な更新で修正された Secret を取得します。ApigeeIssue は次のスキャンで取り消されます。

診断情報の収集が必要な場合

上記の手順でも問題が解決しない場合は、次の診断情報を収集して Google Cloud カスタマーケアに連絡してください。

  1. Google Cloud プロジェクト ID
  2. Apigee ハイブリッド組織の名前。
  3. ApigeeIssue の Spec.Details フィールド。
  4. (省略可)影響を受ける仮想ホストの mcpMtls.caCertPath によって参照されているファイル内の証明書、またはシークレットの cacert エントリ内の証明書。