This repository has been archived by the owner on May 26, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
New feature signing/verification of component descriptor [EXPERIMENTAL]: add digests, check digests, sign with rsa private key, verify with rsa public key
- Loading branch information
1 parent
fa7ddfd
commit 7971861
Showing
31 changed files
with
2,059 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
29 changes: 29 additions & 0 deletions
29
docs/reference/component-cli_component-archive_signature.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
## component-cli component-archive signature | ||
|
||
[EXPERIMENTAL] command to work with signatures and digests in component descriptors | ||
|
||
### Options | ||
|
||
``` | ||
-h, --help help for signature | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive](component-cli_component-archive.md) - | ||
* [component-cli component-archive signature add-digests](component-cli_component-archive_signature_add-digests.md) - fetch the component descriptor from an oci registry and add digests | ||
* [component-cli component-archive signature check-digests](component-cli_component-archive_signature_check-digests.md) - fetch the component descriptor from an oci registry and check digests | ||
* [component-cli component-archive signature sign](component-cli_component-archive_signature_sign.md) - command to sign component descriptors | ||
* [component-cli component-archive signature verify](component-cli_component-archive_signature_verify.md) - command to verify the signature of a component descriptor | ||
|
43 changes: 43 additions & 0 deletions
43
docs/reference/component-cli_component-archive_signature_add-digests.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
## component-cli component-archive signature add-digests | ||
|
||
fetch the component descriptor from an oci registry and add digests | ||
|
||
### Synopsis | ||
|
||
|
||
fetch the component descriptor from an oci registry and add digests. Optionally resolve and digest the referenced component descriptors. | ||
|
||
|
||
``` | ||
component-cli component-archive signature add-digests BASE_URL COMPONENT_NAME VERSION [flags] | ||
``` | ||
|
||
### Options | ||
|
||
``` | ||
--allow-plain-http allows the fallback to http if the oci registry does not support https | ||
--cc-config string path to the local concourse config file | ||
--force force overwrite of already existing component descriptors | ||
-h, --help help for add-digests | ||
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure | ||
--recursive recursively upload all referenced component descriptors | ||
--registry-config string path to the dockerconfig.json with the oci registry authentication information | ||
--skip-access-types strings comma separated list of access types that will not be digested | ||
--upload-base-url string target repository context to upload the signed cd | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature](component-cli_component-archive_signature.md) - [EXPERIMENTAL] command to work with signatures and digests in component descriptors | ||
|
34 changes: 34 additions & 0 deletions
34
docs/reference/component-cli_component-archive_signature_check-digests.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
## component-cli component-archive signature check-digests | ||
|
||
fetch the component descriptor from an oci registry and check digests | ||
|
||
``` | ||
component-cli component-archive signature check-digests BASE_URL COMPONENT_NAME VERSION [flags] | ||
``` | ||
|
||
### Options | ||
|
||
``` | ||
--allow-plain-http allows the fallback to http if the oci registry does not support https | ||
--cc-config string path to the local concourse config file | ||
-h, --help help for check-digests | ||
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure | ||
--registry-config string path to the dockerconfig.json with the oci registry authentication information | ||
--skip-access-types strings comma separated list of access types that will be ignored for digest verification | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature](component-cli_component-archive_signature.md) - [EXPERIMENTAL] command to work with signatures and digests in component descriptors | ||
|
26 changes: 26 additions & 0 deletions
26
docs/reference/component-cli_component-archive_signature_sign.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
## component-cli component-archive signature sign | ||
|
||
command to sign component descriptors | ||
|
||
### Options | ||
|
||
``` | ||
-h, --help help for sign | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature](component-cli_component-archive_signature.md) - [EXPERIMENTAL] command to work with signatures and digests in component descriptors | ||
* [component-cli component-archive signature sign rsa](component-cli_component-archive_signature_sign_rsa.md) - fetch the component descriptor from an oci registry and sign it using RSASSA-PKCS1-V1_5-SIGN | ||
|
39 changes: 39 additions & 0 deletions
39
docs/reference/component-cli_component-archive_signature_sign_rsa.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
## component-cli component-archive signature sign rsa | ||
|
||
fetch the component descriptor from an oci registry and sign it using RSASSA-PKCS1-V1_5-SIGN | ||
|
||
``` | ||
component-cli component-archive signature sign rsa BASE_URL COMPONENT_NAME VERSION [flags] | ||
``` | ||
|
||
### Options | ||
|
||
``` | ||
--allow-plain-http allows the fallback to http if the oci registry does not support https | ||
--cc-config string path to the local concourse config file | ||
--force force overwrite of already existing component descriptors | ||
-h, --help help for rsa | ||
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure | ||
--private-key string path to private key file used for signing | ||
--recursive recursively sign and upload all referenced component descriptors | ||
--registry-config string path to the dockerconfig.json with the oci registry authentication information | ||
--signature-name string name of the signature | ||
--skip-access-types strings comma separated list of access types that will not be digested and signed | ||
--upload-base-url string target repository context to upload the signed cd | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature sign](component-cli_component-archive_signature_sign.md) - command to sign component descriptors | ||
|
26 changes: 26 additions & 0 deletions
26
docs/reference/component-cli_component-archive_signature_verify.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
## component-cli component-archive signature verify | ||
|
||
command to verify the signature of a component descriptor | ||
|
||
### Options | ||
|
||
``` | ||
-h, --help help for verify | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature](component-cli_component-archive_signature.md) - [EXPERIMENTAL] command to work with signatures and digests in component descriptors | ||
* [component-cli component-archive signature verify rsa](component-cli_component-archive_signature_verify_rsa.md) - fetch the component descriptor from an oci registry and verify its integrity based on a RSASSA-PKCS1-V1_5-SIGN signature | ||
|
36 changes: 36 additions & 0 deletions
36
docs/reference/component-cli_component-archive_signature_verify_rsa.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
## component-cli component-archive signature verify rsa | ||
|
||
fetch the component descriptor from an oci registry and verify its integrity based on a RSASSA-PKCS1-V1_5-SIGN signature | ||
|
||
``` | ||
component-cli component-archive signature verify rsa BASE_URL COMPONENT_NAME VERSION [flags] | ||
``` | ||
|
||
### Options | ||
|
||
``` | ||
--allow-plain-http allows the fallback to http if the oci registry does not support https | ||
--cc-config string path to the local concourse config file | ||
-h, --help help for rsa | ||
--insecure-skip-tls-verify If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure | ||
--public-key string path to public key file | ||
--registry-config string path to the dockerconfig.json with the oci registry authentication information | ||
--signature-name string name of the signature to verify | ||
--skip-access-types strings comma separated list of access types that will be ignored for verification | ||
``` | ||
|
||
### Options inherited from parent commands | ||
|
||
``` | ||
--cli logger runs as cli logger. enables cli logging | ||
--dev enable development logging which result in console encoding, enabled stacktrace and enabled caller | ||
--disable-caller disable the caller of logs (default true) | ||
--disable-stacktrace disable the stacktrace of error logs (default true) | ||
--disable-timestamp disable timestamp output (default true) | ||
-v, --verbosity int number for the log level verbosity (default 1) | ||
``` | ||
|
||
### SEE ALSO | ||
|
||
* [component-cli component-archive signature verify](component-cli_component-archive_signature_verify.md) - command to verify the signature of a component descriptor | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.