Merge pull request #1977 from OskarDamkjaer/document-sso_redirect

document sso_redirect

Author: AlexicaWright

docs/modules/ROOT/pages/operations/browser-sso.adoc

@@ -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.

docs/modules/ROOT/pages/operations/browser-url-parameters.adoc

@@ -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.