Document URL: Routes [ https://docs.openshift.com/container-platform/3.11/dev_guide/routes.html ] Section Number and Name: Allowing Route Endpoints to Control Cookie Names [ https://docs.openshift.com/container-platform/3.11/dev_guide/routes.html#dev-guide-routes-allowing-endpoints-to-control-cookies ] Describe the issue: There are wrong guidance as follows. [x] $ oc annotate route <route_name> router.openshift.io/<cookie_name>="-<cookie_annotation>" [o] $ oc annotate route <route_name> router.openshift.io/cookie_name=<custom_cookie_name> [x] For example, to annotate the cookie name of my_cookie to the my_route with the annotation of my_cookie_anno: [o] For example, to specify my_cookie as new cookie name: [x] $ oc annotate route my_route router.openshift.io/my_cookie="-my_cookie_anno" [o] $ oc annotate route my_route router.openshift.io/cookie_name=my_cookie Suggestions for improvement: correct the annotation name. Additional information:
Additionally if both "insert" and "indirect" options are configured, the cookie will be removed from transmitted request, so "This allows the application receiving route traffic to know the cookie name. " is not true. The HAProxy session cookie does not been transmitted to the back end Application.