Skip to content

Security: ASK-03/docs

Security

SECURITY.md

Security Policy

We are very grateful to the security researchers and users that report back Layer5 project security vulnerabilities. We investigate every report thoroughly.

Reporting a vulnerability

To make a report, send an email to the private [email protected] mailing list with the vulnerability details. For normal product bugs unrelated to latent security vulnerabilities, please head to the appropriate repository and submit a new issue.

When to report a security vulnerability?

Send us a report whenever you:

  • Think Layer5 projects have a potential security vulnerability.
  • Are unsure whether or how a vulnerability affects Layer5 projects.
  • Think a vulnerability is present in another project that Layer5 projects depend on (Docker for example).

When not to report a security vulnerability?

Don't send a vulnerability report if:

  • You need help tuning Layer5 project components for security.
  • You need help applying security related updates.
  • Your issue is not security related.

Evaluation

The Layer5 team acknowledges and analyzes each vulnerability report within 10 working days.

Any vulnerability information you share with the Layer5 team stays within the Layer5 project. We don't disseminate the information to other projects. We only share the information as needed to fix the issue.

We keep the reporter updated as the status of the security issue is addressed.

Fixing the issue

Once a security vulnerability has been fully characterized, a fix is developed by the Layer5 team. The development and testing for the fix happens in a private GitHub repository in order to prevent premature disclosure of the vulnerability.

Early disclosure

The Layer5 team maintains a mailing list for private early disclosure of security vulnerabilities. The list is used to provide actionable information to close Layer5 partners. The list is not intended for individuals to find out about security issues.

Public disclosure

On the day chosen for public disclosure, a sequence of activities takes place as quickly as possible:

  • Changes are merged from the private GitHub repository holding the fix into the appropriate set of public branches.
  • Layer5 team ensures all necessary binaries are promptly built and published.
  • Once the binaries are available, an announcement is sent out on the following channels:

As much as possible this announcement will be actionable, and include any mitigating steps customers can take prior to upgrading to a fixed version.

There aren’t any published security advisories