Customize Approval Page¶

To use a customized approval page, set the INRUPT_OPENID_APPROVAL_TEMPLATE_LOCATION property of the ESS’ Solid OpenID Connect service. That is:

Create an overlay structure as described in Customize ESS, and
In your overlay directory, add your custom HTML approval page and the overlay yaml file(s).

Procedure¶

In your source repository for your custom overlays,

Create a new directory for your overlay as described in Customize ESS. For example:
```
mkdir overlay-approval-page
cd overlay-approval-page
```
Place your new approval page file, for example approval.html in the overlay directory.

In the directory, create a new custom-approval-env.yaml with the following content:

#custom-approval-env.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: openid-mongodb
spec:
  template:
    spec:
      containers:
        - name: openid-mongodb
          env:
            - name: INRUPT_OPENID_APPROVAL_TEMPLATE_LOCATION
              value: approval.html

The name fields are required to match the correct container to modify.
The INRUPT_OPENID_APPROVAL_TEMPLATE_LOCATION specifies the location to the approval page.

In the directory, create a new kustomization.yaml with the following content:

#kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

bases:
  - <relative path to your ESS directory>/<env>/release/ess/deployment/kubernetes/bases/openid-mongodb

patchesStrategicMerge:
  - custom-approval-env.yaml

To verify the overlay, you can build the overlay and output to a file, such as kustomized.yaml, for review:
```
kustomize build > kustomized.yaml
```
To preview the changes that will be applied to your cluster, you can use kubectl diff:
```
kubectl diff -f kustomized.yaml
```
When you are ready, you can apply the changes to your cluster:
```
kubectl apply -f kustomized.yaml
```

For more information on Kustomize, see Declarative Management of Kubernetes Objects Using Kustomize.

For additional configuration properties for the ESS’ OpenID Connect service, see Solid OpenID Connect Service.

Customize Landing Page

Use an External Service