Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: recommend base64-subjects-as-file for masked outputs issue #2434

Merged
merged 1 commit into from
Jul 22, 2023

Conversation

behnazh-w
Copy link
Contributor

The GitHub Actions runner sometimes masks the job output if it potentially contains an accessible secret. The new base64-subjects-as-file feature can be recommended to pass the artifact hashes using an existing file and bypass the job output masking issue.

See this discussion: https:/orgs/community/discussions/37942

@@ -98,7 +98,7 @@ provenance:
base64-subjects: "${{ needs.build.outputs.hashes }}"
```

The `base64-subjects` input has a maximum length as defined by [ARG_MAX](https://www.in-ulm.de/~mascheck/various/argmax/) on the runner. If you need to attest to a large number of files that exceeds the maximum length, use the `base64-subjects-as-file` input option instead. This option requires that you save the ouput of the sha256sum command into a file:
The `base64-subjects` input has a maximum length as defined by [ARG_MAX](https://www.in-ulm.de/~mascheck/various/argmax/) on the runner. If you need to attest to a large number of files that exceeds the maximum length, use the `base64-subjects-as-file` input option instead. Another usecase for this option is when GitHub Actions runner masks the job output because it detects a secret (see the discussion [here](https:/orgs/community/discussions/37942)). This option requires that you save the output of the sha256sum command into a file:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The `base64-subjects` input has a maximum length as defined by [ARG_MAX](https://www.in-ulm.de/~mascheck/various/argmax/) on the runner. If you need to attest to a large number of files that exceeds the maximum length, use the `base64-subjects-as-file` input option instead. Another usecase for this option is when GitHub Actions runner masks the job output because it detects a secret (see the discussion [here](https:/orgs/community/discussions/37942)). This option requires that you save the output of the sha256sum command into a file:
The `base64-subjects` input has a maximum length as defined by [ARG_MAX](https://www.in-ulm.de/~mascheck/various/argmax/) on the runner. If you need to attest to a large number of files that exceeds the maximum length, use the `base64-subjects-as-file` input option instead. Another use case for this option is when GitHub Actions runner masks the job output because it detects a secret (see the discussion [here](https:/orgs/community/discussions/37942)). This option requires that you save the output of the sha256sum command into a file:

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we could also add an entry to the "Known Issues" section for issue masking that recommends this solution.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added in commit 4eacceb.

@behnazh-w behnazh-w force-pushed the behnazh/generic-docs branch 2 times, most recently from 3c5f5c9 to 4eacceb Compare July 21, 2023 01:24
Copy link
Collaborator

@laurentsimon laurentsimon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @behnazh-w !

@laurentsimon laurentsimon enabled auto-merge (squash) July 21, 2023 15:33
@laurentsimon
Copy link
Collaborator

Can you rebase?

The GitHub Actions runner sometimes masks the job output if it potentially contains an accessible secret. The new `base64-subjects-as-file` feature can be recommended to pass the artifact hashes using an existing file and bypass the job output masking issue.

See this discussion: https:/orgs/community/discussions/37942

Signed-off-by: behnazh-w <[email protected]>
auto-merge was automatically disabled July 22, 2023 06:02

Head branch was pushed to by a user without write access

@laurentsimon laurentsimon enabled auto-merge (squash) July 22, 2023 23:34
@laurentsimon laurentsimon merged commit 49e60e4 into slsa-framework:main Jul 22, 2023
74 checks passed
enteraga6 pushed a commit to enteraga6/slsa-github-generator that referenced this pull request Aug 8, 2023
…a-framework#2434)

The GitHub Actions runner sometimes masks the job output if it
potentially contains an accessible secret. The new
`base64-subjects-as-file` feature can be recommended to pass the
artifact hashes using an existing file and bypass the job output masking
issue.

See this discussion: https:/orgs/community/discussions/37942

Signed-off-by: behnazh-w <[email protected]>
Signed-off-by: Noah Elzner <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants