Halaman ini berlaku untuk Apigee hybrid, tetapi tidak untuk Apigee.
Tidak ada dokumentasi Apigee Edge yang setara untuk topik ini.
Gejala
ApigeeIssue dengan Reason AIS_MCP_MTLS_CLIENT_CERT_EXPIRY
ditampilkan saat melihat resource di namespace apigee.
Pesan error
Setelah menjalankan kubectl -n apigee get apigeeissues, masalah seperti berikut akan
ditampilkan:
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
Kemungkinan penyebab
Tabel berikut mencantumkan kemungkinan penyebab masalah ini:
| Penyebab | Deskripsi |
|---|---|
| Masa berlaku sertifikat klien mTLS MCP akan segera berakhir | Sertifikat klien mTLS MCP yang dikonfigurasi akan habis masa berlakunya dalam waktu 14 hari. |
| Masa berlaku sertifikat klien mTLS MCP telah berakhir | Masa berlaku sertifikat klien mTLS MCP yang dikonfigurasi telah berakhir. |
Penyebab: Masa berlaku sertifikat klien mTLS MCP akan segera berakhir
Sertifikat klien mTLS MCP yang disimpan di secret Kubernetes yang direferensikan oleh
ApigeeRouteConfig akan habis masa berlakunya dalam 14 hari ke depan.
Diagnosis
Jalankan perintah berikut:
kubectl -n apigee describe apigeeissue ISSUE_NAME
Ganti ISSUE_NAME dengan nama masalah, misalnya
mcp-client-cert-expiring-soon-my-org-my-virtualhost.
Output-nya akan terlihat seperti berikut:
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
Konten Spec.Details menjelaskan nama
ApigeeRouteConfig yang merujuk ke secret Kubernetes yang berisi sertifikat klien mTLS
MCP yang akan segera habis masa berlakunya.
Resolusi
-
Gunakan
kubectl describeuntuk menampilkan nama secret Kubernetes danApigeeRouteConfigyang terkait dengan masalah tersebut:kubectl -n apigee describe apigeeissue ISSUE_NAME
Ganti
ISSUE_NAMEdengan nama masalah, misalnyamcp-client-cert-expiring-soon-my-org-my-virtualhost.Dalam contoh ini,
ApigeeRouteConfigmy-org-my-virtualhostmerujuk ke secretmy-org-my-virtualhost-mcp. -
Tentukan nama
virtualhostdariApigeeRouteConfig.Nama
ApigeeRouteConfigmenggunakan format:<Apigee organization>-<virtualhost name>.Dalam contoh ini,
my-orgadalah organisasi Apigee dan nama virtualhost-nya adalahmy-virtualhost. -
Temukan virtualhost yang sesuai di
overrides.yamlAnda dan periksa bentuk blokmcpMtlsyang digunakannya (lihat Mengonfigurasi mTLS antara bidang data MCP dan gateway masuk). Pilih tab yang cocok, lalu ikuti langkah-langkah di tab tersebut.
File sertifikat
Saat Anda menggunakan jalur file (sslCertPath, sslKeyPath, caCertPath), diagram virtualhost akan membuat dan mengelola secret dari konten file.
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
...-
Dapatkan sertifikat klien mTLS MCP yang diperpanjang dari certificate authority Anda, dan ganti sertifikat serta kunci pribadinya bersama-sama dalam file yang direferensikan oleh
mcpMtls.sslCertPathdanmcpMtls.sslKeyPath. -
Upgrade virtualhost agar diagram menulis ulang secret:
helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \ --namespace apigee \ --set envgroup=ENV_GROUP_NAME \ -f overrides.yaml
Secret Kubernetes
Saat Anda menggunakan referensi secret Kubernetes (sslSecret), bidang data MCP
akan membaca nilai sertifikat langsung dari secret yang Anda buat, dan update
akan diterapkan secara otomatis. helm upgrade tidak diperlukan.
virtualhosts:
...
- name: my-virtualhost
selector:
app: apigee-ingressgateway
tlsMode: MUTUAL
sslSecret: my-ingress-secret
mcpMtls:
sslSecret: my-mcp-client-secret
...-
Dapatkan sertifikat klien mTLS MCP yang diperpanjang dan kunci pribadinya dari certificate authority Anda.
-
Perbarui secret di tempat dengan sertifikat dan kunci pribadinya secara bersamaan, dengan MCP_CLIENT_SECRET_NAME sebagai secret yang diberi nama di
Spec.Details, serta MCP_CLIENT_CERT_FILE dan MCP_CLIENT_KEY_FILE sebagai sertifikat dan kunci pribadinya: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 -
Bidang data MCP mengambil secret yang diperbarui pada refresh berkala berikutnya, biasanya dalam beberapa menit, tanpa memulai ulang pod, dan ApigeeIssue ditarik pada pemindaian berikutnya.
Penyebab: Masa berlaku sertifikat klien mTLS MCP telah berakhir
Sertifikat klien mTLS MCP yang disimpan di secret Kubernetes yang direferensikan oleh
ApigeeRouteConfig telah habis masa berlakunya.
Diagnosis
Jalankan perintah berikut:
kubectl -n apigee describe apigeeissue ISSUE_NAME
Ganti ISSUE_NAME dengan nama masalah, misalnya
mcp-client-cert-expired-my-org-my-virtualhost.
Output-nya akan terlihat seperti berikut:
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
Konten Spec.Details menjelaskan nama
ApigeeRouteConfig yang merujuk ke secret Kubernetes yang berisi sertifikat klien mTLS MCP
yang telah habis masa berlakunya.
Resolusi
-
Gunakan
kubectl describeuntuk menampilkan nama secret Kubernetes danApigeeRouteConfigyang terkait dengan masalah tersebut:kubectl -n apigee describe apigeeissue ISSUE_NAME
Ganti
ISSUE_NAMEdengan nama masalah, misalnyamcp-client-cert-expired-my-org-my-virtualhost.Dalam contoh ini,
ApigeeRouteConfigmy-org-my-virtualhostmerujuk ke secretmy-org-my-virtualhost-mcp. -
Tentukan nama
virtualhostdariApigeeRouteConfig.Nama
ApigeeRouteConfigmenggunakan format:<Apigee organization>-<virtualhost name>.Dalam contoh ini,
my-orgadalah organisasi Apigee dan nama virtualhost-nya adalahmy-virtualhost. -
Temukan virtualhost yang sesuai di
overrides.yamlAnda dan periksa bentuk blokmcpMtlsyang digunakannya (lihat Mengonfigurasi mTLS antara bidang data MCP dan gateway masuk). Pilih tab yang cocok, lalu ikuti langkah-langkah di tab tersebut.
File sertifikat
Saat Anda menggunakan jalur file (sslCertPath, sslKeyPath, caCertPath), diagram virtualhost akan membuat dan mengelola secret dari konten file.
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
...-
Dapatkan sertifikat klien mTLS MCP yang diperpanjang dari certificate authority Anda, dan ganti sertifikat serta kunci pribadinya bersama-sama dalam file yang direferensikan oleh
mcpMtls.sslCertPathdanmcpMtls.sslKeyPath. -
Upgrade virtualhost agar diagram menulis ulang secret:
helm upgrade ENV_GROUP_NAME apigee-virtualhost/ \ --namespace apigee \ --set envgroup=ENV_GROUP_NAME \ -f overrides.yaml
Secret Kubernetes
Saat Anda menggunakan referensi secret Kubernetes (sslSecret), bidang data MCP
akan membaca nilai sertifikat langsung dari secret yang Anda buat, dan update
akan diterapkan secara otomatis. helm upgrade tidak diperlukan.
virtualhosts:
...
- name: my-virtualhost
selector:
app: apigee-ingressgateway
tlsMode: MUTUAL
sslSecret: my-ingress-secret
mcpMtls:
sslSecret: my-mcp-client-secret
...-
Dapatkan sertifikat klien mTLS MCP yang diperpanjang dan kunci pribadinya dari certificate authority Anda.
-
Perbarui secret di tempat dengan sertifikat dan kunci pribadinya secara bersamaan, dengan MCP_CLIENT_SECRET_NAME sebagai secret yang diberi nama di
Spec.Details, serta MCP_CLIENT_CERT_FILE dan MCP_CLIENT_KEY_FILE sebagai sertifikat dan kunci pribadinya: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 -
Bidang data MCP mengambil secret yang diperbarui pada refresh berkala berikutnya, biasanya dalam beberapa menit, tanpa memulai ulang pod, dan ApigeeIssue ditarik pada pemindaian berikutnya.
Harus mengumpulkan informasi diagnostik
Jika masalah berlanjut bahkan setelah mengikuti petunjuk sebelumnya, kumpulkan informasi diagnostik berikut, lalu hubungi Google Cloud Customer Care:
- Project ID Google Cloud .
- Nama organisasi Apigee hybrid.
- Kolom
Spec.DetailsdariApigeeIssue. -
(opsional) Sertifikat dalam file yang dirujuk oleh
mcpMtls.sslCertPath, atau dalam entricertsecret, untuk virtualhost yang terpengaruh.