{"id":18436042,"url":"https://github.com/codenotary/vcn-github-action","last_synced_at":"2025-08-12T01:14:43.067Z","repository":{"id":37948953,"uuid":"393445129","full_name":"codenotary/vcn-github-action","owner":"codenotary","description":"General purpose github action to include the latest vcn binary in github workflows","archived":false,"fork":false,"pushed_at":"2022-06-24T16:34:08.000Z","size":43,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-02-13T12:54:26.767Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codenotary.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-08-06T17:02:54.000Z","updated_at":"2022-06-24T13:11:05.000Z","dependencies_parsed_at":"2023-01-11T17:21:26.038Z","dependency_job_id":null,"html_url":"https://github.com/codenotary/vcn-github-action","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenotary%2Fvcn-github-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenotary%2Fvcn-github-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenotary%2Fvcn-github-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenotary%2Fvcn-github-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codenotary","download_url":"https://codeload.github.com/codenotary/vcn-github-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239115647,"owners_count":19584247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T06:10:00.484Z","updated_at":"2025-02-16T10:24:47.827Z","avatar_url":"https://github.com/codenotary.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vcn-github-action\n\nGeneral-purpose GitHub Action that downloads and enables the usage of the **vcn** tool from Codenotary to perform operations on digital assets.\n\n## How to use it\n\nThere are two ways to use this action:\n\n1. Default **standard_usage: true** -\u003e Uses all inputs.\n2. Optional **standard_usage: false** -\u003e Uses only the version input.\n\n### 1. standard_usage: true\n\nThis will **use all the workflow inputs**, which are:\n\n| Input         | Configuration                                  | Default value   |\n|---------------|------------------------------------------------|-----------------|\n| version       | `vcn` version.                                 | Latest version. |\n| asset         | Digital asset.                                 | No default.     |\n| mode          | `vcn` command.                                 | `n` (notarize)  |\n| cnc_host      | Codenotary Cloud hostname, without `https://`. | No default.     |\n| cnc_grpc_port | Port used to connect to Codenotary Cloud.      | 443             |\n| cnc_api_key   | API key for the ledger.                        | No default.     |\n\n**Recommended**: **[use secrets for the API key](https://docs.github.com/en/actions/security-guides/encrypted-secrets)**\n\n#### Example\n\n```yml\nname: get-vcn\n\non:\n  push:\n    branches: [main]\n\njobs:\n  get-some-other-version-vcn-binary:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Download vcn\n        uses: codenotary/vcn-github-action@v2\n        with:\n            version: v0.9.8\n            cnc_host: codenotary-cnc-url\n            cnc_grpc_port: 443\n            asset: vcn\n            cnc_api_key: ${{secrets.VCN_LC_API_KEY}}\n```\n\n\n### 2. standard_usage: false\n\nThis will download the latest available binary (currently only for Linux) and **use only the version input**, as below:\n\n| Input         | Configuration                                  | Default value   |\n|---------------|------------------------------------------------|-----------------|\n| version       | `vcn` version.                                 | Latest version. |\n\nYou will have to provide the command with options to interact with it.\n\nThis usage allows for more flexibility and options, so we recommend only using this if you're experienced with `vcn` and would like to specify more options than what is available through the **standard_usage: true** mode.\n\n**Example**\n\n```yml\njobs:\n  get-latest-vcn-binary:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout repository\n        uses: actions/checkout@v2\n        with:\n          ref: ${{ github.event.review.commit_id }}\n    \n      # This downloads the vcn binary, no other inputs needed\n      - name: Download vcn\n        uses: codenotary/vcn-github-action@v2\n        with:\n          standard_usage: false\n      # Intermediate steps in which you build, test, scan, etc...\n      ...\n      # Simple notarization, including an attachment  \n      - name: Test vcn binary is available\n        run: ./vcn n my_artifact.jar --lc-host codenotary-cnc-url --lc-port 443 --lc-api-key ${{secrets.my_cnc_api_key}} --attach reports/my_scan_report\n        shell: bash\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenotary%2Fvcn-github-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodenotary%2Fvcn-github-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenotary%2Fvcn-github-action/lists"}