Skip to content

Commit

Permalink
Merge pull request #1977 from OskarDamkjaer/document-sso_redirect
Browse files Browse the repository at this point in the history
document sso_redirect
  • Loading branch information
AlexicaWright authored Sep 20, 2024
2 parents 2af7843 + bf4277e commit b0d989c
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/modules/ROOT/pages/operations/browser-sso.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -150,3 +150,5 @@ Example for Browser: +
// |`auth_flow_step` | `auth_flow_step=<arg>` | `auth_flow_step=redirect_uri` | If the user arrives back to the client application with the URL param `auth_flow_step=redirect_uri`, this indicates that it is time to proceed in the auth process.
// |`idp_id` | `idp_id=<idp_id>` | `idp_id=keycloak-oidc` | The user arrives with a URL param named idp_id, mapped to the information in the discovery data to figure out how to proceed.
// |===

For convenience, the `sso_redirect=<idp_id>` URL parameter can be used to automatically trigger the SSO flow without needing to click the "Login with SSO" button in the Browser UI.
13 changes: 13 additions & 0 deletions docs/modules/ROOT/pages/operations/browser-url-parameters.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,19 @@ http://localhost:7474/browser?preselectAuthMethod=[NATIVE]|[SSO]|[NO_AUTH]
** `[SSO]` lets you sign in using SSO.
** `[NO_AUTH]` means that no authorization is required.

Additionally, it is also possible to automatically redirect to an SSO provider, as if a user clicked the corresponding SSO button in the UI with the `sso_redirect` url parameter.

The syntax is:

[source, browser URL, role=noheader]
----
http://localhost:7474/browser?sso_redirect=<idp_id>
----

The `idp_id` in the example is the `id` of the SSO provider.
To ensure Browser finds the correct SSO providers, it's recommended to also pass the `connectURL`.


== Pre-populate the editor

Pre-populate the editor with a command when Neo4j Browser starts.
Expand Down

0 comments on commit b0d989c

Please sign in to comment.