Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sigstore/k8s-manifest-sigstore
kubectl plugin for signing Kubernetes manifest YAML files with sigstore
https://github.com/sigstore/k8s-manifest-sigstore
Last synced: 20 days ago
JSON representation
kubectl plugin for signing Kubernetes manifest YAML files with sigstore
- Host: GitHub
- URL: https://github.com/sigstore/k8s-manifest-sigstore
- Owner: sigstore
- License: apache-2.0
- Created: 2021-06-23T08:52:03.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-19T13:16:13.000Z (8 months ago)
- Last Synced: 2024-04-19T14:37:43.864Z (8 months ago)
- Language: Go
- Homepage:
- Size: 16.9 MB
- Stars: 77
- Watchers: 9
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-software-supply-chain-security - k8s-manifest-sigstore -  - kubectl plugin for signing Kubernetes manifest YAML files with sigstore (Signing Artefacts)
README
# k8s-manifest-sigstore
===============
[](https://slsa.dev/)
kubectl plugin for signing Kubernetes manifest YAML files with sigstore
> :warning: Still under developement, not ready for production use yet!
This kubectl subcommand plugin enables developer to sign k8s manifest yaml files and deployment teams to verify the authenticity of configurations. Not only is this possible for developers to sign and verify, but the integrity of deployed manifests can be confirmed on a k8s cluster.
## Installation
The plugin is a standalone executable file `kubectl-sigstore`.
You can install it just by a single command.
```
go install github.com/sigstore/k8s-manifest-sigstore/cmd/kubectl-sigstore@latest
```
Or you can find the pre-built executables in the release page too.
To build it from source codes, run the following.
```
git clone [email protected]:sigstore/k8s-manifest-sigstore.git
cd k8s-manifest-sigstore
make
```
You will find new file `kubectl-sigstore`.
To install the plugin, move this executable file to any location on your PATH.
## Usage (bundle image on OCI registry)
```
Usage:
kubectl sigstore [flags]
kubectl sigstore [command]
Available Commands:
apply-after-verify A command to apply Kubernetes YAML manifests only after verifying signature
sign A command to sign Kubernetes YAML manifests
verify A command to verify Kubernetes YAML manifests
verify-resource A command to verify Kubernetes manifests of resources on cluster
```
### Sign k8s yaml manifest files as bundle OCI image
K8s YAML files are bundled as image, and then pushed to OCI registory. Then, it is signed with cosign. A bundle image reference is added in metadata.annotations in manifest yaml by default.
`kubectl sigstore sign -f foo.yaml --image bundle-bar:dev`
Inserting annotation can be disabled by adding `--annotation-metadata=false` option. (If annotation is not added, `--image` option must be supplied when verifying signature.)
`kubectl sigstore sign -f foo.yaml --image bundle-bar:dev --annotation-metadata=false`
### Verify a k8s yaml manifest file
`kubectl sigstore verify -f foo.yaml`
An image reference can be supplied with command option.
`kubectl sigstore verify -f foo.yaml --image bundle-bar:dev`
### Create resource with a k8s yaml manifest file after verifying signature
`kubectl sigstore apply-after-verify -f foo.yaml -n ns1`
### Verify a k8s yaml manifest of deployed resource with signature
`kubectl sigstore verify-resource cm foo -n ns1`
Commands
```
Usage:
kubectl sigstore sign -f FILENAME [-i IMAGE] [flags]
Flags:
-a, --annotation stringArray extra key=value pairs to sign
--annotation-metadata whether to update annotation and generate signed yaml file (default true)
-A, --append-signature if true, keep the existing signatures and append the new one to the annotation like "signature_1" or "signature_2"
-f, --filename string file name which will be signed (if dir, all YAMLs inside it will be signed)
-h, --help help for sign
-i, --image string image name which bundles yaml files and be signed
-k, --key string path to your signing key (if empty, do key-less signing)
-o, --output string output file name or k8s signature configmap reference (if empty, use ".signed")
--replace-signature just to clarify the default mode of signature storing. If false, "append-signature" is enabled automatically (default true)
--tarball string whether to make a tarball for signing (this will be default to "no" in v0.5.0+) (default "yes")
```
```
Usage:
kubectl sigstore verify -f FILENAME [-i IMAGE] [flags]
Flags:
-c, --config string path to verification config YAML file (for advanced verification)
-f, --filename string file name which will be verified
-h, --help help for verify
-i, --image string a comma-separated list of signed image names that contains YAML manifests
-k, --key string a comma-separated list of paths to public keys or environment variable names start with "env://" (if empty, do key-less verification)
```
```
Usage:
kubectl sigstore apply-after-verify -f FILENAME [-i IMAGE] [flags]
Flags:
-c, --config string path to verification config YAML file (for advanced verification)
-f, --filename string file name which will be verified and applied
-h, --help help for apply-after-verify
-i, --image string a comma-separated list of signed image names that contains YAML manifests
-k, --key string a comma-separated list of paths to public keys or environment variable names start with "env://" (if empty, do key-less verification)
```
```
Usage:
kubectl-sigstore verify-resource (RESOURCE/NAME | -f FILENAME | -i IMAGE) [flags]
Flags:
-c, --config string path to verification config YAML file (for advanced verification)
--disable-default-config if true, disable default ignore fields configuration (default to false)
-f, --filename string manifest filename (this can be "-", then read a file from stdin)
-h, --help help for verify-resource
-i, --image string a comma-separated list of signed image names that contains YAML manifests
-k, --key string a comma-separated list of paths to public keys or environment variable names start with "env://" (if empty, do key-less verification)
-o, --output string output format string, either "json" or "yaml" (if empty, a result is shown as a table)
```
### SLSA Provenance
This project generates a SLSA provenance on its release! This enables you to verify the integrity
of the downloaded artifacts and ensure that the binary's code really comes from this source code.
To do so, please follow the instructions [here](https://github.com/slsa-framework/slsa-github-generator#verification-of-provenance).
### Kyverno Integration
[Kyverno](https://main.kyverno.io/) is an open-source policy engine designed for Kubernetes resources.
It has the built-in feature to verify signed Kubernetes YAML manifests created with k8s-manifest-sigstore project.
Please refer to the [document](https://main.kyverno.io/docs/writing-policies/validate/#manifest-validation) for more details.
## Security
Should you discover any security issues, please refer to sigstore'ss [security
process](https://github.com/sigstore/community/blob/main/SECURITY.md)
## Info
`k8s-manifest-sigstore` is developed as part of the [`sigstore`](https://sigstore.dev) project.
We also use a [slack channel](https://sigstore.slack.com)!
Click [here](https://join.slack.com/t/sigstore/shared_invite/zt-mhs55zh0-XmY3bcfWn4XEyMqUUutbUQ) for the invite link.