このページの内容は 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 の名前について説明しています。
解決策
-
kubectl describeを使用して、Kubernetes Secret の名前と、問題が属するApigeeRouteConfigを表示します。kubectl -n apigee describe apigeeissue ISSUE_NAME
ISSUE_NAMEは、問題の名前(mcp-client-cert-expiring-soon-my-org-my-virtualhostなど)に置き換えます。この例では、
ApigeeRouteConfigmy-org-my-virtualhostが Secretmy-org-my-virtualhost-mcpを参照しています。 -
ApigeeRouteConfigからvirtualhostの名前を特定します。ApigeeRouteConfigの名前は<Apigee organization>-<virtualhost name>の形式になっています。この例では、Apigee 組織は
my-orgで、仮想ホスト名はmy-virtualhostです。 -
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
...-
認証局から更新された MCP mTLS クライアント証明書を取得し、
mcpMtls.sslCertPathとmcpMtls.sslKeyPathで参照されるファイル内の証明書とその秘密鍵を置き換えます。 -
チャートが 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
...-
認証局から、更新された MCP mTLS クライアント証明書とその秘密鍵を取得します。
-
証明書とその秘密鍵を一緒に使用して、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 の名前について説明しています。
解決策
-
kubectl describeを使用して、Kubernetes Secret の名前と、問題が属するApigeeRouteConfigを表示します。kubectl -n apigee describe apigeeissue ISSUE_NAME
ISSUE_NAMEは、問題の名前(mcp-client-cert-expired-my-org-my-virtualhostなど)に置き換えます。この例では、
ApigeeRouteConfigmy-org-my-virtualhostが Secretmy-org-my-virtualhost-mcpを参照しています。 -
ApigeeRouteConfigからvirtualhostの名前を特定します。ApigeeRouteConfigの名前は<Apigee organization>-<virtualhost name>の形式になっています。この例では、Apigee 組織は
my-orgで、仮想ホスト名はmy-virtualhostです。 -
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
...-
認証局から更新された MCP mTLS クライアント証明書を取得し、
mcpMtls.sslCertPathとmcpMtls.sslKeyPathで参照されるファイル内の証明書とその秘密鍵を置き換えます。 -
チャートが 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
...-
認証局から、更新された MCP mTLS クライアント証明書とその秘密鍵を取得します。
-
証明書とその秘密鍵を一緒に使用して、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 カスタマーケアに連絡してください。
- Google Cloud プロジェクト ID
- Apigee ハイブリッド組織の名前。
ApigeeIssueのSpec.Detailsフィールド。-
(省略可)影響を受ける仮想ホストの
mcpMtls.sslCertPathによって参照されているファイル内の証明書、またはシークレットのcertエントリ内の証明書。