Skip to content

Conversation

crandmck
Copy link
Collaborator

@crandmck crandmck commented Apr 1, 2025

There was info on signing and certs in several different places. This PR consolidates and reorganizes it with some edits and clarifications:

New/reorganized pages:

@crandmck crandmck marked this pull request as draft April 1, 2025 23:13
Copy link

github-actions bot commented Apr 1, 2025

@github-actions github-actions bot temporarily deployed to pull request April 1, 2025 23:14 Inactive
@github-actions github-actions bot temporarily deployed to pull request April 3, 2025 21:00 Inactive
@github-actions github-actions bot temporarily deployed to pull request April 3, 2025 23:10 Inactive
@github-actions github-actions bot temporarily deployed to pull request April 3, 2025 23:22 Inactive
@crandmck crandmck requested a review from mauricefisher64 April 4, 2025 17:21
@github-actions github-actions bot temporarily deployed to pull request April 4, 2025 17:22 Inactive
@crandmck crandmck marked this pull request as ready for review April 4, 2025 20:47
@github-actions github-actions bot temporarily deployed to pull request April 9, 2025 19:21 Inactive
@github-actions github-actions bot temporarily deployed to pull request April 16, 2025 18:05 Inactive
@github-actions github-actions bot temporarily deployed to pull request April 16, 2025 20:10 Inactive

Where `mycerts.pub` is the file containing the certificate chain from signing certificate to the last certificate before the root CA, concatenated.

This command produces a text summary of the certificate properties, as shown in the example below. Look for a line containing `Signature Algorithm`. The public key indicates the signature algorithm used. See the table in [Getting a certificate](get-cert.md#signature-types) to determine the corresponding signature type.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Look for a line containing Signature Algorithm.

should be

Look for a line containing Public Key Algorithm

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Yeah, sorry I just noticed this and fixed it.

@github-actions github-actions bot temporarily deployed to pull request April 17, 2025 16:16 Inactive

This command produces a text summary of the certificate properties, as shown in the example below. Look for a line containing `Signature Algorithm`. The public key indicates the signature algorithm used. See the table in [Getting a certificate](get-cert.md#signature-types) to determine the corresponding signature type.

For this example with a certificate issued by GlobalSign, `Signature Algorithm: sha256WithRSAEncryption` corresponds to the PS256 signature type.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Signature Algorithm: sha256WithRSAEncryption

should be
'Public Key Algorithm: rsassaPss' with PSS parameter 'Hash Algorithm: SHA2-256'

Copy link
Collaborator Author

@crandmck crandmck Apr 17, 2025

Choose a reason for hiding this comment

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

I fixed that already as well, basically right as you commented. Small difference: I used the literal text from the table in https://deploy-preview-207--cai-open-source.netlify.app/docs/signing/get-cert#signature-types, so:

RSASSA-PSS with SHA-256

Instead of

RSASSA-PSS with PSS parameter 'Hash Algorithm: SHA2-256

If you prefer, I can change both to be the latter.

@crandmck crandmck merged commit f7d3c3a into main Apr 18, 2025
3 checks passed
@crandmck crandmck deleted the general-reorg branch April 18, 2025 21:42
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.

2 participants