{"config":{"lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Welcome \u00b6 This is the documentation for the NGINX Ingress Controller. It is built around the Kubernetes Ingress resource , using a ConfigMap to store the NGINX configuration. Learn more about using Ingress on k8s.io . Getting Started \u00b6 See Deployment for a whirlwind tour that will get you started.","title":"Welcome"},{"location":"#welcome","text":"This is the documentation for the NGINX Ingress Controller. It is built around the Kubernetes Ingress resource , using a ConfigMap to store the NGINX configuration. Learn more about using Ingress on k8s.io .","title":"Welcome"},{"location":"#getting-started","text":"See Deployment for a whirlwind tour that will get you started.","title":"Getting Started"},{"location":"e2e-tests/","text":"e2etestsuiteforNGINXIngressController\u00b6[DefaultBackend]changedefaultsettings\u00b6shouldapplytheannotationtothedefaultbackend[DefaultBackend]\u00b6shouldreturn404sendingrequestswhenonlyadefaultbackendisrunningenablesaccessloggingfordefaultbackenddisablesaccessloggingfordefaultbackend[DefaultBackend]customservice\u00b6usescustomdefaultbackendthatreturns200asstatuscode[DefaultBackend]SSL\u00b6shouldreturnaselfgeneratedSSLcertificate[TCP]tcp-services\u00b6shouldexposeaTCPserviceshouldexposeanExternalNameTCPserviceauth-*\u00b6shouldreturnstatuscode200whennoauthenticationisconfiguredshouldreturnstatuscode503whenauthenticationisconfiguredwithaninvalidsecretshouldreturnstatuscode401whenauthenticationisconfiguredbutAuthorizationheaderisnotconfiguredshouldreturnstatuscode401whenauthenticationisconfiguredandAuthorizationheaderissentwithinvalidcredentialsshouldreturnstatuscode200whenauthenticationisconfiguredandAuthorizationheaderissentshouldreturnstatuscode200whenauthenticationisconfiguredwithamapandAuthorizationheaderissentshouldreturnstatuscode401whenauthenticationisconfiguredwithinvalidcontentandAuthorizationheaderissentproxy_set_headerMy-Custom-Header42;proxy_set_headerMy-Custom-Header42;proxy_set_header'My-Custom-Header''42';retainscookiesetbyexternalauthenticationservershouldreturnstatuscode200whensignedinshouldredirecttosigninurlwhennotsignedinkeepsprocessingnewingressesevenifoneoftheexistingingressesismisconfiguredshouldreturnstatuscode200whensignedinshouldredirecttosigninurlwhennotsignedinkeepsprocessingnewingressesevenifoneoftheexistingingressesismisconfiguredshouldreturnstatuscode200whensignedinafterauthbackendisdeletedshoulddenyloginfordifferentlocationonsameservershoulddenyloginfordifferentserversshouldredirecttosigninurlwhennotsignedinaffinitymode\u00b6BalancedaffinitymodeshouldbalanceCheckpersistentaffinitymodeproxy-*\u00b6shouldsetproxy_redirecttooffshouldsetproxy_redirecttodefaultshouldsetproxy_redirecttohello.comgoodbye.comshouldsetproxyclient-max-body-sizeto8mshouldnotsetproxyclient-max-body-sizetoincorrectvalueshouldsetvalidproxytimeoutsshouldnotsetinvalidproxytimeoutsshouldturnonproxy-bufferingshouldturnoffproxy-request-bufferingshouldbuildproxynextupstreamshouldsetupproxycookiesshouldchangethedefaultproxyHTTPversionaffinitysession-cookie-name\u00b6shouldsetstickycookieSERVERIDshouldchangecookienameoningressdefinitionchangeshouldsetthepathto/somethingonthegeneratedcookiedoesnotsetthepathto/onthegeneratedcookieifthere'smorethanonerulereferringtothesamebackendshouldsetcookiewithexpiresshouldworkwithuse-regexannotationandsession-cookie-pathshouldwarnuserwhenuse-regexistrueandsession-cookie-pathisnotsetshouldnotsetaffinityacrossallserverlocationswhenusingseparateingressesshouldsetsticky