java.lang.Object
- Torello.Browser.Security

```
public class Security
extends java.lang.Object
```
Class created by Automatic Code-Generator.
This class was built using the Chrome Remote Dev-Tools A.P.I., which is specified by two JSON-RPC Files. These files were obtained from the Chrome Dev Tools Protocol Git Hub Page, which has a "Tip of Tree" (the latest) API-Specification Page Here: JSON-RPC Protocol Specification.

JSON-Viewable Google-API:
These files may be viewed here: browser_protocol.json and js_protocol.json.
These files were converted into this Java-Browser (CDT) Library; they are a Java-Alternative to the Node.js implementation.

HTML-Viewable API:
In addition to this Class-Library, these files were also converted to a simple HTML Page, which may be browsed here: Browser API Web-Page

Node.js RDP-API Implementation:
You may read about the Node.js Chrome Remote Interface on the Node.js Package Manager Web-Site: NPM
Security
This class is intended to be used with a Headless Browser
These methods have been tested, to some degree, using Google Chrome. In order to use this class you must start a web-browser instance and make a connection to the browser using a Remote Debugging Port. The initializations may be accomplished using class BRDPC (Browser Remote Debug Protocol Connection).

Google-Chrome was used during the development process of the classes in this particular package. Note that, lately, it has been asserted Microsoft has switched to using the Chrome-Engine for its Microsoft Edge Browser Internal Code-Base. Therefore, there may limited support / functionality when running the methods in this class with Microsoft-Edge. There is the possibility these will work with Opera & Safari.

Check whether the your Web-Browser will allow itself to be driven by the Web-Socket RDP-Port 9223.

Foreign Function API:
Every one of the methods that reside in this class are designed to do nothing more than:
1. Accept Parameters from the User, and "Marshall Them" into a Valid JSON-Request
2. Transmit the Marshalled Request-JSON to a Headless Web-Browser over a Web-Socket RDP Connection
3. Receive BOTH that Method's Results AND any Browser Event-Firings from the Web-Socket
4. Parse JSON Method-Results and Browser-Event Firings, and Subsequently Convert them to Standard Java-Types
5. Report these Method-Results and Browser-Events to the User via an User-Registered Event-Listener or a Promise Object
Java-HTML Difference:
Unlike the bulk of the Java HTML JAR Library, there is very little native Java-Code, and very little testing that may be done on any of the classes & methods in this package. The code inside these classes does nothing more than marshall-and-unmarshall Java-Types into Json-Requests (and vice-versa). The Java-Script & Browser modules inside of a Google-Chrome instance are, theoretically, handling these requests, and returning their results (or events) over the Web-Socket Connection.

It has been asserted (by Google Chrome Developers) that some of these methods are only "partially working" or "experimental".
Hi-Lited Source-Code:
- View Here: Torello/Browser/Security.java
- Open New Browser-Tab: Torello/Browser/Security.java
File Size: 57,032 Bytes Line Count: 1,315 '\n' Characters Found
Stateless Class:
This class neither contains any program-state, nor can it be instantiated. The @StaticFunctional Annotation may also be called 'The Spaghetti Report'. Static-Functional classes are, essentially, C-Styled Files, without any constructors or non-static member fields. It is a concept very similar to the Java-Bean's @Stateless Annotation.
- 1 Constructor(s), 1 declared private, zero-argument constructor
- 5 Method(s), 5 declared static
- 9 Field(s), 9 declared static, 8 declared final
- Fields excused from final modifier (with explanation):
  
  Field 'counter' is not final. Reason: CONFIGURATION

Nested Class Summary

Type Classes: Security Domain Types

Modifier and Type	Class	Description
`static class`	`Security.CertificateSecurityState`	Details about the security state of the page certificate.
`static class`	`Security.InsecureContentStatus`	Information about insecure content on the page.
`static class`	`Security.SafetyTipInfo`	`[No Description Provided by Google]` EXPERIMENTAL
`static class`	`Security.SecurityStateExplanation`	An explanation of an factor contributing to the security state.
`static class`	`Security.VisibleSecurityState`	Security state information about the page.

Event Classes: Security Domain Events
Modifier and Type	Class	Description
`static class`	`Security.certificateError`	There is a certificate error.
`static class`	`Security.securityStateChanged`	The security state of the page changed.
`static class`	`Security.visibleSecurityStateChanged`	The security state of the page changed.

Field Summary

Security Domain Enumerated String Types

Modifier and Type	Field	Description
`static String[]`	`CertificateErrorAction`	The action to take when a certificate error occurs.
`static String[]`	`MixedContentType`	A description of mixed content (HTTP resources on HTTPS pages), as defined by https://www.w3.org/TR/mixed-content/#categories
`static String[]`	`SafetyTipStatus`	`[No Description Provided by Google]` EXPERIMENTAL
`static String[]`	`SecurityState`	The security level of a page or resource.

Method Summary

Security Domain Commands

Script Returns	Modifier and Type	Method	Description
NONE (`void`)	`static Script<>`	`disable()` Disables tracking security state changes.
NONE (`void`)	`static Script<>`	`enable()` Enables tracking security state changes.
NONE (`void`)	`static Script<>`	`handleCertificateError(int eventId, String action)` Handles a certificate error that fired a certificateError event.
NONE (`void`)	`static Script<>`	`setIgnoreCertificateErrors(boolean ignore)` Enable/disable whether all certificate errors should be ignored.
NONE (`void`)	`static Script<>`	`setOverrideCertificateErrors(boolean override)` Enable/disable overriding certificate errors.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MixedContentType
    
    🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static final java.lang.String[] MixedContentType
    
    A description of mixed content (HTTP resources on HTTPS pages), as defined by https://www.w3.org/TR/mixed-content/#categories
    
    Code:
    
    Exact Field Declaration Expression:
    
    public static final String[] MixedContentType = { "blockable", "optionally-blockable", "none", };
  - SecurityState
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static final java.lang.String[] SecurityState
    
    The security level of a page or resource.
    
    Code:
    
    Exact Field Declaration Expression:
    
    public static final String[] SecurityState = { "unknown", "neutral", "insecure", "secure", "info", "insecure-broken", };
  - SafetyTipStatus
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static final java.lang.String[] SafetyTipStatus
    
    [No Description Provided by Google]
    
    EXPERIMENTAL
    
    Code:
    
    Exact Field Declaration Expression:
    
    public static final String[] SafetyTipStatus = { "badReputation", "lookalike", };
  - CertificateErrorAction
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static final java.lang.String[] CertificateErrorAction
    
    The action to take when a certificate error occurs. continue will continue processing the request and cancel will cancel the request.
    
    Code:
    
    Exact Field Declaration Expression:
    
    public static final String[] CertificateErrorAction = { "continue", "cancel", };
- Method Detail
  - disable
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static Script<java.lang.String,JsonObject,Ret0> disable()
    
    Disables tracking security state changes.
    
    Returns:
    
    An instance of Script<String, JsonObject, Ret0>
    
    This Script instance must be executed before the browser receives the invocation-request.
    
    This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.
  - enable
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static Script<java.lang.String,JsonObject,Ret0> enable()
    
    Enables tracking security state changes.
    
    Returns:
    
    An instance of Script<String, JsonObject, Ret0>
    
    This Script instance must be executed before the browser receives the invocation-request.
    
    This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.
  - setIgnoreCertificateErrors
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static Script<java.lang.String,JsonObject,Ret0> setIgnoreCertificateErrors (boolean ignore)
    
    Enable/disable whether all certificate errors should be ignored.
    EXPERIMENTAL
    
    Parameters:
    
    ignore - If true, all certificate errors will be ignored.
    
    Returns:
    
    An instance of Script<String, JsonObject, Ret0>
    
    This Script instance must be executed before the browser receives the invocation-request.
    
    This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.
  - handleCertificateError
    
    🡅 🡇 ⇈ ⮫ 🗕 🗗 🗖
    public static Script<java.lang.String,JsonObject,Ret0> handleCertificateError (int eventId, java.lang.String action)
    
    Handles a certificate error that fired a certificateError event.
    DEPRECATED
    
    Parameters:
    
    eventId - The ID of the event.
    
    action - The action to take on the certificate error.
    
    Returns:
    
    An instance of Script<String, JsonObject, Ret0>
    
    This Script instance must be executed before the browser receives the invocation-request.
    
    This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.
  - setOverrideCertificateErrors
    
    🡅 ⇈ ⮫ 🗕 🗗 🗖
    public static Script<java.lang.String,JsonObject,Ret0> setOverrideCertificateErrors (boolean override)
    
    Enable/disable overriding certificate errors. If enabled, all certificate error events need to be handled by the DevTools client and should be answered with handleCertificateError commands.
    DEPRECATED
    
    Parameters:
    
    override - If true, certificate errors will be overridden.
    
    Returns:
    
    An instance of Script<String, JsonObject, Ret0>
    
    This Script instance must be executed before the browser receives the invocation-request.
    
    This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

Fields
String[]	CertificateErrorAction
String[]	MixedContentType
String[]	SafetyTipStatus
String[]	SecurityState
Methods
Script	disable()
Script	enable()
Script	handleCertificateError(int eventId, String action)
Script	setIgnoreCertificateErrors(boolean ignore)
Script	setOverrideCertificateErrors(boolean override)

Class Security

This class is intended to be used with a Headless Browser

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MixedContentType

SecurityState

SafetyTipStatus

CertificateErrorAction

Method Detail

disable

enable

setIgnoreCertificateErrors

handleCertificateError

setOverrideCertificateErrors