openshift / openshift/cloud-credential-operator

Documentation Bug: AWS STS docs for migrating from public S3 bucket to CloudFront Distribution computes incorrect leaf certificate.

Open Beginner friendly
#1,044 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
75
Forks
196
Avg merge
8d 13h
Merged PRs (30d)
5

Description

For the doc at docs/sts-migrate-to-private-bucket.md covering how one can update an existing OpenShift AWS cluster from using a public S3 bucket to a CloudFront distribution to distribute the required JWKS key there is a step that asks the user to compute the fingerprint for the an certificate issued to CloudFront distribution to allow AWS IAM to verify trust certificates issued by that CA without having to update the trust trusts when the signing certificate is rotated.

However, the openssl command example in the doc appears to compute the fingerprint of the leaf/server certificate for the CloudFront distribution, since openssl x509 consumes only the first PEM certificate from the output openssl s_client is invoked.

The documentation issue is of minimal impact as the linked documentation to obtaining the fingerprint states that if the certificate is issued by one of the CA that AWS owns/trusts, fingerprint verification is skipped, i.e., for CloudFront distributions using the default certificates or a certificate issued by AWS ACM the incorrect fingerprint does not impact validation.

For verification purposes, the example should be updated to reflect AWS documentation on that the correct thumbprint to obtain is for the intermediate CA certificate that issued the leaf certificate used to secure the CloudFront distribution.

For the creation of the OIDC IAM Provider, could instead recommend is relying on AWS IAM to obtain the fingerprint as the same linked doc explains AWS IAM will attempt to automatically obtain the intermediate CA fingerprint for the given server/leaf certificate.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with docs/sts-migrate-to-private-bucket.md, especially the openssl command example at lines 303-315, and compare it with the linked AWS IAM thumbprint documentation. Verify which certificate fingerprint the example obtains and review AWS IAM's automatic fingerprint behavior. Done means the documented OIDC provider setup reflects the correct intermediate CA fingerprint guidance.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws
Domain
cloud, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
82/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.