{"id":29170177,"url":"https://github.com/manifoldco/grafton","last_synced_at":"2026-03-06T07:31:26.903Z","repository":{"id":49261111,"uuid":"87435084","full_name":"manifoldco/grafton","owner":"manifoldco","description":"Manifold's provider validation tool","archived":false,"fork":false,"pushed_at":"2021-06-21T13:45:49.000Z","size":1099,"stargazers_count":9,"open_issues_count":8,"forks_count":3,"subscribers_count":25,"default_branch":"master","last_synced_at":"2025-08-09T17:54:55.070Z","etag":null,"topics":["cli","go","golang","rest"],"latest_commit_sha":null,"homepage":"https://www.manifold.co/partners","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manifoldco.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2017-04-06T13:54:27.000Z","updated_at":"2022-08-15T13:12:46.000Z","dependencies_parsed_at":"2022-09-15T16:40:45.775Z","dependency_job_id":null,"html_url":"https://github.com/manifoldco/grafton","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/manifoldco/grafton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldco%2Fgrafton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldco%2Fgrafton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldco%2Fgrafton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldco%2Fgrafton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manifoldco","download_url":"https://codeload.github.com/manifoldco/grafton/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldco%2Fgrafton/sbom","scorecard":{"id":615121,"data":{"date":"2025-08-11","repo":{"name":"github.com/manifoldco/grafton","commit":"20c26bcbf0f5e42a2e9b19b698172c1ad85c7e03"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.6,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/auto-approve.yml:1","Warn: no topLevel permission defined: .github/workflows/go.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":3,"reason":"dependency not pinned by hash detected -- score normalized to 3","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/auto-approve.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/manifoldco/grafton/auto-approve.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/manifoldco/grafton/go.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/manifoldco/grafton/go.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/go.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/manifoldco/grafton/go.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/go.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/manifoldco/grafton/go.yml/master?enable=pin","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   1 out of   1 goCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.md:0","Info: FSF or OSI recognized license: BSD 3-Clause \"New\" or \"Revised\" License: LICENSE.md:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.16.2 not signed: https://api.github.com/repos/manifoldco/grafton/releases/25779842","Warn: release artifact v0.16.1 not signed: https://api.github.com/repos/manifoldco/grafton/releases/25627631","Warn: release artifact v0.16.0 not signed: https://api.github.com/repos/manifoldco/grafton/releases/25544551","Warn: release artifact v0.15.2 not signed: https://api.github.com/repos/manifoldco/grafton/releases/19299222","Warn: release artifact v0.16.2 does not have provenance: https://api.github.com/repos/manifoldco/grafton/releases/25779842","Warn: release artifact v0.16.1 does not have provenance: https://api.github.com/repos/manifoldco/grafton/releases/25627631","Warn: release artifact v0.16.0 does not have provenance: https://api.github.com/repos/manifoldco/grafton/releases/25544551","Warn: release artifact v0.15.2 does not have provenance: https://api.github.com/repos/manifoldco/grafton/releases/19299222"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"22 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2022-0229 / GHSA-cjjc-xp8v-855w","Warn: Project is vulnerable to: GO-2020-0012 / GHSA-ffhg-7mh4-33c4","Warn: Project is vulnerable to: GO-2021-0227 / GHSA-3vm4-22fp-5rfm","Warn: Project is vulnerable to: GO-2022-0968 / GHSA-gwc9-m7rh-j2ww","Warn: Project is vulnerable to: GO-2021-0356 / GHSA-8c26-wmh5-6g9v","Warn: Project is vulnerable to: GO-2024-2961","Warn: Project is vulnerable to: GO-2023-2402 / GHSA-45x7-px36-x8w8","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2022-0236 / GHSA-h86h-8ppg-mxmh","Warn: Project is vulnerable to: GO-2021-0238 / GHSA-83g2-8m93-v3w7","Warn: Project is vulnerable to: GO-2022-0288","Warn: Project is vulnerable to: GO-2022-0969 / GHSA-69cg-p879-7622","Warn: Project is vulnerable to: GO-2022-1144 / GHSA-xrjj-mj9h-534m","Warn: Project is vulnerable to: GO-2023-1571 / GHSA-vvpx-j8f3-3w6h","Warn: Project is vulnerable to: GO-2023-1988 / GHSA-2wrh-6pvc-2jm9","Warn: Project is vulnerable to: GO-2023-2102 / GHSA-4374-p667-p6c8","Warn: Project is vulnerable to: GHSA-qppj-fm5r-hxr3","Warn: Project is vulnerable to: GO-2024-2687 / GHSA-4v7x-pqxf-cx7m","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T03:43:07.004Z","repository_id":49261111,"created_at":"2025-08-21T03:43:07.004Z","updated_at":"2025-08-21T03:43:07.004Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30165617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T04:43:31.446Z","status":"ssl_error","status_checked_at":"2026-03-06T04:40:30.133Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli","go","golang","rest"],"created_at":"2025-07-01T12:39:19.655Z","updated_at":"2026-03-06T07:31:26.885Z","avatar_url":"https://github.com/manifoldco.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![grafton](.github/grafton.png)\n\n**Manifold's provider validation tool**\n\n[Manifold's Provider Documentation](https://provider-api-docs.manifold.co/?tab=provider) |\n[Code of Conduct](./.github/CONDUCT.md) |\n[Contribution Guidelines](./.github/CONTRIBUTING.md) |\n[CHANGELOG](./CHANGELOG.md)\n\n[![GitHub release](https://img.shields.io/github/tag/manifoldco/grafton.svg?label=latest)](https://github.com/manifoldco/grafton/releases)\n[![GoDoc](https://img.shields.io/badge/godoc-reference-blue.svg)](https://godoc.org/github.com/manifoldco/grafton)\n[![Travis](https://img.shields.io/travis/manifoldco/grafton/master.svg)](https://travis-ci.org/manifoldco/grafton)\n[![Go Report Card](https://goreportcard.com/badge/github.com/manifoldco/grafton)](https://goreportcard.com/report/github.com/manifoldco/grafton)\n[![License](https://img.shields.io/badge/license-BSD-blue.svg)](./LICENSE.md)\n\n\u003c/div\u003e\n\nThe [Manifold's Provider Documentation](https://provider-api-docs.manifold.co/?tab=provider) is\nthe best place to get started on adding your product to the Manifold's Marketplace.\n\n## Introduction\n\nGrafton is a super simple CLI tool used by service providers (and Manifold) to\ntest their integrations with Manifold.\n\nUsing this CLI tool, a provider can test the following:\n\n- Provisioning/Deprovisioning of Resources\n- Provisioning/Deprovisioning of Credentials\n- Rotation of Credentials\n- Resizing of Resources\n- Pulling [Resource Measures](#excluding-features) (optional)\n\nRequests generated by Grafton are the exact same shape and style as those made\nby the Provisioning service. Using this tool, a provider should be able to\nimplement and test their integration without needing real requests from Manifold.\n\n## Installation\n\nPrecompiled binaries are build for each release of Grafton for the following\nplatforms:\n- `linux / amd64`\n- `darwin (macos) / amd64`\n- `windows / amd64`\n\nThe zip files of these binaries are in the downloads section of each release\n(i.e. the\n[latest release](https://github.com/manifoldco/grafton/releases/latest)).\n\nTo install, download and unzip the appropriate binary for your system, and run\nthe `grafton` program inside. You may want to add it to a directory in your\n`PATH` for ease of use.\n\n## Usage\n\n1. **Generate Keypair**\n\nTo use, a provider must generate a local public keypair used for signing\nephemereal live keypairs. This allows `Grafton` to generate and sign requests\nusing the same algorithms as Manifold.\n\n```\n$ grafton generate\n```\n\nWhen a keypair is generated it will be written to a `masterkey.json` file in\nthe current working directory.\n\nThe public key contained in this file can be used by the implemented service\nto verify the authenticity of the requests made by Grafton\n\n\n2. **Run Tests**\n\nNow that a key has been generated, you can run the tests which will provision a\nresource, create credentials, create another set of credentials, and then\ndeprovision those before resizing the resource. Finally, Grafton will\ndeprovision the resource.\n\n```\ngrafton test --product=bonnets --plan=small --region=aws::us-east-1 \\\n    --client-id=21jtaatqj8y5t0kctb2ejr6jev5w8 \\\n    --client-secret=3yTKSiJ6f5V5Bq-kWF0hmdrEUep3m3HKPTcPX7CdBZw \\\n    --connector-port=3001 \\\n    --new-plan=large \\\n    http://localhost:4567\n```\n\n![Grafton test output](.github/grafton-test-output.png)\n\n3. **Mini-Marketplace Connector API**\n\nGrafton provides a simple version of Manifold Marketplace that allows to test provision, deprovision and SSO manually.\n\n```\ngrafton serve --product=bonnets --plan=simple-hood --region=east-coast --provider-api=http://yourlocalserver/v1\n```\n\n### Excluding Features\n\nWhen testing it is possible to exclude of one more features from being run. To\ndisable Resource Measures and Resize, for example, you can pass:\n`--exclude resource-measures --exclude plan-change`.\n\nA full list of available tests you can exclude (which is all of them):\n- `cleanup`\n- `credentials`\n- `resource-measures`\n- `provision`\n- `plan-change`\n- `sso`\n- `credential-rotation`\n\n_Note_ : resource-measures is a test you are ONLY required to pass if you are using metered pricing. If you are not, you can exclude it.\n\n## Developing\n\n### Backward compatibility\n\nWe strongly enforce Grafton changes to be backward compatible, which means changes\nto the API should not break existing clients. If a breaking change is necessary, it\nshould be done either as a new endpoint or a new spec version, eg: v2.\n\nIn order to guarantee compatibility, we expect any API change to also be implemented\nfor our [go example client](https://github.com/manifoldco/go-sample-provider) first,\nbefore the change can be approved in Grafton. Our CI takes cares of getting the latest\nversion of the client and test against the new changes.\n\n### OpenAPI spec\n\n`provider.yaml` is a manual copy of an internally generated file. It, in\nturn, is used to generate the client code under `generated`.\n\nUntil we automate more of this, the following has to be kept in mind:\n- Any changes to `provider.yaml` should not be merged here directly, but\n  instead ported to the internal file first.\n- If the internal source of `provider.yaml` changes, the updates must be brought\n  over here.\n- Whenever `provider.yaml` changes, `make generated-clients` should be run, and the\n  changes to the generated code should be checked in.\n\n### Releasing\n\nReleasing grafton uses [promulgate](https://github.com/manifoldco/promulgate).\n\n1. Ensure all of the required code has been merged into master.\n2. Determine whether or not the `CHANGELOG.md` is up to date and correct for\n   this release, if it's not, update it!\n3. Create a tag off master (following [semver](http://semver.org/)), which\n   includes the up to date `CHANGELOG.md` (and matches the remote sha of master\n   on github).\n4. Done! Promulgate via Travis will take care of creating the binaries and\n   uploading the zip files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanifoldco%2Fgrafton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanifoldco%2Fgrafton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanifoldco%2Fgrafton/lists"}