security

package
v0.0.0-...-ab6d619 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 17, 2024 License: MIT Imports: 7 Imported by: 14

Documentation

Overview

Package security provides the Chrome DevTools Protocol commands, types, and events for the Security domain.

Security.

Generated by the cdproto-gen command.

Index

Constants

View Source
const (
	CommandDisable                    = "Security.disable"
	CommandEnable                     = "Security.enable"
	CommandSetIgnoreCertificateErrors = "Security.setIgnoreCertificateErrors"
)

Command names.

Variables

This section is empty.

Functions

This section is empty.

Types

type CertificateErrorAction

type CertificateErrorAction string

CertificateErrorAction the action to take when a certificate error occurs. continue will continue processing the request and cancel will cancel the request.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-CertificateErrorAction

const (
	CertificateErrorActionContinue CertificateErrorAction = "continue"
	CertificateErrorActionCancel   CertificateErrorAction = "cancel"
)

CertificateErrorAction values.

func (CertificateErrorAction) MarshalEasyJSON

func (t CertificateErrorAction) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON satisfies easyjson.Marshaler.

func (CertificateErrorAction) MarshalJSON

func (t CertificateErrorAction) MarshalJSON() ([]byte, error)

MarshalJSON satisfies json.Marshaler.

func (CertificateErrorAction) String

func (t CertificateErrorAction) String() string

String returns the CertificateErrorAction as string value.

func (*CertificateErrorAction) UnmarshalEasyJSON

func (t *CertificateErrorAction) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON satisfies easyjson.Unmarshaler.

func (*CertificateErrorAction) UnmarshalJSON

func (t *CertificateErrorAction) UnmarshalJSON(buf []byte) error

UnmarshalJSON satisfies json.Unmarshaler.

type CertificateID

type CertificateID int64

CertificateID an internal certificate ID value.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-CertificateId

func (CertificateID) Int64

func (t CertificateID) Int64() int64

Int64 returns the CertificateID as int64 value.

type CertificateSecurityState

type CertificateSecurityState struct {
	Protocol                    string              `json:"protocol"`                          // Protocol name (e.g. "TLS 1.2" or "QUIC").
	KeyExchange                 string              `json:"keyExchange"`                       // Key Exchange used by the connection, or the empty string if not applicable.
	KeyExchangeGroup            string              `json:"keyExchangeGroup,omitempty"`        // (EC)DH group used by the connection, if applicable.
	Cipher                      string              `json:"cipher"`                            // Cipher name.
	Mac                         string              `json:"mac,omitempty"`                     // TLS MAC. Note that AEAD ciphers do not have separate MACs.
	Certificate                 []string            `json:"certificate"`                       // Page certificate.
	SubjectName                 string              `json:"subjectName"`                       // Certificate subject name.
	Issuer                      string              `json:"issuer"`                            // Name of the issuing CA.
	ValidFrom                   *cdp.TimeSinceEpoch `json:"validFrom"`                         // Certificate valid from date.
	ValidTo                     *cdp.TimeSinceEpoch `json:"validTo"`                           // Certificate valid to (expiration) date
	CertificateNetworkError     string              `json:"certificateNetworkError,omitempty"` // The highest priority network error code, if the certificate has an error.
	CertificateHasWeakSignature bool                `json:"certificateHasWeakSignature"`       // True if the certificate uses a weak signature algorithm.
	CertificateHasSha1signature bool                `json:"certificateHasSha1Signature"`       // True if the certificate has a SHA1 signature in the chain.
	ModernSSL                   bool                `json:"modernSSL"`                         // True if modern SSL
	ObsoleteSslProtocol         bool                `json:"obsoleteSslProtocol"`               // True if the connection is using an obsolete SSL protocol.
	ObsoleteSslKeyExchange      bool                `json:"obsoleteSslKeyExchange"`            // True if the connection is using an obsolete SSL key exchange.
	ObsoleteSslCipher           bool                `json:"obsoleteSslCipher"`                 // True if the connection is using an obsolete SSL cipher.
	ObsoleteSslSignature        bool                `json:"obsoleteSslSignature"`              // True if the connection is using an obsolete SSL signature.
}

CertificateSecurityState details about the security state of the page certificate.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-CertificateSecurityState

func (CertificateSecurityState) MarshalEasyJSON

func (v CertificateSecurityState) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (CertificateSecurityState) MarshalJSON

func (v CertificateSecurityState) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*CertificateSecurityState) UnmarshalEasyJSON

func (v *CertificateSecurityState) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*CertificateSecurityState) UnmarshalJSON

func (v *CertificateSecurityState) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type DisableParams

type DisableParams struct{}

DisableParams disables tracking security state changes.

func Disable

func Disable() *DisableParams

Disable disables tracking security state changes.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#method-disable

func (*DisableParams) Do

func (p *DisableParams) Do(ctx context.Context) (err error)

Do executes Security.disable against the provided context.

func (DisableParams) MarshalEasyJSON

func (v DisableParams) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (DisableParams) MarshalJSON

func (v DisableParams) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*DisableParams) UnmarshalEasyJSON

func (v *DisableParams) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*DisableParams) UnmarshalJSON

func (v *DisableParams) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type EnableParams

type EnableParams struct{}

EnableParams enables tracking security state changes.

func Enable

func Enable() *EnableParams

Enable enables tracking security state changes.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#method-enable

func (*EnableParams) Do

func (p *EnableParams) Do(ctx context.Context) (err error)

Do executes Security.enable against the provided context.

func (EnableParams) MarshalEasyJSON

func (v EnableParams) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (EnableParams) MarshalJSON

func (v EnableParams) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*EnableParams) UnmarshalEasyJSON

func (v *EnableParams) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*EnableParams) UnmarshalJSON

func (v *EnableParams) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type EventVisibleSecurityStateChanged

type EventVisibleSecurityStateChanged struct {
	VisibleSecurityState *VisibleSecurityState `json:"visibleSecurityState"` // Security state information about the page.
}

EventVisibleSecurityStateChanged the security state of the page changed.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#event-visibleSecurityStateChanged

func (EventVisibleSecurityStateChanged) MarshalEasyJSON

func (v EventVisibleSecurityStateChanged) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (EventVisibleSecurityStateChanged) MarshalJSON

func (v EventVisibleSecurityStateChanged) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*EventVisibleSecurityStateChanged) UnmarshalEasyJSON

func (v *EventVisibleSecurityStateChanged) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*EventVisibleSecurityStateChanged) UnmarshalJSON

func (v *EventVisibleSecurityStateChanged) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type MixedContentType

type MixedContentType string

MixedContentType a description of mixed content (HTTP resources on HTTPS pages), as defined by https://www.w3.org/TR/mixed-content/#categories.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-MixedContentType

const (
	MixedContentTypeBlockable           MixedContentType = "blockable"
	MixedContentTypeOptionallyBlockable MixedContentType = "optionally-blockable"
	MixedContentTypeNone                MixedContentType = "none"
)

MixedContentType values.

func (MixedContentType) MarshalEasyJSON

func (t MixedContentType) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON satisfies easyjson.Marshaler.

func (MixedContentType) MarshalJSON

func (t MixedContentType) MarshalJSON() ([]byte, error)

MarshalJSON satisfies json.Marshaler.

func (MixedContentType) String

func (t MixedContentType) String() string

String returns the MixedContentType as string value.

func (*MixedContentType) UnmarshalEasyJSON

func (t *MixedContentType) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON satisfies easyjson.Unmarshaler.

func (*MixedContentType) UnmarshalJSON

func (t *MixedContentType) UnmarshalJSON(buf []byte) error

UnmarshalJSON satisfies json.Unmarshaler.

type SafetyTipInfo

type SafetyTipInfo struct {
	SafetyTipStatus SafetyTipStatus `json:"safetyTipStatus"`   // Describes whether the page triggers any safety tips or reputation warnings. Default is unknown.
	SafeURL         string          `json:"safeUrl,omitempty"` // The URL the safety tip suggested ("Did you mean?"). Only filled in for lookalike matches.
}

SafetyTipInfo [no description].

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-SafetyTipInfo

func (SafetyTipInfo) MarshalEasyJSON

func (v SafetyTipInfo) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (SafetyTipInfo) MarshalJSON

func (v SafetyTipInfo) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*SafetyTipInfo) UnmarshalEasyJSON

func (v *SafetyTipInfo) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*SafetyTipInfo) UnmarshalJSON

func (v *SafetyTipInfo) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type SafetyTipStatus

type SafetyTipStatus string

SafetyTipStatus [no description].

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-SafetyTipStatus

const (
	SafetyTipStatusBadReputation SafetyTipStatus = "badReputation"
	SafetyTipStatusLookalike     SafetyTipStatus = "lookalike"
)

SafetyTipStatus values.

func (SafetyTipStatus) MarshalEasyJSON

func (t SafetyTipStatus) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON satisfies easyjson.Marshaler.

func (SafetyTipStatus) MarshalJSON

func (t SafetyTipStatus) MarshalJSON() ([]byte, error)

MarshalJSON satisfies json.Marshaler.

func (SafetyTipStatus) String

func (t SafetyTipStatus) String() string

String returns the SafetyTipStatus as string value.

func (*SafetyTipStatus) UnmarshalEasyJSON

func (t *SafetyTipStatus) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON satisfies easyjson.Unmarshaler.

func (*SafetyTipStatus) UnmarshalJSON

func (t *SafetyTipStatus) UnmarshalJSON(buf []byte) error

UnmarshalJSON satisfies json.Unmarshaler.

type SetIgnoreCertificateErrorsParams

type SetIgnoreCertificateErrorsParams struct {
	Ignore bool `json:"ignore"` // If true, all certificate errors will be ignored.
}

SetIgnoreCertificateErrorsParams enable/disable whether all certificate errors should be ignored.

func SetIgnoreCertificateErrors

func SetIgnoreCertificateErrors(ignore bool) *SetIgnoreCertificateErrorsParams

SetIgnoreCertificateErrors enable/disable whether all certificate errors should be ignored.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#method-setIgnoreCertificateErrors

parameters:

ignore - If true, all certificate errors will be ignored.

func (*SetIgnoreCertificateErrorsParams) Do

Do executes Security.setIgnoreCertificateErrors against the provided context.

func (SetIgnoreCertificateErrorsParams) MarshalEasyJSON

func (v SetIgnoreCertificateErrorsParams) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (SetIgnoreCertificateErrorsParams) MarshalJSON

func (v SetIgnoreCertificateErrorsParams) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*SetIgnoreCertificateErrorsParams) UnmarshalEasyJSON

func (v *SetIgnoreCertificateErrorsParams) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*SetIgnoreCertificateErrorsParams) UnmarshalJSON

func (v *SetIgnoreCertificateErrorsParams) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type State

type State string

State the security level of a page or resource.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-SecurityState

const (
	StateUnknown        State = "unknown"
	StateNeutral        State = "neutral"
	StateInsecure       State = "insecure"
	StateSecure         State = "secure"
	StateInfo           State = "info"
	StateInsecureBroken State = "insecure-broken"
)

State values.

func (State) MarshalEasyJSON

func (t State) MarshalEasyJSON(out *jwriter.Writer)

MarshalEasyJSON satisfies easyjson.Marshaler.

func (State) MarshalJSON

func (t State) MarshalJSON() ([]byte, error)

MarshalJSON satisfies json.Marshaler.

func (State) String

func (t State) String() string

String returns the State as string value.

func (*State) UnmarshalEasyJSON

func (t *State) UnmarshalEasyJSON(in *jlexer.Lexer)

UnmarshalEasyJSON satisfies easyjson.Unmarshaler.

func (*State) UnmarshalJSON

func (t *State) UnmarshalJSON(buf []byte) error

UnmarshalJSON satisfies json.Unmarshaler.

type StateExplanation

type StateExplanation struct {
	SecurityState    State            `json:"securityState"`             // Security state representing the severity of the factor being explained.
	Title            string           `json:"title"`                     // Title describing the type of factor.
	Summary          string           `json:"summary"`                   // Short phrase describing the type of factor.
	Description      string           `json:"description"`               // Full text explanation of the factor.
	MixedContentType MixedContentType `json:"mixedContentType"`          // The type of mixed content described by the explanation.
	Certificate      []string         `json:"certificate"`               // Page certificate.
	Recommendations  []string         `json:"recommendations,omitempty"` // Recommendations to fix any issues.
}

StateExplanation an explanation of an factor contributing to the security state.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-SecurityStateExplanation

func (StateExplanation) MarshalEasyJSON

func (v StateExplanation) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (StateExplanation) MarshalJSON

func (v StateExplanation) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*StateExplanation) UnmarshalEasyJSON

func (v *StateExplanation) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*StateExplanation) UnmarshalJSON

func (v *StateExplanation) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

type VisibleSecurityState

type VisibleSecurityState struct {
	SecurityState            State                     `json:"securityState"`                      // The security level of the page.
	CertificateSecurityState *CertificateSecurityState `json:"certificateSecurityState,omitempty"` // Security state details about the page certificate.
	SafetyTipInfo            *SafetyTipInfo            `json:"safetyTipInfo,omitempty"`            // The type of Safety Tip triggered on the page. Note that this field will be set even if the Safety Tip UI was not actually shown.
	SecurityStateIssueIDs    []string                  `json:"securityStateIssueIds"`              // Array of security state issues ids.
}

VisibleSecurityState security state information about the page.

See: https://chromedevtools.github.io/devtools-protocol/tot/Security#type-VisibleSecurityState

func (VisibleSecurityState) MarshalEasyJSON

func (v VisibleSecurityState) MarshalEasyJSON(w *jwriter.Writer)

MarshalEasyJSON supports easyjson.Marshaler interface

func (VisibleSecurityState) MarshalJSON

func (v VisibleSecurityState) MarshalJSON() ([]byte, error)

MarshalJSON supports json.Marshaler interface

func (*VisibleSecurityState) UnmarshalEasyJSON

func (v *VisibleSecurityState) UnmarshalEasyJSON(l *jlexer.Lexer)

UnmarshalEasyJSON supports easyjson.Unmarshaler interface

func (*VisibleSecurityState) UnmarshalJSON

func (v *VisibleSecurityState) UnmarshalJSON(data []byte) error

UnmarshalJSON supports json.Unmarshaler interface

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL