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

website/docs: Update ArgoCD integration docs. #9684

Merged
merged 2 commits into from
May 30, 2024
Merged

Conversation

Gunsmithy
Copy link
Contributor

@Gunsmithy Gunsmithy commented May 10, 2024

Details

Updated the ArgoCD integration documentation, primarly to add an example Terraform implementation similar to the one found in the Grafana integration docs. (Lost some time to the lack of this since I didn't know the UI defaults to having the email, openid and profile scopes when creating a new provider.)

Added an extra pointer for how to modify the ArgoCD secret when deployed with Helm, and how to add Readonly users to Argo.

Also made the opinionated change of replacing most HTTP schemes with HTTPS where they should realistically be used. :)


Checklist

  • Local tests pass (ak test authentik/)
  • The code has been formatted (make lint-fix)

If an API change has been made

  • The API schema has been updated (make gen-build)

If changes to the frontend have been made

  • The code has been formatted (make web)

If applicable

  • The documentation has been updated
  • The documentation has been formatted (make website)

@Gunsmithy Gunsmithy requested a review from a team as a code owner May 10, 2024 18:05
Copy link

netlify bot commented May 10, 2024

Deploy Preview for authentik-docs ready!

Name Link
🔨 Latest commit 1b15644
🔍 Latest deploy log https://app.netlify.com/sites/authentik-docs/deploys/664621b30e89090008267795
😎 Deploy Preview https://deploy-preview-9684--authentik-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

netlify bot commented May 10, 2024

Deploy Preview for authentik-storybook canceled.

Name Link
🔨 Latest commit 1b15644
🔍 Latest deploy log https://app.netlify.com/sites/authentik-storybook/deploys/664621b3e199fb00097d5bdb

Copy link

codecov bot commented May 10, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.36%. Comparing base (09cacbd) to head (1b15644).
Report is 21 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #9684      +/-   ##
==========================================
- Coverage   92.39%   92.36%   -0.03%     
==========================================
  Files         704      704              
  Lines       34401    34403       +2     
==========================================
- Hits        31785    31778       -7     
- Misses       2616     2625       +9     
Flag Coverage Δ
e2e 49.65% <ø> (-0.01%) ⬇️
integration 25.36% <ø> (-0.02%) ⬇️
unit 89.82% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Copy link
Member

@rissson rissson left a comment

Choose a reason for hiding this comment

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

Thanks for the contribution!

@rissson rissson requested a review from tanberry May 13, 2024 11:53
Copy link
Contributor

@tanberry tanberry left a comment

Choose a reason for hiding this comment

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

Thanks so much for this contribution @Gunsmithy ! I made a rather nit-picky request, sorry and please. :-)

@@ -69,16 +132,25 @@ In the `argocd-secret` Secret, add the following value to the `data` field:
dex.authentik.clientSecret: <base 64 encoded value of the Client Secret from the Provider above>
```

If using helm, the above can be added to `configs.secret.extra` like so, securely substituting the string however you see fit:
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If using helm, the above can be added to `configs.secret.extra` like so, securely substituting the string however you see fit:
If using Helm, the above can be added to `configs.secret.extra` as shown below, securely substituting the string however you see fit:

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd like to further edit this, to identify/qualify and be very specific on what "the above <?>" is... Can we say

"If using Helm, the above string/line/definition/? can be added to a configs.secret.extra section in the <??> file, as shown below, securely substituting the string however you see fit:"

These are nits (well not the capitalization, that's important), but for new users, it's always nice to be a bit pedantic, and say where (in what file) we are talking about.

Copy link
Contributor Author

@Gunsmithy Gunsmithy May 16, 2024

Choose a reason for hiding this comment

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

Amended, see what you think!

}

data "authentik_scope_mapping" "scope-email" {
name = "authentik default OAuth Mapping: OpenID 'email'"
Copy link
Member

Choose a reason for hiding this comment

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

you could do something like this here:

data "authentik_scope_mapping" "test" {
  managed_list = [
    "goauthentik.io/providers/oauth2/scope-email",
    "goauthentik.io/providers/oauth2/scope-openid",
    "goauthentik.io/providers/oauth2/scope-profile",
  ]
}

and then use data.authentik_scope_mapping.test.ids down below

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Clean! I didn't realize there was a data source for these. I can make that change. I can make it on the Grafana one as well in this same PR if desired as I lifted this method from there.

Choose a reason for hiding this comment

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

"goauthentik.io/providers/oauth2/scope-profile",

Copy link
Member

@BeryJu BeryJu left a comment

Choose a reason for hiding this comment

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

LGTM, added one small possible improvement, but definitely not required

@rissson rissson merged commit 040dcaa into goauthentik:main May 30, 2024
62 of 68 checks passed
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.

None yet

5 participants