diff --git a/modules/adding-yaml-examples-to-kube-resources.adoc b/modules/adding-yaml-examples-to-kube-resources.adoc index bd3e68ab2b..7f0863fe6e 100644 --- a/modules/adding-yaml-examples-to-kube-resources.adoc +++ b/modules/adding-yaml-examples-to-kube-resources.adoc @@ -7,7 +7,7 @@ You can dynamically add YAML examples to any Kubernetes resources at any time. -. Prerequisites +.Prerequisites * You must have cluster administrator privileges. diff --git a/modules/customizing-the-login-page.adoc b/modules/customizing-the-login-page.adoc new file mode 100644 index 0000000000..db1ea278de --- /dev/null +++ b/modules/customizing-the-login-page.adoc @@ -0,0 +1,55 @@ +// Module included in the following assemblies: +// +// * web_console/customizing-the-web-console.adoc + +[id="customizing-the-login-page_{context}"] += Customizing the login page + +Create Terms of Service information with custom login pages. Custom login pages +can also be helpful if you use a third-party login provider, such as GitHub or +Google, to show users a branded page that they trust and expect before being +redirected to the authentication provider. You can also render custom error +pages during the authentication process. + +.Prerequisites + +* You must have administrator privileges. + +.Procedure + +. Run the following commands to create templates you can modify: ++ +---- +$ oc adm create-login-template > login.html +$ oc adm create-provider-selection-template > providers.html +$ oc adm create-error-template > errors.html +---- + +. Create the secrets: ++ +---- +$ oc create secret generic login-template --from-file=login.html -n openshift-config +$ oc create secret generic providers-template --from-file=providers.html -n openshift-config +$ oc create secret generic error-template --from-file=errors.html -n openshift-config +---- + +. Run: ++ +---- +$ oc edit oauths cluster +---- + +. Update the specification: ++ +---- +spec: + templates: + error: + name: error-template + login: + name: login-template + providerSelection: + name: providers-template +---- ++ +Run `oc explain oauths.spec.templates` to understand the options. diff --git a/web_console/customizing-the-web-console.adoc b/web_console/customizing-the-web-console.adoc index 64712aa9b1..62b0ea47d6 100644 --- a/web_console/customizing-the-web-console.adoc +++ b/web_console/customizing-the-web-console.adoc @@ -13,6 +13,8 @@ include::modules/adding-a-custom-logo.adoc[leveloffset=+1] include::modules/creating-custom-links.adoc[leveloffset=+1] +include::modules/customizing-the-login-page.adoc[leveloffset=+1] + include::modules/defining-template-for-external-log-link.adoc[leveloffset=+1] include::modules/adding-custom-notification-banners.adoc[leveloffset=+1]