webRequest.SecurityInfo

Значения этого типа — объекты. Они содержат следующие свойства:

certificates

Array CertificateInfo. Если webRequest.getSecurityInfo() был вызван с опцией certificateChain и значением true, это будет содержать объект CertificateInfo для каждого сертификата в цепочке, от сертификата сервера до корневого сертификата доверия включительно.

В противном случае это будет содержать один объект CertificateInfo для сертификата сервера.

certificateTransparencyStatus Необязательно

String. Указывает статус Прозрачности сертификатов для подключения. Может принимать одно из следующих значений:

• "not_applicable"
• "policy_compliant"
• "policy_not_enough_scts"
• "policy_not_diverse_scts"

cipherSuite Необязательно

String. Используемый набор шифров для подключения, отформатированный в соответствии со спецификацией TLS, например, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256".

errorMessage Необязательно

String. Если возникла проблема с рукопожатием TLS (например, сертификат истек или не был найден доверенный корень, или сертификат был отозван), то status будет "broken", а свойство errorMessage будет содержать строку, описывающую ошибку, взятую из внутреннего списка кодов ошибок Firefox.

Однако, в настоящее время вы можете вызвать getSecurityInfo() только в обработчике onHeaderReceived, и событие onHeaderReceived не генерируется при сбое рукопожатия. Поэтому на практике это значение никогда не будет установлено.

hsts Необязательно

Boolean. true если хост использует Strict Transport Security, false в противном случае.

isDomainMismatch Необязательно

Boolean. true если имя домена сервера не соответствует имени домена в его сертификате, false в противном случае.

isExtendedValidation Необязательно

Boolean. true если сервер имеет расширенный сертификат проверки, false в противном случае.

isNotValidAtThisTime Необязательно

Boolean. true если текущее время находится за пределами срока действия сертификата сервера (т.е. сертификат истек или ещё не действителен), false в противном случае.

isUntrusted Необязательно

Boolean. true если цепочка до корневого сертификата доверия не могла быть построена, false в противном случае.

keaGroupName Необязательно

String. Если state равно "secure", это описывает алгоритм обмена ключами, используемый в этом запросе.

protocolVersion Необязательно

String. Версия протокола TLS. Одно из следующих значений:

• "TLSv1"
• "TLSv1.1"
• "TLSv1.2"
• "TLSv1.3"
• "unknown" (если версия недействительна)

secretKeyLength Необязательно

Number. Длина секретного ключа в битах.

signatureSchemeName Необязательно

String. Если state равно "secure", это описывает схему цифровой подписи, используемую в этом запросе.

state

String. Состояние соединения. Одно из следующих значений:

• "broken": рукопожатие TLS завершилось неудачно (например, сертификат истек)
• "insecure": соединение не является TLS-соединением
• "secure": соединение является защищённым TLS-соединением
• "weak": соединение является TLS-соединением, но считается слабым. Вы можете проверить weaknessReasons для выяснения проблемы.

Однако, в настоящее время вы можете вызвать getSecurityInfo() только в обработчике onHeaderReceived, и событие onHeaderReceived не генерируется при сбое рукопожатия. Поэтому на практике это значение никогда не будет установлено в "broken".

usedDelegatedCredentials Необязательно

Boolean. true если соединение использовало делегированные учётные данные, false в противном случае.

usedEch Необязательно

Boolean. true если соединение использовало ECH (Зашифрованный приветствие клиента), false в противном случае.

usedOcsp Необязательно

Boolean. true если соединение выполнило запрос OCSP (Протокол онлайн-статуса сертификата), false в противном случае.

usedPrivateDns Необязательно

Boolean. true если соединение выполнило частный DNS-запрос, такой как DoH (DNS по HTTPS), false в противном случае.

weaknessReasons Необязательно

String. Если state равно "weak", это указывает причину. В настоящее время это может содержать только одно значение "cipher", указывающее, что согласованный набор шифров считается слабым.