JSDoc: Namespace: cert

# Namespace: cert

## cert

TLS certificate service override management for Marionette.

Source:
  - cert.js, line 30

### Methods

#### (static) InsecureSweepingOverride()

Certificate override service that acts in an all-inclusive manner on TLS certificates.

When an invalid certificate is encountered, it is overriden with the |matching| bit level, which is typically a combination of |cert.Error.Untrusted|, |cert.Error.Mismatch|, and |cert.Error.Time|.

Source:
  - cert.js, line 99

##### Throws:

If there are any problems registering the service.

Type
  Components.Exception

#### (static) installOverride(service)

Installs a TLS certificate service override.

The provided |service| must implement the |register| and |unregister| functions that causes a new |nsICertOverrideService| interface implementation to be registered with the |nsIComponentRegistrar|.

After |service| is registered and made the |cert.currentOverride|, |nsICertOverrideService| is reinitialised to cause all Gecko components to pick up the new service.

If an override is already installed, i.e. when |cert.currentOverride| is not null, this functions acts as a NOOP.

##### Parameters:

Name | Type | Description
--- | --- | ---
`service` | cert.Override | Service generator that registers and unregisters the XPCOM service.

Source:
  - cert.js, line 60

##### Throws:

If unable to register or initialise |service|.

Type
  Components.Exception

#### (static) uninstallOverride()

Uninstall a TLS certificate service override.

After the service has been unregistered, |cert.currentOverride| is reset to null.

If there no current override installed, i.e. if |cert.currentOverride| is null, this function acts as a NOOP.

Source:
  - cert.js, line 78