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

Updates secrets settings #1535

Merged
merged 16 commits into from
Jul 30, 2024
Merged

Updates secrets settings #1535

merged 16 commits into from
Jul 30, 2024

Conversation

ZPain8464
Copy link
Contributor

This PR consolidates the Shared Secret/File and Signing Key/File settings into two reference pages:

  • Shared Secret Settings
  • Signing Key Settings

Resolves https://github.com/pomerium/internal/issues/1856

@ZPain8464 ZPain8464 requested a review from kenjenkins July 25, 2024 15:11
@ZPain8464 ZPain8464 requested a review from a team as a code owner July 25, 2024 15:11
@ZPain8464 ZPain8464 requested review from cmo-pomerium and removed request for a team July 25, 2024 15:11
Copy link

netlify bot commented Jul 25, 2024

Deploy Preview for pomerium-docs ready!

Name Link
🔨 Latest commit f8e49dc
🔍 Latest deploy log https://app.netlify.com/sites/pomerium-docs/deploys/66a95d756e36380008803555
😎 Deploy Preview https://deploy-preview-1535--pomerium-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

@kenjenkins kenjenkins left a comment

Choose a reason for hiding this comment

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

I think we can simplify this even further.


:::tip **Note**
\* Standalone Pomerium Core configurations do not require a `shared_secret` or `shared_secret_file`. If you don't set a shared secret, Pomerium will generate one for you.
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't know if this is completely accurate. I believe you would also need to set the same shared secret on each service if running in split service mode.

(Feel free to leave this for a separate follow-up item.)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

OK. I created an issue so we can track work on this: #1538

@ZPain8464 ZPain8464 requested a review from kenjenkins July 25, 2024 21:44
Copy link
Contributor

@kenjenkins kenjenkins left a comment

Choose a reason for hiding this comment

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

Thanks! Just a few more comments.

@ZPain8464 ZPain8464 requested a review from kenjenkins July 26, 2024 15:08
Revert the addition of some #shared-secret anchor tags in links, the
change to the sidebar label for the Signing Key page, and remove two
unnecessary redirects.
@@ -94,4 +94,4 @@ Configuration options for each backend are detailed in the [**databroker configu

## Troubleshooting

Most issues with the Databroker service are caused by a [`shared_secret`](/docs/reference/shared-secret) mismatch between services. See [Troubleshooting - Shared Secret Mismatch](/docs/reference/shared-secret) for details.
Most issues with the Databroker service are caused by a [`shared_secret`](/docs/reference/shared-secret#shared-secret) mismatch between services. See [Troubleshooting - Shared Secret Mismatch](/docs/reference/shared-secret#shared-secret) for details.
Copy link
Contributor

Choose a reason for hiding this comment

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

We should revert this change now as well, right?

(I'll go ahead and push a commit to do that.)

@@ -148,7 +148,7 @@ Events:

### Shared Secret Mismatch

Pomerium's independent services communicate securely using a [shared secret](/docs/reference/shared-secret). When services or the databroker have mismatched secrets, Pomerium will fail.
Pomerium's independent services communicate securely using a [shared secret](/docs/reference/shared-secret#shared-secret). When Pomerium services share a mismatched secret, or these services share a secret that is not the same secret set in the Databroker service, Pomerium will fail.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure this is an improvement. "Share" feels like the wrong verb to use if we're talking about different secrets set on different services.

@ZPain8464 ZPain8464 merged commit 2f9b581 into main Jul 30, 2024
8 checks passed
@ZPain8464 ZPain8464 deleted the zpain/update-secrets-settings branch July 30, 2024 21:46
backport-actions-token bot pushed a commit that referenced this pull request Jul 30, 2024
* adds redirects and merges settings

* moves shared secret, redirects

* fixes breaking links

* runs prettier

* Update content/docs/reference/shared-secret.mdx

Co-authored-by: Kenneth Jenkins <[email protected]>

* updates signign key settings

* updates shared secret

* fixes breaking links

* runs prettier

* incorporates feedback

* runs prettier

* revert some unnecessary changes

Revert the addition of some #shared-secret anchor tags in links, the
change to the sidebar label for the Signing Key page, and remove two
unnecessary redirects.

* Update content/docs/capabilities/getting-users-identity.md

Co-authored-by: Kenneth Jenkins <[email protected]>

* updates 'share' to 'contain'

* updates contain to exchange

* updates wording

---------

Co-authored-by: Kenneth Jenkins <[email protected]>
ZPain8464 added a commit that referenced this pull request Jul 30, 2024
Updates secrets settings (#1535)

* adds redirects and merges settings

* moves shared secret, redirects

* fixes breaking links

* runs prettier

* Update content/docs/reference/shared-secret.mdx



* updates signign key settings

* updates shared secret

* fixes breaking links

* runs prettier

* incorporates feedback

* runs prettier

* revert some unnecessary changes

Revert the addition of some #shared-secret anchor tags in links, the
change to the sidebar label for the Signing Key page, and remove two
unnecessary redirects.

* Update content/docs/capabilities/getting-users-identity.md



* updates 'share' to 'contain'

* updates contain to exchange

* updates wording

---------

Co-authored-by: zachary painter <[email protected]>
Co-authored-by: Kenneth Jenkins <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants