Masa berlaku sertifikat klien mTLS MCP

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

  1. Gunakan kubectl describe untuk menampilkan nama secret Kubernetes dan ApigeeRouteConfig yang terkait dengan masalah tersebut:

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    Ganti ISSUE_NAME dengan nama masalah, misalnya mcp-client-cert-expiring-soon-my-org-my-virtualhost.

    Dalam contoh ini, ApigeeRouteConfig my-org-my-virtualhost merujuk ke secret my-org-my-virtualhost-mcp.

  2. Tentukan nama virtualhost dari ApigeeRouteConfig.

    Nama ApigeeRouteConfig menggunakan format: <Apigee organization>-<virtualhost name>.

    Dalam contoh ini, my-org adalah organisasi Apigee dan nama virtualhost-nya adalah my-virtualhost.

  3. Temukan virtualhost yang sesuai di overrides.yaml Anda dan periksa bentuk blok mcpMtls yang 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
...
  1. 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.sslCertPath dan mcpMtls.sslKeyPath.

  2. 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
...
  1. Dapatkan sertifikat klien mTLS MCP yang diperpanjang dan kunci pribadinya dari certificate authority Anda.

  2. 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

  1. Gunakan kubectl describe untuk menampilkan nama secret Kubernetes dan ApigeeRouteConfig yang terkait dengan masalah tersebut:

    kubectl -n apigee describe apigeeissue ISSUE_NAME

    Ganti ISSUE_NAME dengan nama masalah, misalnya mcp-client-cert-expired-my-org-my-virtualhost.

    Dalam contoh ini, ApigeeRouteConfig my-org-my-virtualhost merujuk ke secret my-org-my-virtualhost-mcp.

  2. Tentukan nama virtualhost dari ApigeeRouteConfig.

    Nama ApigeeRouteConfig menggunakan format: <Apigee organization>-<virtualhost name>.

    Dalam contoh ini, my-org adalah organisasi Apigee dan nama virtualhost-nya adalah my-virtualhost.

  3. Temukan virtualhost yang sesuai di overrides.yaml Anda dan periksa bentuk blok mcpMtls yang 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
...
  1. 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.sslCertPath dan mcpMtls.sslKeyPath.

  2. 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
...
  1. Dapatkan sertifikat klien mTLS MCP yang diperpanjang dan kunci pribadinya dari certificate authority Anda.

  2. 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:

  1. Project ID Google Cloud .
  2. Nama organisasi Apigee hybrid.
  3. Kolom Spec.Details dari ApigeeIssue.
  4. (opsional) Sertifikat dalam file yang dirujuk oleh mcpMtls.sslCertPath, atau dalam entri cert secret, untuk virtualhost yang terpengaruh.