このページ の内容は 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 foundsecret has no usable "cacert" entry
解決策
-
kubectl describeを使用して、Kubernetes Secret の名前と、問題が属するApigeeRouteConfigを表示します。kubectl -n apigee describe apigeeissue ISSUE_NAME
ISSUE_NAMEは、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhostなど)に置き換えます。この例では、
ApigeeRouteConfigmy-org-my-virtualhostが Secretmy-org-my-virtualhost-mcp-cacertを参照しています。 -
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
...-
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 ゲートウェイの証明書の検証が無効になります。 -
チャートが 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
...-
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 ゲートウェイの証明書の検証が無効になります。 -
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 certificateholds N trailing bytes that are not PEM
解決策
-
kubectl describeを使用して、Kubernetes Secret の名前と、問題が属するApigeeRouteConfigを表示します。kubectl -n apigee describe apigeeissue ISSUE_NAME
ISSUE_NAMEは、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhostなど)に置き換えます。この例では、
ApigeeRouteConfigmy-org-my-virtualhostが Secretmy-org-my-virtualhost-mcp-cacertを参照しています。 -
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
...-
mcpMtls.caCertPathで参照されているファイルの内容を検証し、必要に応じて修正します。コンテンツに、完全な証明書ブロックのみが含まれていることを確認します。各ブロックには、開始行と終了行があります。次に例を示します。-----BEGIN CERTIFICATE----- MIIDYTCCAkmgAwIBAgIUSXeU0pQYRFzYlqZpKhNNJdBLFBIwDQYJKoZIhvcNAQEL ... <contents omitted> ... QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVowMTIzNDU2Nzg5QUJDREVGR0hJSktM MMM= -----END CERTIFICATE-----
-
チャートが 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
...-
Secret の
cacertエントリに保存する CA 証明書ファイル(MCP_TRUST_CA_FILE)の内容を検証し、必要に応じて修正します。コンテンツに、開始行と終了行を含む完全な証明書ブロックのみが含まれていることを確認します。次に例を示します。-----BEGIN CERTIFICATE----- MIIDYTCCAkmgAwIBAgIUSXeU0pQYRFzYlqZpKhNNJdBLFBIwDQYJKoZIhvcNAQEL ... <contents omitted> ... QUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVowMTIzNDU2Nzg5QUJDREVGR0hJSktM MMM= -----END CERTIFICATE-----
-
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 から番号が付けられます。
解決策
-
kubectl describeを使用して、Kubernetes Secret の名前と、問題が属するApigeeRouteConfigを表示します。kubectl -n apigee describe apigeeissue ISSUE_NAME
ISSUE_NAMEは、問題の名前(mcp-ca-cert-invalid-my-org-my-virtualhostなど)に置き換えます。この例では、
ApigeeRouteConfigmy-org-my-virtualhostが Secretmy-org-my-virtualhost-mcp-cacertを参照しています。 -
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
...-
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
-
チャートが 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
...-
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
-
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 カスタマーケアに連絡してください。
- Google Cloud プロジェクト ID
- Apigee ハイブリッド組織の名前。
ApigeeIssueのSpec.Detailsフィールド。-
(省略可)影響を受ける仮想ホストの
mcpMtls.caCertPathによって参照されているファイル内の証明書、またはシークレットのcacertエントリ内の証明書。