blob: 94f3844d5103a54db4aee31bdb9850c34d14aeec [file] [log] [blame]
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
/**
* @unrestricted
*/
export default class SecurityModel extends SDK.SDKModel {
/**
* @param {!SDK.Target} target
*/
constructor(target) {
super(target);
this._dispatcher = new SecurityDispatcher(this);
this._securityAgent = target.securityAgent();
target.registerSecurityDispatcher(this._dispatcher);
this._securityAgent.enable();
}
/**
* @return {!SDK.ResourceTreeModel}
*/
resourceTreeModel() {
return /** @type {!SDK.ResourceTreeModel} */ (this.target().model(SDK.ResourceTreeModel));
}
/**
* @return {!SDK.NetworkManager}
*/
networkManager() {
return /** @type {!SDK.NetworkManager} */ (this.target().model(SDK.NetworkManager));
}
/**
* @param {!Protocol.Security.SecurityState} a
* @param {!Protocol.Security.SecurityState} b
* @return {number}
*/
static SecurityStateComparator(a, b) {
let securityStateMap;
if (SecurityModel._symbolicToNumericSecurityState) {
securityStateMap = SecurityModel._symbolicToNumericSecurityState;
} else {
securityStateMap = new Map();
const ordering = [
Protocol.Security.SecurityState.Info, Protocol.Security.SecurityState.InsecureBroken,
Protocol.Security.SecurityState.Insecure, Protocol.Security.SecurityState.Neutral,
Protocol.Security.SecurityState.Secure,
// Unknown is max so that failed/cancelled requests don't overwrite the origin security state for successful requests,
// and so that failed/cancelled requests appear at the bottom of the origins list.
Protocol.Security.SecurityState.Unknown
];
for (let i = 0; i < ordering.length; i++) {
securityStateMap.set(ordering[i], i + 1);
}
SecurityModel._symbolicToNumericSecurityState = securityStateMap;
}
const aScore = securityStateMap.get(a) || 0;
const bScore = securityStateMap.get(b) || 0;
return aScore - bScore;
}
}
SDK.SDKModel.register(SecurityModel, SDK.Target.Capability.Security, false);
/** @enum {symbol} */
export const Events = {
SecurityStateChanged: Symbol('SecurityStateChanged'),
VisibleSecurityStateChanged: Symbol('VisibleSecurityStateChanged')
};
/** @type {!Object<string, string>} */
export const SummaryMessages = {
[Protocol.Security.SecurityState.Unknown]: ls`The security of this page is unknown.`,
[Protocol.Security.SecurityState.Insecure]: ls`This page is not secure.`,
[Protocol.Security.SecurityState.Neutral]: ls`This page is not secure.`,
[Protocol.Security.SecurityState.Secure]: ls`This page is secure (valid HTTPS).`,
[Protocol.Security.SecurityState.InsecureBroken]: ls`This page is not secure (broken HTTPS).`
};
/**
* @unrestricted
*/
export class PageSecurityState {
/**
* @param {!Protocol.Security.SecurityState} securityState
* @param {!Array<!Protocol.Security.SecurityStateExplanation>} explanations
* @param {?string} summary
*/
constructor(securityState, explanations, summary) {
this.securityState = securityState;
this.explanations = explanations;
this.summary = summary;
}
}
/**
* @unrestricted
*/
export class PageVisibleSecurityState {
constructor(securityState, certificateSecurityState, safetyTipInfo, securityStateIssueIds) {
this.securityState = securityState;
this.certificateSecurityState =
certificateSecurityState ? new CertificateSecurityState(certificateSecurityState) : null;
this.safetyTipInfo = safetyTipInfo ? new SafetyTipInfo(safetyTipInfo) : null;
this.securityStateIssueIds = securityStateIssueIds;
}
}
export class CertificateSecurityState {
/**
* @param {!Protocol.Security.CertificateSecurityState} certificateSecurityState
*/
constructor(certificateSecurityState) {
/** @type {string} */
this.protocol = certificateSecurityState.protocol;
/** @type {string} */
this.keyExchange = certificateSecurityState.keyExchange;
/** @type {?string} */
this.keyExchangeGroup = certificateSecurityState.keyExchangeGroup || null;
/** @type {string} */
this.cipher = certificateSecurityState.cipher;
/** @type {?string} */
this.mac = certificateSecurityState.mac || null;
/** @type {!Array<string>} */
this.certificate = certificateSecurityState.certificate;
/** @type {string} */
this.subjectName = certificateSecurityState.subjectName;
/** @type {string} */
this.issuer = certificateSecurityState.issuer;
/** @type {!Protocol.Network.TimeSinceEpoch} */
this.validFrom = certificateSecurityState.validFrom;
/** @type {!Protocol.Network.TimeSinceEpoch} */
this.validTo = certificateSecurityState.validTo;
/** @type {?string} */
this.certificateNetworkError = certificateSecurityState.certificateNetworkError || null;
/** @type {boolean} */
this.certificateHasWeakSignature = certificateSecurityState.certificateHasWeakSignature;
/** @type {boolean} */
this.certificateHasSha1Signature = certificateSecurityState.certificateHasSha1Signature;
/** @type {boolean} */
this.modernSSL = certificateSecurityState.modernSSL;
/** @type {boolean} */
this.obsoleteSslProtocol = certificateSecurityState.obsoleteSslProtocol;
/** @type {boolean} */
this.obsoleteSslKeyExchange = certificateSecurityState.obsoleteSslKeyExchange;
/** @type {boolean} */
this.obsoleteSslCipher = certificateSecurityState.obsoleteSslCipher;
/** @type {boolean} */
this.obsoleteSslSignature = certificateSecurityState.obsoleteSslSignature;
}
/**
* @return {boolean}
*/
isCertificateExpiringSoon() {
const expiryDate = new Date(this.validTo * 1000);
return (expiryDate < new Date(Date.now()).setHours(48)) && (expiryDate > Date.now());
}
/**
* @return {string}
*/
getKeyExchangeName() {
if (this.keyExchangeGroup) {
return this.keyExchange ? ls`${this.keyExchange} with ${this.keyExchangeGroup}` : this.keyExchangeGroup;
}
return this.keyExchange;
}
/**
* @return {string}
*/
getCipherFullName() {
return this.mac ? ls`${this.cipher} with ${this.mac}` : this.cipher;
}
}
class SafetyTipInfo {
constructor(safetyTipInfo) {
/** @type {string} */
this.safetyTipStatus = safetyTipInfo.safetyTipStatus;
/** @type {?string} */
this.safeUrl = safetyTipInfo.safeUrl || null;
}
}
export class SecurityStyleExplanation {
/**
* @param {!Protocol.Security.SecurityState} securityState
* @param {string|undefined} title
* @param {string} summary
* @param {string} description
* @param {!Array<string>=} certificate
* @param {!Protocol.Security.MixedContentType=} mixedContentType
* @param {!Array<string>=} recommendations
*/
constructor(
securityState, title, summary, description, certificate = [],
mixedContentType = Protocol.Security.MixedContentType.None, recommendations = []) {
this.securityState = securityState;
this.title = title;
this.summary = summary;
this.description = description;
this.certificate = certificate;
this.mixedContentType = mixedContentType;
this.recommendations = recommendations;
}
}
/**
* @implements {Protocol.SecurityDispatcher}
* @unrestricted
*/
class SecurityDispatcher {
constructor(model) {
this._model = model;
}
/**
* @override
* @param {!Protocol.Security.SecurityState} securityState
* @param {boolean} schemeIsCryptographic
* @param {!Array<!Protocol.Security.SecurityStateExplanation>} explanations
* @param {!Protocol.Security.InsecureContentStatus} insecureContentStatus
* @param {?string=} summary
*/
securityStateChanged(securityState, schemeIsCryptographic, explanations, insecureContentStatus, summary) {
const pageSecurityState = new PageSecurityState(securityState, explanations, summary || null);
this._model.dispatchEventToListeners(Events.SecurityStateChanged, pageSecurityState);
}
/**
* @override
* @param {!Protocol.Security.VisibleSecurityState} visibleSecurityState
*/
visibleSecurityStateChanged(visibleSecurityState) {
const pageVisibleSecurityState = new PageVisibleSecurityState(
visibleSecurityState.securityState, visibleSecurityState.certificateSecurityState || null,
visibleSecurityState.safetyTipInfo || null, visibleSecurityState.securityStateIssueIds);
this._model.dispatchEventToListeners(Events.VisibleSecurityStateChanged, pageVisibleSecurityState);
}
/**
* @override
* @param {number} eventId
* @param {string} errorType
* @param {string} requestURL
*/
certificateError(eventId, errorType, requestURL) {
}
}
/* Legacy exported object */
self.Security = self.Security || {};
/* Legacy exported object */
Security = Security || {};
/**
* @constructor
*/
Security.SecurityModel = SecurityModel;
/** @enum {symbol} */
Security.SecurityModel.Events = Events;
/** @type {!Object<string, string>} */
Security.SummaryMessages = SummaryMessages;
/**
* @constructor
*/
Security.PageSecurityState = PageSecurityState;
/**
* @constructor
*/
Security.PageVisibleSecurityState = PageVisibleSecurityState;
/**
* @constructor
*/
Security.CertificateSecurityState = CertificateSecurityState;
/**
* @constructor
*/
Security.SecurityStyleExplanation = SecurityStyleExplanation;