README
¶
Contrast
Contrast runs confidential container deployments on Kubernetes at scale.
Contrast is based on the Kata Containers and Confidential Containers projects. Confidential Containers are Kubernetes pods that are executed inside a confidential micro-VM and provide strong hardware-based isolation from the surrounding environment. This works with unmodified containers in a lift-and-shift approach. Contrast currently targets the CoCo preview on AKS.
Goal
Contrast is designed to keep all data always encrypted and to prevent access from the infrastructure layer. It removes the infrastructure provider from the trusted computing base (TCB). This includes access from datacenter employees, privileged cloud admins, own cluster administrators, and attackers coming through the infrastructure, for example, malicious co-tenants escalating their privileges.
Contrast integrates fluently with the existing Kubernetes workflows. It's compatible with managed Kubernetes, can be installed as a day-2 operation and imposes only minimal changes to your deployment flow.
Use cases
- Increasing the security of your containers
- Moving sensitive workloads from on-prem to the cloud with Confidential Computing
- Shielding the code and data even from your own cluster administrators
- Increasing the trustworthiness of your SaaS offerings
- Simplifying regulatory compliance
- Multi-party computation for data collaboration
Features
🔒 Everything always encrypted
- Runtime encryption: All Pods run inside AMD SEV-based Confidential VMs (CVMs). Support for Intel TDX will be added in the future.
- PKI and mTLS: All pod-to-pod traffic can be encrypted and authenticated with Contrast's workload certificates.
🔍 Everything verifiable
- Workload attestation based on the identity of your container and the remote-attestation feature of Confidential Containers
- "Whole deployment" attestation based on Contrast's Coordinator attestation service
- Runtime environment integrity verification based runtime policies
- Kata micro-VMs and single workload isolation provide a minimal Trusted Computing Base (TCB)
🏝️ Everything isolated
- Runtime policies enforce strict isolation of your containers from the Kubernetes layer and the infrastructure.
- Pod isolation: Pods are isolated from each other.
- Namespace isolation: Contrast can be deployed independently in multiple namespaces.
🧩 Lightweight and easy to use
- Install in Kubernetes cluster as a day-2 operation.
- Compatible with managed Kubernetes.
- Minimal DevOps involvement.
- Simple CLI tool to get started.
Documentation
To learn more, see the documentation. You may want to start with one of the following sections.
Known limitations
See the current list of known limitations in the documentation.
Upcoming Contrast features
- Plugin for a key management service (KMS) for attestation/coordinator certificate-based key release
- High availability (distributed Contrast Coordinator)
Contributing
See the contributing guide. Please follow the Code of Conduct.
Support
- If something doesn't work, make sure to use the latest release and check out the known issues.
- Please file an issue to get help or report a bug.
- Visit our blog for technical deep-dives and tutorials and follow us on LinkedIn for news.
- Edgeless Systems also offers Enterprise Support.
Directories
¶
| Path | Synopsis |
|---|---|
|
internal/seedengine
Package seedengine provides deterministic key derivation of ECDSA and symmetric keys from a secret seed.
|
Package seedengine provides deterministic key derivation of ECDSA and symmetric keys from a secret seed. |
|
e2e
|
|
|
internal/kubeclient
The kubeclient package provides a simple wrapper around Kubernetes interactions commonly used in the e2e tests.
|
The kubeclient package provides a simple wrapper around Kubernetes interactions commonly used in the e2e tests. |
|
internal
|
|
|
atls
aTLS provides config generation functions to bootstrap attested TLS connections.
|
aTLS provides config generation functions to bootstrap attested TLS connections. |
|
crypto
Package crypto provides functions to for cryptography and random numbers.
|
Package crypto provides functions to for cryptography and random numbers. |
|
embedbin
Package embedbin provides a portable way to install embedded binaries.
|
Package embedbin provides a portable way to install embedded binaries. |
|
grpc/atlscredentials
Package atlscredentials handles creation of TLS credentials for attested TLS (ATLS).
|
Package atlscredentials handles creation of TLS credentials for attested TLS (ATLS). |
|
grpc/dialer
Package dialer provides a grpc dialer that can be used to create grpc client connections with different levels of ATLS encryption / verification.
|
Package dialer provides a grpc dialer that can be used to create grpc client connections with different levels of ATLS encryption / verification. |
|
grpc/retry
Package retry provides functions to check if a gRPC error is retryable.
|
Package retry provides functions to check if a gRPC error is retryable. |
|
logger
Package logger provides a slog.Logger that can be configured via environment variables.
|
Package logger provides a slog.Logger that can be configured via environment variables. |
|
retry
Package retry provides a simple interface for retrying operations.
|
Package retry provides a simple interface for retrying operations. |
|
node-installer
module
|
|
|
service-mesh
module
|