Ringkasan mTLS backend dengan identitas workload terkelola

Dokumen ini memberikan ringkasan tentang penggunaan identitas workload terkelola untuk mencapai mutual TLS (mTLS) antara Load Balancer Aplikasi dan backend-nya. Identitas workload terkelola secara otomatis menyediakan dan mengelola sertifikat X.509 dari Certificate Authority Service.

Anda juga dapat mencapai mTLS backend tanpa identitas workload terkelola. Untuk mempelajari lebih lanjut mTLS backend tanpa identitas workload terkelola, lihat Ringkasan TLS yang diautentikasi backend dan mTLS backend.

Identitas workload terkelola dapat dikonfigurasi pada resource layanan backend dari load balancer berikut:

  • Load Balancer Aplikasi eksternal global
  • Load Balancer Aplikasi eksternal regional
  • Load Balancer Aplikasi internal lintas region
  • Load Balancer Aplikasi internal regional

Informasi dalam dokumen ini didasarkan pada konsep yang diperkenalkan dalam dokumen berikut:

Pengantar identitas workload terkelola untuk load balancer

Tanpa identitas workload terkelola, penyiapan mTLS backend memerlukan konfigurasi beberapa resource. Saat Anda menetapkan identitas terkelola ke layanan backend load balancer, identitas workload terkelola akan otomatis membuat resource yang diperlukan untuk mTLS, seperti sertifikat klien, konfigurasi kepercayaan, dan konfigurasi autentikasi backend.

Untuk mTLS backend, resource layanan backend load balancer bertindak sebagai workload sumber yang mengautentikasi dirinya sendiri ke backend, yang merupakan workload tujuan.

Anda dapat menetapkan identitas terkelola—yang diwakili oleh ID SPIFFE— ke layanan backend load balancer. Google Cloud Certificate Authority Service otomatis menyediakan sertifikat X.509 untuk SPIFFE ID. Sertifikat X.509 untuk ID SPIFFE ini juga dikenal sebagai SPIFFE Verifiable Identity Document (SVID). Layanan backend load balancer dan backend-nya menggunakan SVID untuk saling mengautentikasi melalui autentikasi mTLS.

Diagram berikut menunjukkan load balancer (workload sumber) dan backend (workload tujuan) yang saling mengautentikasi satu sama lain menggunakan identitas workload terkelola.

mTLS backend menggunakan identitas workload terkelola.
Backend mTLS menggunakan identitas workload terkelola (klik untuk memperbesar).

Berikut adalah contoh X.509-SVID yang berfungsi sebagai wrapper untuk ID SPIFFE. ID SPIFFE, yang direpresentasikan sebagai URI, dienkode dalam Nama Alternatif Subjek (SAN) sertifikat X.509.

Issuer:
    C=US
    O=Example Inc.
    CN=Example CA

Validity:
    Not Before: Jun 14 00:00:00 2025 GMT
    Not After : Jun 16 00:00:00 2025 GMT

Subject (Distinguished Name):
    C=US
    O=Example Inc.
    OU=Production
    CN=api.example.com

Subject Public Key Info:
    Public Key Algorithm: RSA Encryption
    RSA Public-Key: (2048 bit)

X.509v3 Extensions:
    Subject Alternative Name (SAN):
        DNS: api.example.com
        URI: spiffe://WORKLOAD_IDENTITY_POOL_ID.global.PROJECT_NUMBER.workload.id.goog/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID

Output ini mencakup nilai-nilai berikut:

  • WORKLOAD_IDENTITY_POOL_ID: ID workload identity pool
  • PROJECT_NUMBER: nomor project dari project Google Cloud Anda
  • NAMESPACE_ID: ID namespace
  • MANAGED_IDENTITY_ID: ID identitas terkelola

Manfaat menggunakan identitas workload terkelola

Berikut adalah beberapa manfaat menggunakan identitas workload terkelola untuk mTLS backend:

  • Keamanan yang ditingkatkan: dengan bergabung ke workload identity pool, load balancer Google Cloud dan backend-nya menjadi bagian dari domain kepercayaan. Jika digunakan bersama dengan mTLS backend, load balancer dan workload backend akan saling mengautentikasi. Autentikasi bersama ini mencegah workload yang tidak sah mengakses layanan Anda dan mengenkripsi data dalam pengiriman.

  • Pengelolaan sertifikat otomatis: setelah pengesahan workload berhasil, Google Cloud akan otomatis menyediakan dan merotasi sertifikat X.509 untuk workload yang berpartisipasi dalam domain kepercayaan workload identity pool. Pengelolaan otomatis sertifikat X.509 ini menghilangkan proses pengelolaan sertifikat manual yang rumit dan rawan error.

  • Identitas yang dapat dioperasikan: workload identity pool menggunakan framework SPIFFE—standar untuk mengelola identitas di seluruh sistem terdistribusi, yang memungkinkan autentikasi dan otorisasi dalam arsitektur modern berbasis microservice.

  • Tata kelola terpusat: workload identity pool menyediakan titik kontrol pusat. Administrator dapat menentukan domain trust dan menetapkan kebijakan pengesahan untuk mengatur workload mana yang dapat menerima sertifikat X.509 untuk identitas terkelola.

Persyaratan sertifikat

Saat mengonfigurasi sertifikat, pastikan sertifikat tersebut mematuhi persyaratan berikut:

  • Alat kriptografi modern menjadi dasar autentikasi mTLS. Sertifikat harus menggunakan algoritma RSA atau ECDSA untuk pertukaran kunci. Algoritma hashing harus menggunakan SHA-256 atau fungsi hash kriptografis yang lebih kuat. Algoritma hashing seperti MD4, MD5, dan SHA-1 tidak didukung.

  • Sertifikat server leaf yang disediakan oleh backend memiliki persyaratan berikut:

  • Sertifikat klien leaf (load balancer) yang digunakan dalam mTLS backend adalah sertifikat identitas terkelola Certificate Manager yang dibuat secara otomatis, dan akan otomatis memenuhi persyaratan berikut:

  • Untuk mengautentikasi sertifikat server yang ditampilkan backend Anda ke load balancer, sertifikat root dan intermediate yang berada di konfigurasi kepercayaan harus memenuhi persyaratan berikut:

Arsitektur mTLS backend menggunakan identitas workload terkelola

Komponen berikut bekerja sama untuk mencapai mTLS backend menggunakan identitas workload terkelola:

  • Layanan backend load balancer (Compute Engine API)
  • Domain kepercayaan Identity and Access Management (Identity and Access Management API)
  • Certificate authority pool (Certificate Authority Service API)
  • Konfigurasi autentikasi backend (Network Security API)
  • Konfigurasi kepercayaan Certificate Manager (Certificate Manager API)
  • Sertifikat identitas terkelola Certificate Manager (Certificate Manager API)

Diagram berikut menunjukkan identitas terkelola di layanan backend load balancer, yang memungkinkan load balancer melakukan autentikasi ke backend. Dalam diagram, langkah 1-3 menunjukkan resource yang dibuat secara eksplisit, sedangkan langkah 4-5 menunjukkan resource yang dibuat secara otomatis.

  1. Konfigurasikan kumpulan CA Certificate Authority Service untuk menerbitkan sertifikat ke identitas workload terkelola.
  2. Konfigurasikan domain kepercayaan dengan membuat workload identity pool. Kumpulan ini memerlukan namespace, identitas terkelola, kebijakan pengesahan, resource konfigurasi penerbitan sertifikat inline, dan resource konfigurasi kepercayaan inline.
  3. Konfigurasikan layanan backend load balancer dengan identitas terkelola.
  4. Identitas workload terkelola secara otomatis membuat sertifikat identitas terkelola Certificate Manager dan konfigurasi kepercayaan Certificate Manager.

    Sertifikat identitas terkelola Certificate Manager dibuat berdasarkan konfigurasi penerbitan sertifikat di workload identity pool. Konfigurasi kepercayaan Certificate Manager disinkronkan dengan konfigurasi kepercayaan inline workload identity pool.

  5. Identitas workload terkelola secara otomatis membuat konfigurasi autentikasi backend.

    Konfigurasi kepercayaan Certificate Manager dilampirkan ke konfigurasi autentikasi backend. Sertifikat identitas terkelola Certificate Manager (X.509-SVID) juga dilampirkan ke konfigurasi autentikasi backend, yang kemudian digunakan untuk melakukan autentikasi ke backend.

Untuk mempelajari lebih lanjut konfigurasi mTLS backend menggunakan identitas terkelola, lihat Menyiapkan mTLS backend menggunakan identitas workload terkelola.

mTLS backend menggunakan identitas workload terkelola.
Arsitektur mTLS backend menggunakan identitas workload terkelola (klik untuk memperbesar).

Resource yang dibuat selama mTLS backend menggunakan identitas terkelola

Seperti yang ditunjukkan dalam diagram arsitektur sebelumnya, saat menetapkan identitas terkelola ke layanan backend, Anda tidak perlu mengonfigurasi konfigurasi autentikasi backend, konfigurasi kepercayaan Certificate Manager, dan sertifikat Certificate Manager. Resource ini dibuat secara otomatis oleh identitas workload terkelola.

Bagian ini membahas lebih lanjut berbagai bagian proses konfigurasi identitas terkelola, dengan fokus pada resource yang dibuat secara eksplisit dan yang dibuat secara otomatis.

Resource yang dibuat secara eksplisit

Resource berikut harus dibuat secara eksplisit saat mengonfigurasi mTLS backend menggunakan identitas workload terkelola.

Kumpulan certificate authority

Untuk mengonfigurasi identitas workload terkelola untuk load balancer, Anda harus mengonfigurasi certificate authority terlebih dahulu, dan secara opsional, satu atau beberapa subordinate CA. Penyiapan ini disebut sebagai hierarki CA. Anda dapat menggunakan pool CA Service untuk menyiapkan hierarki ini.

Perhatikan persyaratan lokasi kumpulan CA berikut:

  • Untuk layanan backend global, kumpulan CA dapat berada di region mana pun karena tidak ada kumpulan CA global.
  • Untuk layanan backend regional, kumpulan CA harus berada di region yang sama dengan layanan backend.

Workload identity pool terikat ke kumpulan CA dengan mengupdate workload identity pool dengan konfigurasi penerbitan sertifikat inline, yang memetakan setiap region Google Cloud ke kumpulan CA di region yang sama.

Workload identity pool

Identitas workload terkelola ditentukan dalam workload identity pool, yang berfungsi sebagai domain kepercayaan.

Domain kepercayaan mewakili batas keamanan logis tempat workload dapat mengautentikasi dan mengizinkan satu sama lain menggunakan ID SPIFFE mereka. Semua workload dalam domain trust yang sama memiliki root of trust yang sama, sehingga workload dapat memverifikasi identitas satu sama lain.

Untuk menggunakan identitas terkelola, Anda harus mengonfigurasi workload identity pool dalam mode TRUST_DOMAIN. Semua identitas dalam kumpulan terdiri dari satu namespace dan ID workload individual.

Namespace

Dalam workload identity pool, identitas workload terkelola diatur ke dalam batas administratif yang disebut namespace. Namespace membantu Anda mengatur dan memberikan akses ke Workload Identity terkait.

Identitas workload terkelola

Identitas workload terkelola didasarkan pada standar SPIFFE, yang menyediakan framework untuk mengidentifikasi, mengautentikasi, dan mengamankan komunikasi antar-workload menggunakan ID SPIFFE yang unik.

Identitas workload terkelola atau identitas terkelola adalah ID workload yang dikonfigurasi dalam workload identity pool. Kebijakan ini dilampirkan ke resource Google Cloud . Setiap identitas terkelola diidentifikasi secara unik oleh namespace dan ID workload individual.

Dalam konteks mencapai mTLS backend, identitas terkelola dilampirkan ke resource layanan backend load balancer.

Nilai identitas terkelola adalah ID SPIFFE yang ditentukan sepenuhnya yang harus sesuai dengan format berikut:

spiffe://TRUST_DOMAIN_NAME/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID

TRUST_DOMAIN_NAME diperluas lebih lanjut sebagai berikut:

WORKLOAD_IDENTITY_POOL_ID.global.PROJECT_NUMBER.workload.id.goog

Untuk menyatukan semuanya, workload Compute Engine, seperti resource layanan backend load balancer, dapat memiliki identitas terkelola sebagai berikut:

spiffe://WORKLOAD_IDENTITY_POOL_ID.global.PROJECT_NUMBER.workload.id.goog/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID

Kebijakan pengesahan

Kebijakan pengesahan berisi aturan untuk Google Cloud IAM guna memverifikasi apakah layanan backend memenuhi syarat untuk menerima sertifikat X.509 untuk identitas terkelola.

Jika verifikasi kebijakan pengesahan lulus, IAM akan meminta sertifikat X.509 untuk identitas terkelola dari Certificate Authority Service. Sertifikat X.509 dibuat di kumpulan CA yang terikat ke identitas terkelola. CA Service menyediakan sertifikat melalui refleksi identitas, tempat ID SPIFFE yang dikonfigurasi direfleksikan ke sertifikat X.509.

Konfigurasi penerbitan sertifikat inline

Saat menyiapkan workload identity pool, Anda mengonfigurasi konfigurasi penerbitan sertifikat inline. Konfigurasi ini menentukan kumpulan CA dari instance Certificate Authority Service Anda yang digunakan untuk membuat sertifikat X.509 bagi identitas dalam workload identity pool. File konfigurasi juga menentukan masa aktif sertifikat, persentase periode rotasi, dan algoritma kunci.

Kumpulan CA menerbitkan sertifikat X.509 ke identitas workload terkelola setelah penegakan kebijakan pengesahan berhasil.

Konfigurasi kepercayaan inline workload identity pool

Secara default, workload Anda dalam domain kepercayaan yang sama dapat saling melakukan autentikasi menggunakan identitas workload terkelola. Jika Anda ingin workload yang berada di domain kepercayaan yang berbeda saling melakukan autentikasi, Anda harus secara eksplisit mendeklarasikan hubungan kepercayaan di workload identity pool. Anda melakukannya dengan membuat konfigurasi kepercayaan inline yang mengenali dan menerima sertifikat dari domain kepercayaan lain. Sertifikat ini digunakan untuk membangun rantai kepercayaan dan memverifikasi identitas workload dari domain lain.

Konfigurasi kepercayaan inline berisi kumpulan trust anchor yang digunakan identitas workload terkelola untuk memvalidasi sertifikat peer. Konfigurasi kepercayaan Certificate Manager merangkum trust store SPIFFE, yang tetap sinkron dengan konfigurasi kepercayaan inline workload identity pool.

Karena workload identity pool terikat ke kumpulan CA, workload identity pool secara otomatis memercayai root certificate dari kumpulan CA yang sama. Anda tidak perlu menambahkan root CA kumpulan ke konfigurasi kepercayaan inline karena kepercayaan tersebut sudah bawaan.

Dalam diagram berikut, load balancer dan backend adalah bagian dari domain kepercayaan yang sama, yang menggunakan root certificate yang sama. Root certificate digunakan untuk membangun rantai kepercayaan dan memverifikasi identitas workload dalam domain kepercayaan.

Hierarki resource identitas workload terkelola.
Hierarki resource identitas workload terkelola (klik untuk memperbesar).

Layanan backend (Compute Engine API)

Untuk menetapkan identitas terkelola ke load balancer, Anda perlu mengonfigurasi layanan backend load balancer sedemikian rupa sehingga atribut tlsSettings-nya mengarah ke properti identity baru (backendService.tlsSettings.identity).

Perhatikan batasan berikut yang berlaku saat menggunakan kolom identity pada layanan backend load balancer:

  • Jika menetapkan properti identity, Anda tidak dapat menetapkan kolom berikut secara manual pada atribut tlsSettings:

    • tlsSettings.sni
    • tlsSettings.subjectAltNames
    • tlsSettings.authenticationConfig
  • Kolom identity hanya dapat ditetapkan selama pembuatan layanan backend.

  • Kolom identity tidak dapat diubah. Setelah ditetapkan ke layanan backend load balancer, kebijakan keamanan tidak dapat diperbarui atau dihapus.

Resource yang dibuat secara otomatis

Setelah Anda menetapkan properti identity (backendService.tlsSettings.identity) pada layanan backend load balancer, resource berikut di Certificate Manager API dan Network Security API akan dibuat secara otomatis oleh identitas workload terkelola.

Resource yang dibuat secara otomatis dibuat dalam project yang sama dengan layanan backend dan menggunakan kuota standar dalam project tersebut.

Konfigurasi kepercayaan Certificate Manager (Certificate Manager API)

Konfigurasi kepercayaan Certificate Manager dibuat secara otomatis dan tidak dapat diedit atau dihapus secara langsung.

Konfigurasi kepercayaan Certificate Manager berisi kolom yang disebut spiffeTrustStores. Kolom spiffeTrustStores berisi paket kepercayaan yang terkait dengan domain kepercayaan workload identity pool dan paket kepercayaan tambahan apa pun yang ditentukan oleh kolom additionalTrustBundles dalam konfigurasi kepercayaan inline workload identity pool. Untuk mempelajari lebih lanjut, lihat Memverifikasi bahwa konfigurasi kepercayaan Certificate Manager berisi kolom spiffeTrustStores.

Untuk mempelajari lebih lanjut cara kolom spiffeTrustStores dalam konfigurasi kepercayaan Certificate Manager memungkinkan validasi sertifikat SPIFFE, lihat Langkah-langkah validasi sertifikat server.

Sertifikat identitas terkelola Certificate Manager (Certificate Manager API)

Sertifikat identitas terkelola Certificate Manager dibuat secara otomatis oleh identitas workload terkelola. Sertifikat identitas terkelola Certificate Manager bersifat hanya baca dan tidak dapat diedit atau dihapus secara langsung menggunakan Certificate Manager API. Sertifikat identitas terkelola Certificate Manager didasarkan pada konfigurasi penerbitan sertifikat inline, yang ditentukan dalam workload identity pool.

Sertifikat identitas terkelola Certificate Manager memiliki properti managedIdentity, yang mengidentifikasinya sebagai sertifikat identitas terkelola. Resource sertifikat identitas terkelola Certificate Manager menyimpan X.509-SVID dalam format berenkode PEM. X.509-SVID ini berisi ID SPIFFE yang dienkode sebagai URI di kolom SAN. ID SPIFFE ini sesuai dengan identitas terkelola di workload identity pool.

Cakupan sertifikat identitas terkelola Certificate Manager adalah CLIENT_AUTH, yang menunjukkan bahwa sertifikat ini digunakan sebagai sertifikat klien di mTLS backend.

Konfigurasi autentikasi backend (Network Security API)

Konfigurasi autentikasi backend dibuat secara otomatis oleh identitas workload terkelola. Konfigurasi autentikasi backend bersifat hanya baca dan tidak dapat diedit atau dihapus secara langsung menggunakan Network Security API.

Konfigurasi kepercayaan Certificate Manager dilampirkan ke konfigurasi autentikasi backend.

Sertifikat identitas terkelola Certificate Manager juga dilampirkan ke konfigurasi autentikasi backend, dan digunakan sebagai X.509-SVID dalam permintaan mTLS backend antara load balancer dan workload tujuan.

Persyaratan hierarki CA untuk deployment multi-region

Jika VM backend di region Google Cloud yang berbeda menggunakan identitas workload terkelola untuk mendapatkan sertifikat servernya, VM di setiap region harus meminta sertifikat dari kumpulan CA yang berada di region yang sama.

Jika load balancer Anda adalah load balancer global (Load Balancer Aplikasi eksternal global atau Load Balancer Aplikasi internal lintas region) dengan backend di beberapa region, Anda harus menyiapkan hierarki CA dengan satu root CA bersama (di region mana pun) dan kumpulan CA subordinat di setiap region tempat backend Anda berada. Jangan membuat root CA terpisah yang ditandatangani sendiri di setiap region; semua kumpulan CA regional di workload identity pool harus terhubung ke root CA yang sama sehingga load balancer dan backend di semua region memiliki root of trust yang sama.

Saat Anda menetapkan identitas workload terkelola ke layanan backend global, identitas workload terkelola akan otomatis membuat konfigurasi kepercayaan Certificate Manager global dan menerbitkan sertifikat klien identitas terkelola global menggunakan kumpulan CA dari satu region arbitrer dalam konfigurasi penerbitan sertifikat inline workload identity pool. Jika backend Anda mencakup beberapa region dan Anda mengonfigurasi CA root yang ditandatangani sendiri dan terpisah di setiap region, bukan CA subordinat yang ditandatangani oleh satu CA root bersama, autentikasi mTLS akan gagal untuk backend di luar region tunggal tersebut.

Langkah-langkah validasi sertifikat server

Saat memvalidasi sertifikat server selama mTLS backend, load balancer melakukan hal berikut:

  1. Memverifikasi bahwa server memiliki kunci pribadi sertifikat.

    Server membuktikan kepemilikan kunci pribadi yang terkait dengan sertifikat yang disajikan ke load balancer dengan menandatangani sebuah informasi menggunakan kunci pribadinya dan mengirimkannya ke load balancer sebagai bagian dari pesan CertificateVerify. Load balancer kemudian memverifikasi tanda tangan ini menggunakan kunci publik dari sertifikat server. Jika verifikasi tanda tangan gagal, hal ini menunjukkan bahwa server backend tidak memiliki kunci pribadi yang sesuai dengan sertifikat. Dalam kasus seperti ini, load balancer menghentikan TLS handshake tanpa mencatat error apa pun.

  2. Verifikasi rantai kepercayaan.

    Kolom spiffeTrustStores dalam konfigurasi kepercayaan Certificate Manager memungkinkan validasi sertifikat SPIFFE. Kolom spiffeTrustStores dalam konfigurasi kepercayaan Certificate Manager otomatis diaktifkan saat menggunakan identitas workload terkelola. Dengan kolom spiffeTrustStores diaktifkan, kolom trustStores tetap kosong.

    Kolom spiffeTrustStores adalah struktur data peta dengan key-value pair sebagai berikut:

    • Kunci dapat berupa domain trust yang terkait dengan workload identity pool (dalam format yang diakhiri dengan .workload.id.goog), atau domain trust tambahan.
    • Value adalah objek TrustStore. Objek ini berisi kumpulan root certificate tepercaya (dikenal sebagai trust bundle) yang digunakan untuk memvalidasi sertifikat SPIFFE dari domain tepercaya tertentu.

    Pada dasarnya, peta ini memungkinkan load balancer dikonfigurasi dengan trust store dari beberapa domain keamanan yang berbeda. Saat backend menampilkan sertifikat SPIFFE-nya, load balancer akan mengekstrak ID SPIFFE, mengidentifikasi domain kepercayaan, dan menggunakan peta spiffeTrustStores untuk mencari trust store yang benar guna memverifikasi rantai kepercayaan dan memvalidasi sertifikat.

    Pemeriksaan verifikasi mencakup hal berikut:

    • Sertifikat server backend, intermediate certificate (jika disediakan), dan root certificate yang dikonfigurasi mematuhi persyaratan sertifikat.
    • Untuk semua sertifikat dalam rantai kepercayaan, kolom subjek di sertifikat induk cocok dengan kolom penerbit di sertifikat turunan. Verifikasi ini membantu memastikan bahwa identitas (subjek) sertifikat induk sama dengan identitas yang tercantum sebagai penerbit dalam sertifikat turunan.
    • Untuk semua sertifikat dalam rantai kepercayaan, ID kunci subjek (SKID) sertifikat induk cocok dengan ID kunci otoritas (AKID) dalam sertifikat turunan. Kecocokan ini mengonfirmasi bahwa sertifikat turunan diterbitkan oleh root authority yang benar dan dapat dipercaya karena kunci publik root dirujuk dalam AKID untuk memverifikasi validitas sertifikat.
  3. Buat koneksi dengan backend.

    Jika validasi sertifikat berhasil, load balancer akan melanjutkan koneksi ke backend.

    Namun, jika validasi sertifikat gagal, load balancer akan menghentikan koneksi ke backend, mengirimkan kode status HTTP 502 ke klien, dan mencatat alasan penghentian ke Cloud Logging. Jika terjadi error validasi sertifikat, permintaan masuk berikutnya akan memicu load balancer untuk memulai ulang koneksi backend.

    Koneksi backend juga dapat gagal jika server backend menolak koneksi. Dengan mTLS backend, hal ini dapat terjadi karena sertifikat klien dianggap tidak valid. Jika koneksi ke backend gagal, load balancer akan merespons permintaan yang di-proxy dengan kode status HTTP 502 dan mencatat alasan error umum ke Cloud Logging.

Penanganan error dan logging

Load Balancer Aplikasi menyediakan kemampuan logging mendetail yang memungkinkan Anda memantau validasi sertifikat server, mengidentifikasi potensi masalah, dan memecahkan masalah koneksi. Bagian ini menguraikan berbagai jenis error yang dapat terjadi selama validasi mTLS dan cara pencatatannya ke dalam log.

Jika validasi sertifikat server gagal, koneksi akan dihentikan dan error akan dicatat ke Cloud Logging. Error ini dijelaskan dalam tabel berikut.

Status sertifikat server Error yang dicatat ke dalam log
Rantai sertifikat server terlalu panjang (lebih dari 10 intermediate certificate disertakan dengan sertifikat server). server_cert_chain_exceeded_limit

Server atau intermediate certificate memiliki ukuran kunci RSA yang tidak valid.

Tidak ada validasi yang dilakukan.

Kunci RSA dapat berkisar dari 2048 hingga 4096 bit.

server_cert_invalid_rsa_key_size

Server atau intermediate certificate menggunakan kurva elips yang tidak didukung.

Tidak ada validasi yang dilakukan.

Kurva yang valid adalah P-256 dan P-384.

server_cert_unsupported_elliptic_curve_key

Server atau intermediate certificate menggunakan algoritma non-RSA atau non-ECDSA.

Tidak ada validasi yang dilakukan.

server_cert_unsupported_key_algorithm

IKP yang akan digunakan untuk validasi memiliki lebih dari sepuluh intermediate certificate dengan Subjek dan Info Kunci Publik Subjek yang sama.

Tidak ada validasi yang dilakukan.

server_cert_pki_too_large

Intermediate certificate yang diberikan untuk validasi memiliki lebih dari 10 batasan nama.

server_cert_chain_max_name_constraints_exceeded

Sertifikat server memiliki kolom ekstensi Extended Key Usage (EKU), tetapi kolom tersebut tidak menyertakan serverAuth.

server_cert_chain_invalid_eku

Batas waktu terlampaui saat mencoba memvalidasi rantai sertifikat. server_cert_validation_timed_out

Batas kedalaman atau iterasi tercapai saat mencoba memvalidasi rantai sertifikat.

Kedalaman maksimum untuk rantai sertifikat adalah sepuluh, termasuk sertifikat root dan server. Jumlah maksimum iterasi adalah 100 (sertifikat yang diperiksa untuk memvalidasi rantai sertifikat server).

server_cert_validation_search_limit_exceeded

Anda mengonfigurasi mTLS tanpa menyiapkan resource TrustConfig.

server_cert_validation_not_performed

Server tidak memberikan sertifikat yang diminta selama handshake.

server_cert_not_provided

Sertifikat server gagal diverifikasi dengan resource TrustConfig.

ssl_certificate_verification_failed

Layanan tidak dapat melakukan validasi rantai sertifikat.

server_cert_validation_unavailable
Error internal saat memvalidasi rantai sertifikat. server_cert_validation_internal_error

TrustConfig yang cocok tidak ditemukan.

server_cert_trust_config_not_found
Payload sertifikat server (termasuk intermediate certificates) terlalu besar (lebih dari 16 KB). server_cert_exceeded_size_limit

Batasan

  • Load Balancer Aplikasi klasik tidak mendukung mTLS backend.

  • mTLS backend tidak didukung untuk backend NEG internet global.

  • Jika Anda menetapkan identitas terkelola ke layanan backend (backendService.tlsSettings.identity), Anda tidak dapat menetapkan kolom berikut secara manual pada properti tlsSettings layanan backend:

    • backendService.tlsSettings.sni
    • backendService.tlsSettings.subjectAltNames
    • backendService.tlsSettings.authenticationConfig
  • Identitas terkelola hanya dapat ditetapkan pada saat pembuatan layanan backend.

  • Identitas terkelola tidak dapat diubah. Setelah menetapkan identitas terkelola ke layanan backend load balancer, identitas tersebut tidak dapat diperbarui atau dihapus.

Langkah berikutnya