תיעוד 82
משתני תעודת לקוח
עודכן לאחרונה: 17 באפריל 2026.
כשבבקשה כלולה תעודת לקוח עבור אימות mTLS, Cloudflare חושפת את פרטי התעודה כמשתנים ב-Ruleset Engine וכמאפיינים על אובייקט request.cf של Workers.
#שדות Ruleset Engine
שדות תעודת לקוח זמינים כשדות mTLS במוצרים מבוססי Ruleset Engine, כגון כללי WAF מותאמים אישית וכללי שינוי כותרות בקשה.
#משתני Workers
המשתנים האלה זמינים גם כחלק מאובייקט request.cf.tlsClientAuth דרך Cloudflare Workers. עיינו בשדה שפת הכללים המקושר להגדרה המלאה.
הערה
לחלק ממאפייני tlsClientAuth יש טיפוס שונה מהשדה המקביל בשפת הכללים. ההבדלים האלה מצוינים ברשימה הבאה.
request.cf.tlsClientAuth.certRevoked: מציין אם לקוח ה-mTLS הציג תעודת לקוח תקינה אבל מבוטלת. ב-Workers זה מחרוזת ("1"עבור מבוטלת,"0"עבור לא מבוטלת) ולא בוליאני.request.cf.tlsClientAuth.certVerified: מציין אם לקוח ה-mTLS הציג תעודת לקוח תקינה. ב-Workers זה מחרוזת ("SUCCESS"כשהיא תקינה,"NONE"כשהיא לא קיימת) ולא בוליאני. בכשל, המחרוזת מכילה את סיבת השגיאה (לדוגמה,"FAILED:unable to get local issuer certificate").request.cf.tlsClientAuth.certPresented: מציין אם לקוח ה-mTLS הציג תעודה (תקינה או לא). ב-Workers זה מחרוזת ("1"כשמוצגת תעודה,"0"אחרת) ולא בוליאני.request.cf.tlsClientAuth.certIssuerDN: ה-Distinguished Name (DN) של רשות האישורים (CA) שהנפיקה את תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certSubjectDN: ה-Distinguished Name (DN) של הבעלים (או המבקש) של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certIssuerDNRFC2253: ה-Distinguished Name (DN) של רשות האישורים (CA) שהנפיקה את תעודת הלקוח של mTLS בפורמט RFC 2253.request.cf.tlsClientAuth.certSubjectDNRFC2253: ה-Distinguished Name (DN) של הבעלים (או המבקש) של תעודת הלקוח של mTLS בפורמט RFC 2253.request.cf.tlsClientAuth.certIssuerDNLegacy: ה-Distinguished Name (DN) של רשות האישורים (CA) שהנפיקה את תעודת הלקוח של mTLS בפורמט ישן.request.cf.tlsClientAuth.certSubjectDNLegacy: ה-Distinguished Name (DN) של הבעלים (או המבקש) של תעודת הלקוח של mTLS בפורמט ישן.request.cf.tlsClientAuth.certSerial: המספר הסידורי של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certIssuerSerial: המספר הסידורי של המנפיק הישיר של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certFingerprintSHA256: טביעת האצבע SHA-256 של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certFingerprintSHA1: טביעת האצבע SHA-1 של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certNotBefore: תעודת הלקוח של mTLS אינה תקפה לפני התאריך הזה.request.cf.tlsClientAuth.certNotAfter: תעודת הלקוח של mTLS אינה תקפה אחרי התאריך הזה.request.cf.tlsClientAuth.certSKI: ה-Subject Key Identifier (SKI) של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certIssuerSKI: ה-Subject Key Identifier (SKI) של המנפיק הישיר של תעודת הלקוח של mTLS.request.cf.tlsClientAuth.certRFC9440: תעודת העלה של הלקוח מקודדת בפורמט RFC 9440 (DER, מקודד ב-Base64, עטוף בנקודתיים).request.cf.tlsClientAuth.certRFC9440TooLarge:trueאם תעודת העלה חרגה ממגבלת הקידוד של 10 KiB והושמטה מ-certRFC9440.request.cf.tlsClientAuth.certChainRFC9440: שרשרת תעודות הביניים בפורמט RFC 9440 כרשימה מופרדת בפסיקים.request.cf.tlsClientAuth.certChainRFC9440TooLarge:trueאם שרשרת הביניים חרגה ממגבלת הקידוד של 16 KiB והושמטה מ-certChainRFC9440.