chrome.certificateProvider

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ API นี้เพื่อแสดงใบรับรองต่อแพลตฟอร์มซึ่งสามารถใช้ใบรับรองเหล่านี้สำหรับการตรวจสอบสิทธิ์ TLS

สิทธิ์

certificateProvider

ความพร้อมใช้งาน

Chrome 46 ขึ้นไป ChromeOS เท่านั้น

การใช้งาน

การใช้งาน API นี้โดยทั่วไปเพื่อแสดงใบรับรองไคลเอ็นต์ต่อ ChromeOS มีขั้นตอนดังนี้

  • ส่วนขยายจะลงทะเบียนสำหรับเหตุการณ์ onCertificatesUpdateRequested และ onSignatureRequested
  • ส่วนขยายจะเรียกใช้ setCertificates เพื่อแสดงรายการใบรับรองเริ่มต้นหลังจากการเริ่มต้น
  • ส่วนขยายจะตรวจสอบการเปลี่ยนแปลงในรายการใบรับรองที่ใช้ได้และเรียกใช้ setCertificates เพื่อแจ้งให้เบราว์เซอร์ทราบเกี่ยวกับการเปลี่ยนแปลงดังกล่าวทุกครั้ง
  • ในระหว่างการแฮนด์เชค TLS เบราว์เซอร์จะได้รับคำขอใบรับรองไคลเอ็นต์ เมื่อมีเหตุการณ์ onCertificatesUpdateRequested เบราว์เซอร์จะขอให้ส่วนขยายรายงานใบรับรองทั้งหมดที่ส่วนขยายมีอยู่ในปัจจุบัน
  • ส่วนขยายจะรายงานกลับพร้อมใบรับรองที่ใช้ได้ในปัจจุบันโดยใช้เมธอด setCertificates
  • เบราว์เซอร์จะจับคู่ใบรับรองที่มีอยู่ทั้งหมดกับคำขอใบรับรองไคลเอ็นต์จากโฮสต์ระยะไกล ระบบจะแสดงรายการที่ตรงกันให้ผู้ใช้เห็นในกล่องโต้ตอบการเลือก
  • ผู้ใช้สามารถเลือกใบรับรองเพื่ออนุมัติหรือยกเลิกการตรวจสอบสิทธิ์ได้

กล่องโต้ตอบการเลือกใบรับรอง

  • หากผู้ใช้ยกเลิกการตรวจสอบสิทธิ์หรือไม่มีใบรับรองที่ตรงกับคำขอ ระบบจะยกเลิกการตรวจสอบสิทธิ์ไคลเอ็นต์ TLS
  • หรือหากผู้ใช้อนุมัติการตรวจสอบสิทธิ์ด้วยใบรับรองที่ส่วนขยายนี้ให้มา เบราว์เซอร์จะขอให้ส่วนขยายลงชื่อในข้อมูลเพื่อดำเนินการแฮนด์เชค TLS ต่อไป ระบบจะส่งคำขอเป็นเหตุการณ์ onSignatureRequested
  • เหตุการณ์นี้มีข้อมูลอินพุต ประกาศอัลกอริทึมที่ต้องใช้ในการสร้างลายเซ็น และอ้างอิงถึงใบรับรองรายการใดรายการหนึ่งที่ส่วนขยายนี้รายงาน ส่วนขยายต้องสร้างลายเซ็นสำหรับข้อมูลที่ระบุโดยใช้คีย์ส่วนตัวที่เชื่อมโยงกับใบรับรองที่อ้างอิง การสร้างลายเซ็นอาจต้องใส่ DigestInfo ไว้ข้างหน้าและเพิ่มระยะห่างจากขอบของผลลัพธ์ก่อนการลงนามจริง
  • ส่วนขยายจะส่งลายเซ็นกลับไปยังเบราว์เซอร์โดยใช้เมธอด reportSignature หากคำนวณลายเซ็นไม่ได้ คุณต้องเรียกใช้เมธอดโดยไม่มีลายเซ็น
  • หากมีการระบุลายเซ็น เบราว์เซอร์จะดำเนินการแฮนด์เชค TLS ให้เสร็จสมบูรณ์

ลำดับขั้นตอนจริงอาจแตกต่างกันไป ตัวอย่างเช่น ระบบจะไม่ขอให้ผู้ใช้เลือกใบรับรองหากมีการใช้นโยบายองค์กรเพื่อเลือกใบรับรองโดยอัตโนมัติ (ดู AutoSelectCertificateForUrls และนโยบาย Chrome สำหรับผู้ใช้)

ในส่วนขยาย ข้อมูลนี้อาจมีลักษณะคล้ายกับข้อมูลโค้ดต่อไปนี้

function collectAvailableCertificates() {
  // Return all certificates that this Extension can currently provide.
  // For example:
  return [{
    certificateChain: [new Uint8Array(...)],
    supportedAlgorithms: ['RSASSA_PKCS1_v1_5_SHA256']
  }];
}

// The Extension calls this function every time the currently available list of
// certificates changes, and also once after the Extension's initialization.
function onAvailableCertificatesChanged() {
  chrome.certificateProvider.setCertificates({
    clientCertificates: collectAvailableCertificates()
  });
}

function handleCertificatesUpdateRequest(request) {
  // Report the currently available certificates as a response to the request
  // event. This is important for supporting the case when the Extension is
  // unable to detect the changes proactively.
  chrome.certificateProvider.setCertificates({
    certificatesRequestId: request.certificatesRequestId,
    clientCertificates: collectAvailableCertificates()
  });
}

// Returns a private key handle for the given DER-encoded certificate.
// |certificate| is an ArrayBuffer.
function getPrivateKeyHandle(certificate) {...}

// Digests and signs |input| with the given private key. |input| is an
// ArrayBuffer. |algorithm| is an Algorithm.
// Returns the signature as ArrayBuffer.
function signUnhashedData(privateKey, input, algorithm) {...}

function handleSignatureRequest(request) {
  // Look up the handle to the private key of |request.certificate|.
  const key = getPrivateKeyHandle(request.certificate);
  if (!key) {
    // Handle if the key isn't available.
    console.error('Key for requested certificate not available.');

    // Abort the request by reporting the error to the API.
    chrome.certificateProvider.reportSignature({
      signRequestId: request.signRequestId,
      error: 'GENERAL_ERROR'
    });
    return;
  }

  const signature = signUnhashedData(key, request.input, request.algorithm);
  chrome.certificateProvider.reportSignature({
    signRequestId: request.signRequestId,
    signature: signature
  });
}

chrome.certificateProvider.onCertificatesUpdateRequested.addListener(
    handleCertificatesUpdateRequest);
chrome.certificateProvider.onSignatureRequested.addListener(
    handleSignatureRequest);

ประเภท

Algorithm

Chrome 86 ขึ้นไป

ประเภทของอัลกอริทึมลายเซ็นที่ใช้การเข้ารหัสที่รองรับ

ค่าแจกแจง

"RSASSA_PKCS1_v1_5_MD5_SHA1"
ระบุอัลกอริทึมลายเซ็น RSASSA PKCS#1 v1.5 ที่มีการแฮช MD5-SHA-1 ส่วนขยายต้องไม่ใส่คำนำหน้า DigestInfo แต่ต้องเพิ่มเฉพาะระยะห่างจากขอบ PKCS#1 เท่านั้น อัลกอริทึมนี้เลิกใช้งานแล้วและ Chrome จะไม่ขออัลกอริทึมนี้อีกตั้งแต่เวอร์ชัน 109 เป็นต้นไป

"RSASSA_PKCS1_v1_5_SHA1"
ระบุอัลกอริทึมลายเซ็น RSASSA PKCS#1 v1.5 ด้วยฟังก์ชันแฮช SHA-1

"RSASSA_PKCS1_v1_5_SHA256"
ระบุอัลกอริทึมลายเซ็น RSASSA PKCS#1 v1.5 ที่มีฟังก์ชันแฮช SHA-256

"RSASSA_PKCS1_v1_5_SHA384"
ระบุอัลกอริทึมลายเซ็น RSASSA PKCS#1 v1.5 พร้อมฟังก์ชันแฮช SHA-384

"RSASSA_PKCS1_v1_5_SHA512"
ระบุอัลกอริทึมลายเซ็น RSASSA PKCS#1 v1.5 ที่มีฟังก์ชันแฮช SHA-512

"RSASSA_PSS_SHA256"
ระบุอัลกอริทึมลายเซ็น RSASSA PSS ด้วยฟังก์ชันแฮช SHA-256, ฟังก์ชันการสร้างมาสก์ MGF1 และ Salt ที่มีขนาดเท่ากับแฮช

"RSASSA_PSS_SHA384"
ระบุอัลกอริทึมลายเซ็น RSASSA PSS ด้วยฟังก์ชันแฮช SHA-384, ฟังก์ชันการสร้างมาสก์ MGF1 และ Salt ที่มีขนาดเท่ากับแฮช

"RSASSA_PSS_SHA512"
ระบุอัลกอริทึมลายเซ็น RSASSA PSS ด้วยฟังก์ชันแฮช SHA-512, ฟังก์ชันการสร้างมาสก์ MGF1 และ Salt ที่มีขนาดเท่ากับแฮช

CertificateInfo

พร็อพเพอร์ตี้

  • ใบรับรอง

    ArrayBuffer

    ต้องเป็นการเข้ารหัส DER ของใบรับรอง X.509 ปัจจุบันระบบรองรับเฉพาะใบรับรองของคีย์ RSA เท่านั้น

  • supportedHashes

    Hash[]

    ต้องตั้งค่าเป็นแฮชทั้งหมดที่รองรับสำหรับใบรับรองนี้ ระบบจะขอให้ส่วนขยายนี้ลงนามในไดเจสต์ที่คำนวณด้วยอัลกอริทึมแฮชรายการใดรายการหนึ่งเหล่านี้เท่านั้น โดยควรเรียงตามลำดับความต้องการแฮชจากมากไปน้อย

CertificatesUpdateRequest

Chrome 86 ขึ้นไป

พร็อพเพอร์ตี้

  • certificatesRequestId

    ตัวเลข

    ตัวระบุคำขอที่จะส่งไปยัง setCertificates

ClientCertificateInfo

Chrome 86 ขึ้นไป

พร็อพเพอร์ตี้

  • certificateChain

    ArrayBuffer[]

    อาร์เรย์ต้องมีการเข้ารหัส DER ของใบรับรองไคลเอ็นต์ X.509 เป็นองค์ประกอบแรก

    ซึ่งต้องมีใบรับรองเพียง 1 รายการเท่านั้น

  • supportedAlgorithms

    อัลกอริทึม[]

    อัลกอริทึมทั้งหมดที่รองรับสำหรับใบรับรองนี้ ระบบจะขอให้ส่วนขยายใช้ลายเซ็นโดยใช้อัลกอริทึมใดอัลกอริทึมหนึ่งเหล่านี้เท่านั้น

Error

Chrome 86 ขึ้นไป

ประเภทข้อผิดพลาดที่ส่วนขยายสามารถรายงานได้

ค่า

"GENERAL_ERROR"

Hash

เลิกใช้งานแล้ว แทนที่โดย Algorithm

ค่าแจกแจง

"MD5_SHA1"
ระบุอัลกอริทึมการแฮช MD5 และ SHA1

"SHA1"
ระบุอัลกอริทึมการแฮช SHA1

"SHA256"
ระบุอัลกอริทึมการแฮช SHA256

"SHA384"
ระบุอัลกอริทึมการแฮช SHA384

"SHA512"
ระบุอัลกอริทึมการแฮช SHA512

PinRequestErrorType

Chrome 57 ขึ้นไป

ประเภทข้อผิดพลาดที่แสดงต่อผู้ใช้ผ่านฟังก์ชัน requestPin ได้

ค่าแจกแจง

"INVALID_PIN"
ระบุว่า PIN ไม่ถูกต้อง

"INVALID_PUK"
ระบุว่า PUK ไม่ถูกต้อง

"MAX_ATTEMPTS_EXCEEDED"
ระบุว่าพยายามเกินจำนวนครั้งสูงสุดแล้ว

"UNKNOWN_ERROR"
ระบุว่าประเภทข้างต้นไม่สามารถแสดงข้อผิดพลาดได้

PinRequestType

Chrome 57 ขึ้นไป

ประเภทของรหัสที่ส่วนขยายขอด้วยฟังก์ชัน requestPin

ค่าแจกแจง

"PIN"
ระบุว่ารหัสที่ขอเป็น PIN

"PUK"
ระบุว่ารหัสที่ขอคือ PUK

PinResponseDetails

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • userInput

    สตริง ไม่บังคับ

    รหัสที่ผู้ใช้ระบุ ว่างเปล่าหากผู้ใช้ปิดกล่องโต้ตอบหรือเกิดข้อผิดพลาดอื่นๆ

ReportSignatureDetails

Chrome 86 ขึ้นไป

พร็อพเพอร์ตี้

  • ข้อผิดพลาด

    "GENERAL_ERROR"
     ไม่บังคับ

    ข้อผิดพลาดที่เกิดขึ้นขณะสร้างลายเซ็น (หากมี)

  • signRequestId

    ตัวเลข

    ตัวระบุคำขอที่ได้รับผ่านเหตุการณ์ onSignatureRequested

  • ลายเซ็น

    ArrayBuffer ไม่บังคับ

    ลายเซ็น หากสร้างสำเร็จ

RequestPinDetails

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • attemptsLeft

    number ไม่บังคับ

    จำนวนครั้งที่เหลืออยู่ ซึ่งมีไว้เพื่อให้ UI แสดงข้อมูลนี้แก่ผู้ใช้ได้ Chrome ไม่ได้บังคับใช้สิ่งนี้ แต่ส่วนขยายควรเรียกใช้ stopPinRequest โดยมี errorType = MAX_ATTEMPTS_EXCEEDED เมื่อคำขอ PIN เกินจำนวนที่กำหนด

  • errorType

    PinRequestErrorType ไม่บังคับ

    เทมเพลตข้อผิดพลาดที่แสดงต่อผู้ใช้ ควรตั้งค่านี้หากคำขอก่อนหน้าไม่สำเร็จ เพื่อแจ้งให้ผู้ใช้ทราบถึงสาเหตุของความล้มเหลว

  • requestType

    PinRequestType ไม่บังคับ

    ประเภทของรหัสที่ขอ ค่าเริ่มต้นคือ PIN

  • signRequestId

    ตัวเลข

    รหัสที่ Chrome ให้ไว้ใน SignRequest

SetCertificatesDetails

Chrome 86 ขึ้นไป

พร็อพเพอร์ตี้

  • certificatesRequestId

    number ไม่บังคับ

    เมื่อเรียกใช้เพื่อตอบสนองต่อ onCertificatesUpdateRequested ควรมีค่า certificatesRequestId ที่ได้รับ หรือควรยกเลิกการตั้งค่า

  • clientCertificates

    ClientCertificateInfo[]

    รายการใบรับรองไคลเอ็นต์ที่พร้อมใช้งานในปัจจุบัน

  • ข้อผิดพลาด

    "GENERAL_ERROR"
     ไม่บังคับ

    ข้อผิดพลาดที่เกิดขึ้นขณะดึงข้อมูลใบรับรอง (หากมี) ระบบจะแสดงข้อผิดพลาดนี้ให้ผู้ใช้เห็นเมื่อเหมาะสม

SignatureRequest

Chrome 86 ขึ้นไป

พร็อพเพอร์ตี้

  • อัลกอริทึม

    อัลกอริทึม

    อัลกอริทึมลายเซ็นที่จะใช้

  • ใบรับรอง

    ArrayBuffer

    การเข้ารหัส DER ของใบรับรอง X.509 ส่วนขยายต้องลงชื่อ input โดยใช้คีย์ส่วนตัวที่เชื่อมโยง

  • อินพุต

    ArrayBuffer

    ข้อมูลที่จะลงนาม โปรดทราบว่าข้อมูลไม่ได้แฮช

  • signRequestId

    ตัวเลข

    ตัวระบุคำขอที่จะส่งไปยัง reportSignature

SignRequest

พร็อพเพอร์ตี้

  • ใบรับรอง

    ArrayBuffer

    การเข้ารหัส DER ของใบรับรอง X.509 ส่วนขยายต้องลงชื่อ digest โดยใช้คีย์ส่วนตัวที่เชื่อมโยง

  • ไดเจสต์

    ArrayBuffer

    ไดเจสต์ที่ต้องลงนาม

  • แฮช

    แฮช

    หมายถึงอัลกอริทึมแฮชที่ใช้สร้าง digest

  • signRequestId

    ตัวเลข

    Chrome 57 ขึ้นไป

    รหัสที่ไม่ซ้ำกันซึ่งส่วนขยายจะใช้ในกรณีที่ต้องเรียกใช้เมธอดที่ต้องใช้รหัสดังกล่าว เช่น requestPin

StopPinRequestDetails

Chrome 57 ขึ้นไป

พร็อพเพอร์ตี้

  • errorType

    PinRequestErrorType ไม่บังคับ

    เทมเพลตข้อผิดพลาด หากมี ระบบจะแสดงให้ผู้ใช้เห็น มีไว้เพื่อระบุเหตุผลในการหยุดโฟลว์หากเกิดจากข้อผิดพลาด เช่น MAX_ATTEMPTS_EXCEEDED

  • signRequestId

    ตัวเลข

    รหัสที่ Chrome ให้ไว้ใน SignRequest

เมธอด

reportSignature()

Promise Chrome 86 ขึ้นไป 
chrome.certificateProvider.reportSignature(
  details: ReportSignatureDetails,
  callback?: function,
): Promise<void>

ควรเรียกใช้เพื่อตอบสนองต่อ onSignatureRequested

ส่วนขยายต้องเรียกใช้ฟังก์ชันนี้สำหรับทุกเหตุการณ์ onSignatureRequested ในที่สุด การติดตั้งใช้งาน API จะหยุดรอการเรียกนี้หลังจากผ่านไประยะหนึ่ง และตอบกลับด้วยข้อผิดพลาดเกี่ยวกับระยะหมดเวลาเมื่อมีการเรียกใช้ฟังก์ชันนี้

พารามิเตอร์

  • รายละเอียด

    ReportSignatureDetails

  • callback

    function ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

requestPin()

Promise Chrome 57 ขึ้นไป 
chrome.certificateProvider.requestPin(
  details: RequestPinDetails,
  callback?: function,
): Promise<PinResponseDetails | undefined>

ขอ PIN จากผู้ใช้ อนุญาตให้มีคำขอที่อยู่ระหว่างดำเนินการได้ครั้งละ 1 รายการเท่านั้น ระบบจะปฏิเสธคำขอที่ส่งเข้ามาในขณะที่โฟลว์อื่นกำลังดำเนินอยู่ ส่วนขยายมีหน้าที่ลองอีกครั้งในภายหลังหากมีขั้นตอนอื่นที่กำลังดำเนินการอยู่

พารามิเตอร์

  • รายละเอียด

    RequestPinDetails

    มีรายละเอียดเกี่ยวกับกล่องโต้ตอบที่ขอ

  • callback

    function ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (details?: PinResponseDetails) => void

การคืนสินค้า

  • Promise<PinResponseDetails | undefined>

    Chrome 96 ขึ้นไป

    แสดงผล Promise ซึ่งจะได้รับการแก้ไขเมื่อผู้ใช้ระบุ PIN ปฏิเสธพร้อมข้อผิดพลาดหากคำขอของกล่องโต้ตอบดำเนินการไม่สำเร็จ (เช่น กล่องโต้ตอบถูกยกเลิกโดยผู้ใช้หรือไม่ได้รับอนุญาตให้แสดง)

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

setCertificates()

Promise Chrome 86 ขึ้นไป 
chrome.certificateProvider.setCertificates(
  details: SetCertificatesDetails,
  callback?: function,
): Promise<void>

ตั้งค่ารายการใบรับรองที่จะใช้ในเบราว์เซอร์

ส่วนขยายควรเรียกใช้ฟังก์ชันนี้หลังจากการเริ่มต้นและทุกครั้งที่มีการเปลี่ยนแปลงในชุดใบรับรองที่ใช้ได้ในปัจจุบัน ส่วนขยายควรเรียกใช้ฟังก์ชันนี้เพื่อตอบสนองต่อ onCertificatesUpdateRequested ทุกครั้งที่ได้รับเหตุการณ์นี้ด้วย

พารามิเตอร์

  • รายละเอียด

    SetCertificatesDetails

    ใบรับรองที่จะตั้งค่า ระบบจะไม่สนใจใบรับรองที่ไม่ถูกต้อง

  • callback

    function ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

    แสดงผล Promise ซึ่งจะได้รับการแก้ไขเมื่อเสร็จสมบูรณ์

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

stopPinRequest()

Promise Chrome 57 ขึ้นไป 
chrome.certificateProvider.stopPinRequest(
  details: StopPinRequestDetails,
  callback?: function,
): Promise<void>

หยุดคำขอ PIN ที่เริ่มต้นโดยฟังก์ชัน requestPin

พารามิเตอร์

  • รายละเอียด

    StopPinRequestDetails

    มีรายละเอียดเกี่ยวกับสาเหตุที่หยุดขั้นตอนคำขอ

  • callback

    function ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

    แสดงผล Promise ซึ่งจะได้รับการแก้ไขเมื่อคำขอปิดกล่องโต้ตอบ PIN เสร็จสมบูรณ์

    ระบบรองรับ Promise สำหรับ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onCertificatesRequested

Chrome 47 ขึ้นไป &leq; MV2 เลิกใช้งานตั้งแต่ Chrome 86
chrome.certificateProvider.onCertificatesRequested.addListener(
  callback: function,
)

โปรดใช้ onCertificatesUpdateRequested แทน

เหตุการณ์นี้จะเริ่มทำงานทุกครั้งที่เบราว์เซอร์ขอรายการใบรับรองปัจจุบันที่ส่วนขยายนี้มีให้ ส่วนขยายต้องเรียกใช้ reportCallback เพียงครั้งเดียวด้วยรายการใบรับรองปัจจุบัน

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (reportCallback: function) => void

    • reportCallback

      ฟังก์ชัน

      พารามิเตอร์ reportCallback จะมีลักษณะดังนี้ 

      (certificates: CertificateInfo[], callback: function) => void

      • ใบรับรอง

        CertificateInfo[]

      • callback

        ฟังก์ชัน

        พารามิเตอร์ callback จะมีลักษณะดังนี้ 

        (rejectedCertificates: ArrayBuffer[]) => void

        • rejectedCertificates

          ArrayBuffer[]

onCertificatesUpdateRequested

Chrome 86 ขึ้นไป 
chrome.certificateProvider.onCertificatesUpdateRequested.addListener(
  callback: function,
)

เหตุการณ์นี้จะเริ่มทำงานหากใบรับรองที่ตั้งค่าผ่าน setCertificates ไม่เพียงพอหรือเบราว์เซอร์ขอข้อมูลที่อัปเดต ส่วนขยายต้องเรียกใช้ setCertificates พร้อมรายการใบรับรองที่อัปเดตและ certificatesRequestId ที่ได้รับ

พารามิเตอร์

onSignatureRequested

Chrome 86 ขึ้นไป 
chrome.certificateProvider.onSignatureRequested.addListener(
  callback: function,
)

เหตุการณ์นี้จะเริ่มทำงานทุกครั้งที่เบราว์เซอร์ต้องลงชื่อในข้อความโดยใช้ใบรับรองที่ส่วนขยายนี้ให้มาผ่าน setCertificates

ส่วนขยายต้องลงนามข้อมูลที่ป้อนจาก request โดยใช้อัลกอริทึมและคีย์ส่วนตัวที่เหมาะสม และส่งคืนโดยเรียกใช้ reportSignature ด้วย signRequestId ที่ได้รับ

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (request: SignatureRequest) => void

onSignDigestRequested

&leq; MV2 เลิกใช้งานตั้งแต่ Chrome 86
chrome.certificateProvider.onSignDigestRequested.addListener(
  callback: function,
)

โปรดใช้ onSignatureRequested แทน

เหตุการณ์นี้จะเริ่มทำงานทุกครั้งที่เบราว์เซอร์ต้องลงชื่อในข้อความโดยใช้ใบรับรองที่ส่วนขยายนี้ให้ไว้เพื่อตอบกลับเหตุการณ์ onCertificatesRequested ส่วนขยายต้องลงชื่อข้อมูลใน request โดยใช้อัลกอริทึมและคีย์ส่วนตัวที่เหมาะสม และส่งคืนโดยเรียกใช้ reportCallback ต้องเรียกใช้ reportCallback เพียงครั้งเดียวเท่านั้น

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้ 

    (request: SignRequest, reportCallback: function) => void

    • ส่งคำขอ

      SignRequest

    • reportCallback

      ฟังก์ชัน

      Chrome 47 ขึ้นไป

      พารามิเตอร์ reportCallback จะมีลักษณะดังนี้ 

      (signature?: ArrayBuffer) => void

      • ลายเซ็น

        ArrayBuffer ไม่บังคับ