Bagian ini menjelaskan masalah umum Anthos Service Mesh dan cara menyelesaikannya. Jika Anda memerlukan bantuan tambahan, lihat Mendapatkan dukungan.
Di Anthos Service Mesh, Mesh CA atau Istiod menerbitkan sertifikat untuk workload di semua cluster dalam mesh. Kebijakan autentikasi (misalnya, mTLS) dan kebijakan Otorisasi (misalnya, izinkan/tolak) dikirim ke setiap cluster. Kebijakan ini menentukan beban kerja mana yang dapat berkomunikasi dan bagaimana caranya.
Masalah TLS
Bagian berikut menjelaskan cara menyelesaikan masalah terkait TLS di Anthos Service Mesh.
Contoh di bagian ini menggunakan variabel ${CTX}
, yang merupakan nama konteks dalam file konfigurasi Kubernetes default yang Anda gunakan untuk mengakses cluster. Tetapkan variabel ${CTX}
seperti contoh berikut:
export CTX=gke_PROJECT_ID_CLUSTER_LOCATION_CLUSTER_NAME
Memverifikasi penerapan TLS
Pastikan permintaan teks biasa tidak diizinkan untuk suatu layanan saat layanan memerlukan koneksi TLS:
kubectl exec SOURCE_POD -n SOURCE_NAMESPACE -c \ SOURCE_CONTAINER -- curl -v DESTINATION_URL
Dengan asumsi bahwa layanan memerlukan koneksi TLS, permintaan teks biasa di atas akan gagal, sehingga menghasilkan output yang mirip dengan berikut ini:
curl: (56) Recv failure: Connection reset by peer command terminated with exit code 56
Memeriksa sertifikat mTLS
Saat mTLS diaktifkan, periksa sertifikat mTLS beban kerja dengan melihat
header X-Forwarded-Client-Cert
. Untuk melakukannya, gunakan langkah-langkah berikut:
Deploy layanan contoh
httpbin
, yang dapat menampilkan header yang diterimanya.Gunakan
curl
untuk melihat headerX-Forwarded-Client-Cert
:kubectl exec --context=${CTX} SOURCE_POD -n SOURCE_NAMESPACE -c \ SOURCE_CONTAINER -- curl http://httpbin.sample:8000/headers -s | \ grep X-Forwarded-Client-Cert
Header
X-Forwarded-Client-Cert
menampilkan informasi sertifikat mTLS, seperti contoh berikut:X-Forwarded-Client-Cert": "By=spiffe://lt-multicluster-t2-5-15-2020.svc.id.goog/ns/sample/sa/httpbin;Hash=0781d68adfdab85b08b6758ed502f352464e81166f065cc6acde9433337b4494;Subject=\"OU=istio_v1_cloud_workload,O=Google LLC,L=Mountain View,ST=California,C=US\";URI=spiffe://lt-multicluster-t2-5-15-2020.svc.id.goog/ns/sample/sa/sleep
Atau, gunakan
openssl
pada file bantuan untuk melihat seluruh rantai sertifikat:kubectl exec --context=${CTX} SOURCE_POD -n SOURCE_NAMESPACE -c istio-proxy \ openssl s_client -alpn istio -showcerts -connect httpbin.sample:8000
Output akan menampilkan rantai sertifikat. Jika Anda menggunakan Mesh CA, pastikan CN root certificate berisi
istio_v1_cloud_workload_root-signer-...
. Jika Anda menggunakan Istiod sebagai certificate authority, pastikan root certificate ditetapkan denganO = <var>YOUR_TRUST_DOMAIN</var>
.
Error bad certificate
TLS di log Istiod
Jika Anda melihat error bad certificate
handshake TLS di log, ini mungkin menunjukkan
bahwa Istiod gagal membuat koneksi TLS ke layanan.
Anda dapat menggunakan string ekspresi reguler TLS handshake error.*bad certificate
untuk menemukan error ini di log.
Error ini biasanya bersifat informatif dan bersifat sementara. Namun, jika terus terjadi, error tersebut mungkin menunjukkan masalah pada sistem Anda.
Pastikan
istio-sidecar-injector
MutatingWebhookConfiguration
Anda memiliki paket CA.Webhook injektor file bantuan (yang digunakan untuk injeksi file bantuan otomatis) memerlukan paket CA untuk membuat koneksi yang aman dengan server API dan Istiod. Paket CA ini di-patch ke dalam konfigurasi oleh istiod, tetapi terkadang dapat ditimpa (misalnya, jika Anda menerapkan kembali konfigurasi webhook).
Verifikasi keberadaan paket CA:
kubectl get mutatingwebhookconfigurations.admissionregistration.k8s.io istio-sidecar-injector -o=jsonpath='{.webhooks[0].clientConfig.caBundle}'
Jika output tidak kosong, paket CA akan dikonfigurasi. Jika paket CA tidak ada, mulai ulang
istiod
agar paket CA memindai ulang webhook dan menginstal ulang paket CA.
Logging penolakan kebijakan otorisasi
Untuk mengetahui informasi tentang logging penolakan kebijakan otorisasi, lihat Logging penolakan.
Kebijakan otorisasi tidak diterapkan
Jika Anda melihat gejala kebijakan otorisasi tidak diterapkan, gunakan perintah berikut untuk memverifikasinya:
kubectl exec --context=${CTX} -it SOURCE_POD -n SOURCE_NAMESPACE \ -c SOURCE_CONTAINER -- curl DESTINATION_URL
Dalam output, pesan access denied
menunjukkan bahwa kebijakan otorisasi diterapkan dengan benar, seperti berikut:
RBAC: access denied
Jika Anda mengonfirmasi bahwa kebijakan otorisasi tidak diterapkan, tolak akses ke
namespace. Contoh berikut menolak akses ke namespace bernama authz-ns
:
kubectl apply --context=${CTX} -f - <<EOF apiVersion: security.istio.io/v1beta1 kind: AuthorizationPolicy metadata: name: deny-authz-ns namespace: authz-ns spec: {} EOF
Error 'customresourcedefinitions.apiextensions.k8s.io dilarang' di log Istiod
Anda mungkin melihat error yang serupa dengan hal berikut:
error failed to list CRDs: customresourcedefinitions.apiextensions.k8s.io is forbidden: User "system:serviceaccount:istio-system:istiod-service-account" cannot list resource "customresourcedefinitions" in API group "apiextensions.k8s.io" at the cluster scope
Anda dapat menggunakan string ekspresi reguler /error.*cannot list resource/
untuk menemukan error ini dalam log.
Error ini dapat terjadi jika deployment Istiod Anda tidak memiliki binding IAM yang benar atau tidak memiliki izin RBAC yang memadai untuk membaca resource kustom.
Periksa apakah binding IAM tidak ada di akun Anda. Pertama, pastikan Anda telah menetapkan kredensial dan izin dengan benar. Kemudian, periksa apakah binding IAM ada menggunakan perintah berikut. Dalam contoh ini, PROJECT_ID adalah output
gcloud config get-value project
dan PROJECT_NUMBER adalah output darigcloud projects list --filter="project_id=${PROJECT_ID}" --format="value(project_number)"
:gcloud projects add-iam-policy-binding ${PROJECT_ID} --member "serviceAccount:service-${PROJECT_NUMBER}@gcp-sa-meshdataplane.iam.gserviceaccount.com" --role "roles/meshdataplane.serviceAgent"
Pastikan aturan RBAC Anda telah diinstal dengan benar.
Jika aturan RBAC tidak ada, jalankan kembali
istioctl install
(atau metode penginstalan yang Anda gunakan untuk menginstal Anthos Service Mesh) untuk membuatnya kembali.Jika ada aturan RBAC dan error tetap ada, periksa apakah
ClusterRoleBindings
danRoleBindings
melampirkan aturan RBAC ke Akun Layanan kubernetes yang benar. Selain itu, pastikan bahwa deployment istiod Anda menggunakan akun layanan yang ditentukan.
serverca
error proses di log Istiod
Anda mungkin melihat error yang serupa dengan hal berikut:
Authentication failed: Authenticator ClientCertAuthenticator at index 0 got error
Anda dapat menggunakan string ekspresi reguler /serverca.*Authentication failed:.*JWT/
untuk menemukan error ini dalam log.
Error ini dapat terjadi saat penerbit JWT salah dikonfigurasi, klien menggunakan token yang sudah tidak berlaku, atau beberapa masalah keamanan lainnya mencegah koneksi diautentikasi ke istiod dengan benar.