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: add procedurals to flow inspector docs #9556

Merged
merged 6 commits into from
May 6, 2024
Merged

Conversation

tanberry
Copy link
Contributor

@tanberry tanberry commented May 3, 2024

This PR adds steps about how to open the Flow Inspector, permissions needed, when to use (and not use) Debug mode. Adds a link to Permissions doc.

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

@tanberry tanberry requested a review from a team as a code owner May 3, 2024 13:07
Copy link

netlify bot commented May 3, 2024

Deploy Preview for authentik-storybook canceled.

Name Link
🔨 Latest commit 1cfcc8b
🔍 Latest deploy log https://app.netlify.com/sites/authentik-storybook/deploys/6639261d0974770008830666

Copy link

netlify bot commented May 3, 2024

Deploy Preview for authentik-docs ready!

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

@tanberry tanberry requested review from BeryJu and a team and removed request for a team May 3, 2024 13:07
Copy link

codecov bot commented May 3, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.50%. Comparing base (d2b8bd3) to head (1cfcc8b).
Report is 40 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #9556      +/-   ##
==========================================
+ Coverage   92.45%   92.50%   +0.04%     
==========================================
  Files         669      669              
  Lines       32712    32899     +187     
==========================================
+ Hits        30245    30433     +188     
+ Misses       2467     2466       -1     
Flag Coverage Δ
e2e 50.57% <ø> (-0.07%) ⬇️
integration 25.92% <ø> (-0.07%) ⬇️
unit 89.79% <ø> (+0.04%) ⬆️

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
Contributor

github-actions bot commented May 3, 2024

authentik PR Installation instructions

Instructions for docker-compose

Add the following block to your .env file:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-ghcr.io/goauthentik/dev-server:gh-1cfcc8bd6e84ccdb9d97358ea6ca7f69adf57b1b
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

For arm64, use these values:

AUTHENTIK_IMAGE=ghcr.io/goauthentik/dev-server
AUTHENTIK_TAG=gh-ghcr.io/goauthentik/dev-server:gh-1cfcc8bd6e84ccdb9d97358ea6ca7f69adf57b1b-arm64
AUTHENTIK_OUTPOSTS__CONTAINER_IMAGE_BASE=ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s

Afterwards, run the upgrade commands from the latest release notes.

Instructions for Kubernetes

Add the following block to your values.yml file:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
image:
    repository: ghcr.io/goauthentik/dev-server
    tag: gh-ghcr.io/goauthentik/dev-server:gh-1cfcc8bd6e84ccdb9d97358ea6ca7f69adf57b1b

For arm64, use these values:

authentik:
    outposts:
        container_image_base: ghcr.io/goauthentik/dev-%(type)s:gh-%(build_hash)s
image:
    repository: ghcr.io/goauthentik/dev-server
    tag: gh-ghcr.io/goauthentik/dev-server:gh-1cfcc8bd6e84ccdb9d97358ea6ca7f69adf57b1b-arm64

Afterwards, run the upgrade commands from the latest release notes.

Copy link
Contributor

@kensternberg-authentik kensternberg-authentik left a comment

Choose a reason for hiding this comment

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

A few nitpicks.


:::info
When running a flow with the inspector enabled, the flow is still executed normally. This means that for example, a [User write](../flow/stages/user_write.md) stage will _actually_ write user data.
Be aware that when running a flow with the inspector enabled, the flow is still executed normally. This means that for example, a [User write](../flow/stages/user_write.md) stage will _actually_ write user data.
Copy link
Contributor

Choose a reason for hiding this comment

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

"akshualllllly" is one of those words that makes me twitch.

"For example, even with the flow inspector enabled, executing a User write will write user data."

When developing authentik with the debug-mode enabled, the inspector is enabled by default and can be accessed by both unauthenticated users and standard users. However the debug-mode should only be used for the development of authentik.
3. On the Flow's detail page, on the left side under **Execute Flow**, click **with inspector**.

4. The selected flow will launch in a new browser window, with the Inspector displayed to the right.
Copy link
Contributor

Choose a reason for hiding this comment

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

Window or Tab?


4. The selected flow will launch in a new browser window, with the Inspector displayed to the right.

Alternatively, to launch the inspector a user with the correct permission can add the query parameter `?inspector` to the URL when a flow is designated in the URL; that is when you have a flow open.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggestion: "Alternatively, a user with the correct permission can launch the inspector by adding the query parameter ?inspector to the URL when the URL opens on a flow."

Tana M Berry added 2 commits May 6, 2024 12:38
@tanberry tanberry merged commit b1b9c8e into main May 6, 2024
72 checks passed
@tanberry tanberry deleted the docs-inspector branch May 6, 2024 19:59
kensternberg-authentik added a commit that referenced this pull request May 8, 2024
* main: (42 commits)
  website/docs: prepare 2024.4.2 release notes (#9555)
  web: bump the esbuild group in /web with 2 updates (#9616)
  translate: Updates for file locale/en/LC_MESSAGES/django.po in ru (#9611)
  translate: Updates for file locale/en/LC_MESSAGES/django.po in zh_CN (#9560)
  translate: Updates for file locale/en/LC_MESSAGES/django.po in zh-Hans (#9563)
  ci: bump golangci/golangci-lint-action from 5 to 6 (#9615)
  web: bump esbuild from 0.20.2 to 0.21.0 in /web (#9617)
  core: bump cryptography from 42.0.6 to 42.0.7 (#9618)
  core: bump sentry-sdk from 2.0.1 to 2.1.1 (#9619)
  core: bump django from 5.0.4 to 5.0.5 (#9620)
  core, web: update translations (#9613)
  website/docs: move Sources from Integrations into Docs (#9515)
  website/docs: add procedurals to flow inspector docs (#9556)
  core: bump jinja2 from 3.1.3 to 3.1.4 (#9610)
  web: clean up the options rendering in PromptForm (#9564)
  translate: Updates for file locale/en/LC_MESSAGES/django.po in ru (#9608)
  website/docs: add instructions for deploying radius manually with docker compose (#9605)
  sources/scim: fix duplicate groups and invalid schema (#9466)
  core: fix condition in task clean_expiring_models (#9603)
  translate: Updates for file web/xliff/en.xlf in fr (#9600)
  ...
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