MCP mTLS クライアント証明書の有効期限

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

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

症状

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

エラー メッセージ

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

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

考えられる原因

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

原因 説明
MCP mTLS クライアント証明書がまもなく有効期限切れになる 構成された MCP mTLS クライアント証明書の有効期限が 14 日以内に切れます。
MCP mTLS クライアント証明書の有効期限が切れている 構成された MCP mTLS クライアント証明書の有効期限が切れています。

原因: MCP mTLS クライアント証明書の有効期限がまもなく切れる

ApigeeRouteConfig によって参照される Kubernetes Secret に格納されている MCP mTLS クライアント証明書の有効期限が 14 日以内に切れます。

診断

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

kubectl -n apigee describe apigeeissue ISSUE_NAME

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

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

Name:         mcp-client-cert-expiring-soon-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
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 client certificate in secret "my-org-my-virtualhost-mcp" for ApigeeRouteConfig "my-org-my-virtualhost" is expiring in 335h12m4s at 2026-11-26 16:15:47 +0000 UTC
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
  Reason:         AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
  Severity:       WARNING
Events:           <none>
Spec:
  Details:        MCP mTLS client certificate in secret "my-org-my-virtualhost-mcp" for ApigeeRouteConfig "my-org-my-virtualhost" is expiring in 335h12m4s at 2026-11-26 16:15:47 +0000 UTC

Spec.Details の内容は、まもなく有効期限が切れる MCP mTLS クライアント証明書を含む Kubernetes Secret を参照する ApigeeRouteConfig の名前について説明しています。

解決策

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

    kubectl -n apigee describe apigeeissue ISSUE_NAME

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

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

  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. 認証局から更新された MCP mTLS クライアント証明書を取得し、mcpMtls.sslCertPath と mcpMtls.sslKeyPath で参照されるファイル内の証明書とその秘密鍵を置き換えます。

  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. 認証局から、更新された MCP mTLS クライアント証明書とその秘密鍵を取得します。

  2. 証明書とその秘密鍵を一緒に使用して、Secret を更新します。ここで、MCP_CLIENT_SECRET_NAME は Spec.Details で指定された Secret で、MCP_CLIENT_CERT_FILE と MCP_CLIENT_KEY_FILE は証明書とその秘密鍵です。

    kubectl -n apigee create secret generic MCP_CLIENT_SECRET_NAME \
      --from-file=cert=MCP_CLIENT_CERT_FILE --from-file=key=MCP_CLIENT_KEY_FILE \
      --dry-run=client -o yaml | kubectl apply -f -

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

原因: MCP mTLS クライアント証明書の有効期限が切れている

ApigeeRouteConfig によって参照される Kubernetes Secret に格納されている MCP mTLS クライアント証明書の有効期限が切れています。

診断

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

kubectl -n apigee describe apigeeissue ISSUE_NAME

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

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

Name:         mcp-client-cert-expired-my-org-my-virtualhost
Namespace:    apigee
Labels:       ais-reason=AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
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 client certificate in secret "my-org-my-virtualhost-mcp" for ApigeeRouteConfig "my-org-my-virtualhost" expired at: 2026-11-10 17:03:43 +0000 UTC
  Documentation:  https://cloud.google.com/apigee/docs/hybrid/troubleshooting/AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
  Reason:         AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
  Severity:       ERROR
Events:           <none>
Spec:
  Details:        MCP mTLS client certificate in secret "my-org-my-virtualhost-mcp" for ApigeeRouteConfig "my-org-my-virtualhost" expired at: 2026-11-10 17:03:43 +0000 UTC

Spec.Details の内容は、有効期限が切れた MCP mTLS クライアント証明書を含む Kubernetes Secret を参照する ApigeeRouteConfig の名前について説明しています。

解決策

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

    kubectl -n apigee describe apigeeissue ISSUE_NAME

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

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

  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. 認証局から更新された MCP mTLS クライアント証明書を取得し、mcpMtls.sslCertPath と mcpMtls.sslKeyPath で参照されるファイル内の証明書とその秘密鍵を置き換えます。

  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. 認証局から、更新された MCP mTLS クライアント証明書とその秘密鍵を取得します。

  2. 証明書とその秘密鍵を一緒に使用して、Secret を更新します。ここで、MCP_CLIENT_SECRET_NAME は Spec.Details で指定された Secret で、MCP_CLIENT_CERT_FILE と MCP_CLIENT_KEY_FILE は証明書とその秘密鍵です。

    kubectl -n apigee create secret generic MCP_CLIENT_SECRET_NAME \
      --from-file=cert=MCP_CLIENT_CERT_FILE --from-file=key=MCP_CLIENT_KEY_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.sslCertPath によって参照されているファイル内の証明書、またはシークレットの cert エントリ内の証明書。