本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

交互 TLS 的協助程式方法

CloudFront 在檢視器請求函數的cf.mtls命名空間中提供 mTLS 特定的協助程式函數。這些函數會重新命名、重新格式化或合併用戶端憑證標頭，然後再將請求轉送至原始伺服器。

import cf from "cloudfront";

cf.mtls.renameClientCertHeaders

將憑證中繼資料標頭重新命名為自訂標頭名稱。

cf.mtls.renameClientCertHeaders({
    "CloudFront-Viewer-Cert-Pem": "X-Client-Cert",
    "CloudFront-Viewer-Cert-Serial-Number": "X-Client-Cert-Serial",
    "CloudFront-Viewer-Cert-Issuer": "X-Client-Cert-Issuer",
});

允許的來源標頭：

cf.mtls.renamePemHeaders

重新命名 PEM 憑證標頭，並選擇性地重新格式化憑證編碼。

cf.mtls.renamePemHeaders({
    "Client-Cert": {
        "newHeaderName": "X-Leaf-Cert",
        "pemCertFormatInfo": {
            "certHeader": "-----CUSTOM HEADER-----",
            "certFooter": "-----CUSTOM FOOTER-----",
            "certEndMarker": "",
            "keepNewlinesInCertData": true
        }
    },
    "Client-Cert-Chain": {
        "newHeaderName": "X-Intermediate-Certs",
        "pemCertFormatInfo": {
            "certHeader": "-----CUSTOM HEADER-----",
            "certFooter": "-----CUSTOM FOOTER-----",
            "certEndMarker": "",
            "keepNewlinesInCertData": true
        }
    }
});

允許的來源標頭：

pemCertFormatInfo 欄位：

在 Cloudfront-Viewer-Cert-PEM 中：

針對 Client-Cert 和 Client-Cert-Chain：

cf.mtls.combinePemHeaders

將 Client-Cert和 合併Client-Cert-Chain為包含完整憑證鏈的單一標頭。

cf.mtls.combinePemHeaders({
    "newHeaderName": "X-Full-Chain",
    "pemCertFormatInfo": {
        "certHeader": "-----BEGIN CERTIFICATE-----",
        "certFooter": "-----END CERTIFICATE-----",
        "certEndMarker": "\n",
        "keepNewlinesInCertData": false
    }
});

certEndMarker 會在憑證之間設定分隔符號。